Orders API

The Orders API lets you create and manage orders on the GoTab platform.

List Orders

GET /v1/orders

Query Parameters

Parameter	Type	Description
status	string	Filter by order status
limit	number	Number of results (default: 20)
offset	number	Pagination offset
since	string	ISO 8601 date for filtering

Response

{
  "data": [
    {
      "id": "ord_abc123",
      "status": "open",
      "total": 4250,
      "currency": "USD",
      "created_at": "2026-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 20,
    "offset": 0
  }
}

Create Order

POST /v1/orders

Request Body

{
  "location_id": "loc_xyz789",
  "items": [
    {
      "product_id": "prod_001",
      "quantity": 2,
      "modifiers": []
    }
  ]
}