Slots

Beta: Get booked slots for a site

get

Authorizations

ApiKeyAuth

AuthenticationstringRequired

Authentication is token based. You can issue a token for your API request from the 'API' section of the settings menu. The token MUST be sent in a Authorization header with each request.

Example of authenticated request

$ curl -X GET -H "Authorization: Token <your token>" "https://api.dashdoc.eu/api/v4/"

Path parameters

site-slugstringRequired

The slug identifier of the site

Query parameters

updated_sincestring · date-timeOptional

Filter slots updated since this datetime

pageinteger · min: 1Optional

Page number for pagination

Default: 1

include_draftbooleanOptional

Include draft slots in the response

Default: false

custom_fieldsstringOptional

Filter slots by custom field label/value pairs. Pass a JSON-encoded object where keys are custom field labels and values are the expected values. The value comparison is case-insensitive. Multiple custom field filters are combined with AND logic.

Example: ?custom_fields={"Order Number": "ORD123", "Truck Color": "blue"}

Example: {"Order Number": "ORD123", "Truck Color": "blue"}

Responses

200

Get successful

application/json

countintegerRequired

Total number of slots

nextstring · nullableOptional

URL for the next page of results

previousstring · nullableOptional

URL for the previous page of results

404

Site not found

application/json

get

/flow/sites/{site-slug}/slots/

HTTPcURLJavaScriptPython

GET /api/v4/flow/sites/{site-slug}/slots/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Accept: */*

{
  "count": 1,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "uid": "text",
      "zone": {
        "uid": "text",
        "name": "text"
      },
      "company": {
        "pk": 456,
        "remote_id": "CARRIER_123",
        "name": "Transporteur A"
      },
      "start_time": "2026-05-17T12:22:20.159Z",
      "end_time": "2026-05-17T12:22:20.159Z",
      "state": "draft",
      "note": "text",
      "fields": {
        "references": [
          "value1",
          "value2"
        ],
        "custom_field_1": "value",
        "custom_field_2": "value"
      }
    }
  ]
}