Orders

Get all orders

get

Authorizations

ApiKey

AuthorizationstringRequired

Prefix the value with "ApiKey" to indicate the custom authorization type

Query parameters

pageinteger · int32Optional

The page number to request (1 based)

Default: 1Example: 1

sizeinteger · int32Optional

The number of results to return in a page

Default: 100Example: 10

personIdstring · uuidOptional

The ID of the person to return orders for

Example: d7d0d906-425f-402f-bde1-39031c67c40b

startDatestring · date-timeOptional

UTC Date-time to filter orders created after (ISO-8601 without timezone)

Example: 2007-12-03T10:15:30

endDatestring · date-timeOptional

UTC Date-time to filter orders created before (ISO-8601 without timezone)

Example: 2007-12-03T10:15:30

Responses

200

OK

application/json

idstring · uuidRequired

Order's ID

Example: 123e4567-e89b-12d3-a456-426614174000

personIdstring · uuidRequired

The ID of the Person

Example: d7d0d906-425f-402f-bde1-39031c67c40b

statusstring · enumRequired

Order's status

Example: COMPLETEDPossible values:

400

Bad request

application/json

403

Forbidden

*/*

404

Resource not found

application/json

get

/api/orders

HTTPcURLJavaScriptPython

GET /api/orders HTTP/1.1
Host: apipub.firstbasehq.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "personId": "d7d0d906-425f-402f-bde1-39031c67c40b",
    "status": "COMPLETED",
    "orderItems": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "skuId": "123e4567-e89b-12d3-a456-426614174000",
        "title": "iPad Air - Silver, 64GB, WiFi",
        "status": "PROCESSING",
        "shipment": {
          "trackingUrl": "text",
          "trackingCode": "1Z00000000",
          "carrier": "UPS",
          "status": "DELIVERED",
          "trackingHistory": [
            {
              "status": "IN_TRANSIT",
              "timestamp": "2026-03-02T16:38:16.461Z"
            }
          ]
        }
      }
    ]
  }
]

Get an order by ID

get

Authorizations

ApiKey

AuthorizationstringRequired

Prefix the value with "ApiKey" to indicate the custom authorization type

Path parameters

orderIdstring · uuidRequired

Responses

200

OK

application/json

idstring · uuidRequired

Order's ID

Example: 123e4567-e89b-12d3-a456-426614174000

personIdstring · uuidRequired

The ID of the Person

Example: d7d0d906-425f-402f-bde1-39031c67c40b

statusstring · enumRequired

Order's status

Example: COMPLETEDPossible values:

400

Bad request

application/json

403

Forbidden

*/*

404

Resource not found

application/json

get

/api/orders/{orderId}

HTTPcURLJavaScriptPython

GET /api/orders/{orderId} HTTP/1.1
Host: apipub.firstbasehq.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "personId": "d7d0d906-425f-402f-bde1-39031c67c40b",
    "status": "COMPLETED",
    "orderItems": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "skuId": "123e4567-e89b-12d3-a456-426614174000",
        "title": "iPad Air - Silver, 64GB, WiFi",
        "status": "PROCESSING",
        "shipment": {
          "trackingUrl": "text",
          "trackingCode": "1Z00000000",
          "carrier": "UPS",
          "status": "DELIVERED",
          "trackingHistory": [
            {
              "status": "IN_TRANSIT",
              "timestamp": "2026-03-02T16:38:16.461Z"
            }
          ]
        }
      }
    ]
  }
]

Create an order for a specified person

post

Authorizations

ApiKey

AuthorizationstringRequired

Prefix the value with "ApiKey" to indicate the custom authorization type

Body

application/json

Request body

personIdstring · uuidRequired

Responses

200

OK

application/json

orderIdstring · uuidRequired

itemIdsstring · uuid[]Required

400

Bad request

application/json

403

Forbidden

*/*

404

Resource not found

application/json

post

/api/orders

HTTPcURLJavaScriptPython

POST /api/orders HTTP/1.1
Host: apipub.firstbasehq.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 485

{
  "shippingAddress": {
    "addressLine1": "text",
    "addressLine2": "text",
    "administrativeArea": "text",
    "countryCode": "text",
    "dependentLocality": "text",
    "locality": "text",
    "postalCode": "text",
    "sortingCode": "text",
    "phoneNumber": "text",
    "integrations": {
      "provider": "MERGE",
      "mergeTenant": "US",
      "integrationAddressId": "text"
    }
  },
  "personId": "123e4567-e89b-12d3-a456-426614174000",
  "skus": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "expeditedShippingOption": "EXPEDITED_STANDARD",
      "preferredCondition": "NEW"
    }
  ]
}

[
  {
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "itemIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
]