/api/v1/customer/order-list

Returns a paginated list of orders for the customer identified by identityId, including order lines, status, prices, and linked calendar events.

Endpoint Info

Base URLapi.bizkithub.com

AuthBearer Token

Methods1

Authentication Required

This endpoint requires a valid API key passed as a query parameter or Bearer token.

Get your API key

Parameters

3 query parameters

apiKeystringrequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

identityIdstringrequired

Logged user identity (from your frontend cookies). Learn more

pagestring

Page number (string, converted to number internally).

Default: 1

Example Request

JavaScript fetch

const response = await fetch("https://api.bizkithub.com/api/v1/customer/order-list?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&identityId=Z9CPkS2o3UV163VQn5OUv0T8BQi8Fvdg&page=1", {
  method: "GET",
  headers: {
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(data);

get

Example Response

200Success

{
  "items": [
    {
      "id": "sSO98YxzR4KJiOu66Jn6K3wRwa4FPI7S",
      "orderNumber": "25000055",
      "status": {
        "label": "Storno",
        "code": "storno",
        "backgroundColor": "#901020",
        "textColor": "#fff"
      },
      "price": "0&nbsp;Kč",
      "notice": "Please reserve a trainer to me.",
      "insertedDate": "2025-01-10T16:19:40.150Z",
      "updatedDate": "2025-01-10T16:19:40.150Z",
      "expirationDate": "2025-01-10T16:19:40.150Z",
      "lines": [
        {
          "id": "2d33677772eddbd4e869c6ed6bf6d9f3",
          "label": "Jan Barášek GymRoom Vinohrady rezervace",
          "count": 1,
          "storno": false,
          "price": "110&nbsp;Kč",
          "unit": "ks",
          "vat": 21,
          "creditAmount": 100,
          "insertedDate": "2025-01-10T16:19:40.150Z",
          "event": {
            "id": "7lRIAiC69gZMfwsDbG3CJvQdqnY15XdS",
            "calendarId": "2WRp6X5rSqQa321EjHB2mxZz74u74H84",
            "startTime": "2025-01-10T16:19:40.150Z",
            "endTime": "2025-01-10T16:19:40.150Z",
            "title": "Jan Barášek GymRoom Vinohrady rezervace",
            "isAllDay": false,
            "isBlocking": true,
            "isStorno": true
          }
        }
      ]
    }
  ]
}

cURL

Command line example

curl -X GET "https://api.bizkithub.com/api/v1/customer/order-list?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&identityId=Z9CPkS2o3UV163VQn5OUv0T8BQi8Fvdg&page=1" \
  -H "Content-Type: application/json"

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key

Back to API Documentation API Reference