Atlas Open API
  1. Carts
Atlas Open API
  • Introduction
  • Authentication
  • Date and Time
  • Errors
  • Webhooks
    • Incoming
      • Reservations (BETA)
    • Outgoing
      • Menus, Stocks, Orders, Outlets, Users
  • Menus
    • Menu List
      GET
    • Menu Details
      GET
    • Menu Create or Update
      POST
  • Orders
    • Create Order
      POST
    • Order Details
      GET
    • Update Order
      PATCH
    • Order Details (with Identifier)
      GET
  • Stocks
    • Outlet Stocks
      GET
  • Users
    • User Sync
      POST
  • Tables
    • Tables
      GET
  • Carts
    • Create cart
      POST
  1. Carts

Create cart

POST
/admin/v1/carts
Creates a new POS cart for the specified table.

Request

Authorization
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
Header Params

Body Params application/json

Example
{
    "pax": 0,
    "table_id": 0,
    "contact_name": "string",
    "contact_number": "string",
    "contact_email": "string",
    "cart_payment": {
        "amount": 0,
        "capture_id": "string",
        "capture_type": "string"
    },
    "notes": "string"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.atlas.kitchen/admin/v1/admin/v1/carts' \
--header 'X-Merchant-Id;' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pax": 0,
    "table_id": 0,
    "contact_name": "string",
    "contact_number": "string",
    "contact_email": "string",
    "cart_payment": {
        "amount": 0,
        "capture_id": "string",
        "capture_type": "string"
    },
    "notes": "string"
}'

Responses

🟢200Success
application/json
Body

Example
{
  "id": 17,
  "fulfilment_type": "dine_in",
  "timeslot_type": "asap",
  "payment_type": null,
  "contact_name": "Jane Smith",
  "contact_number": "+6598765432",
  "contact_email": "jane@example.com",
  "table_id": 1,
  "notes": "Customer prefers quiet seating",
  "payment_breakdown": {
    "subtotal": 0,
    "surcharge": 0,
    "surcharge_label": null,
    "service_charge": 0,
    "donation_amount": 0,
    "donation_label": null,
    "tip": 0,
    "cash_vouchers_amount": 0,
    "use_points": false,
    "points_amount": 0,
    "points_value": 0,
    "discount": 0,
    "is_post_tax_discount": false,
    "platform_discount": 0,
    "admin_discount": null,
    "delivery_fee": 0,
    "platform_delivery_fee": 0,
    "amount_to_free_delivery": null,
    "amount_to_next_delivery_fee": null,
    "delivery_fee_waiver_cart_subtotal": null,
    "net_sales": 0,
    "amount_paid": 1234,
    "amount_unpaid": -1234,
    "refunds": 0,
    "merchant_total": 0,
    "merchant_tax": 0,
    "merchant_total_including_tax": 0,
    "total": 0,
    "tax": 0,
    "total_including_tax": 0,
    "tax_inclusive_prices": true,
    "tax_rate": 9,
    "rounding": 0,
    "cash_rounding": 0,
    "service_charge_discount": 0
  }
}
🔴500Server Error
🟠401Unauthorized
Modified at 2025-11-18 06:36:12
Previous
Tables
Built with