> ## Documentation Index > Fetch the complete documentation index at: https://docs.cula.tech/llms.txt > Use this file to discover all available pages before exploring further. # List deliveries ## OpenAPI ````yaml /openapi.json get /deliveries openapi: 3.1.0 info: title: Cula Tracking API version: 0.3.10 servers: - url: https://api.demo.cula.earth/tracking/v1 security: [] tags: - name: Organisations description: '' - name: Sites description: '' - name: Machines description: '' - name: Machine Variables description: '' - name: Machine Data Imports description: '' - name: Delivery Configs description: '' - name: Deliveries description: '' - name: Material Sourcing Configs description: '' - name: Material Sourcings description: '' - name: Material Conversion Configs description: '' - name: Material Conversions description: '' - name: Material Utilization Configs description: '' - name: Material Utilizations description: '' - name: Material Batches description: '' - name: Material Pools description: '' - name: Material Containers description: '' - name: Sinks description: '' - name: Documents description: '' - name: Webhooks description: '' paths: /deliveries: get: tags: - Deliveries summary: List deliveries parameters: - name: Cula-Organisation-Id in: header description: >- ID of the organisation the request operates on behalf of (e.g. `org_...`). Must be an organisation the API client has access to. required: true schema: type: string example: org_01k83mfmhgchya944v86ryvhpq - name: limit required: false in: query description: Maximum number of items to return. schema: minimum: 1 maximum: 50 default: 10 type: integer - name: sender_site_id required: false in: query description: Only return deliveries where any leg ships from the given site. schema: type: string example: ste_01k8g7aec6dt5zrtamc72ww446 - name: receiver_site_id required: false in: query description: Only return deliveries where any leg ships to the given site. schema: type: string example: ste_01k8g7aec6dt5zrtamc72ww446 - name: config_id required: false in: query description: Only return deliveries created from the given delivery config. schema: example: dlvc_01kkygy9cxxqhhr93aw74aycbr type: string - name: status required: false in: query description: >- Only return deliveries with the given status. Defaults to `finished`: drafts only appear when requested explicitly. schema: $ref: '#/components/schemas/DeliveryStatus' - name: starting_after required: false in: query description: >- Cursor representing the item ID after which to start listing results. schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/ListDeliveriesResponse' '400': description: Invalid request payload or parameters. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: bad_request message: The field limit must not be greater than 100. '401': description: Missing or invalid access token. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: unauthorized message: Invalid or expired token '500': description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: internal_server_error message: Internal server error. security: - AccessToken: [] components: schemas: DeliveryStatus: type: string enum: - draft - finished ListDeliveriesResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/DeliverySummary' pagination: $ref: '#/components/schemas/Pagination' required: - data - pagination Error: type: object properties: code: type: string example: bad_request message: type: string example: The field limit must not be greater than 100. required: - code - message DeliverySummary: type: object properties: id: type: string example: dlv_01k204p7hghzdtwjb3n48s5fs5 description: The ID of the delivery. config_id: type: string example: dlvc_01kkygy9cxxqhhr93aw74aycbr description: The ID of the delivery config the delivery was created from. config_version_id: type: string example: dlvcv_01kkw6g3ayad6f092rbkbjcaxq description: >- The ID of the exact delivery config version the delivery was created from. external_id: type: string nullable: true example: MY-CUSTOM-ID description: Optional external ID of the delivery. display_id: type: string example: D-148 description: >- Human-readable, server-generated identifier scoped to the issuing site. status: description: >- Lifecycle status. `draft` deliveries are still being prepared and may be missing data point values, payload or leg sites; `finished` deliveries are complete. example: finished allOf: - $ref: '#/components/schemas/DeliveryStatus' site: description: The site that issued the delivery (owns its config). allOf: - $ref: '#/components/schemas/SiteRef' legs: description: The transport legs of the delivery, in order. type: array items: $ref: '#/components/schemas/DeliveryLeg' occurred_at: type: string format: date-time example: '2026-01-15T08:00:00Z' description: When the delivery took place. created_at: type: string format: date-time example: '2026-01-15T08:00:00Z' description: When the delivery was recorded in Cula. required: - id - config_id - config_version_id - external_id - display_id - status - site - legs - occurred_at - created_at Pagination: type: object properties: starting_after: type: string nullable: true description: >- Cursor that was used to retrieve this page. Null implies the first page. example: null limit: type: integer minimum: 1 maximum: 50 description: Maximum number of items returned in this response. example: 10 has_more: type: boolean description: >- Indicates whether more items can be fetched when using the returned next_cursor. example: false next_cursor: type: string nullable: true description: >- Cursor to use as starting_after to fetch the next set of results. Null means no more results. example: null required: - starting_after - limit - has_more - next_cursor SiteRef: type: object properties: id: type: string example: ste_01k8g7aec6dt5zrtamc72ww446 description: The ID of the site. external_id: type: string nullable: true example: SITE-EXT-0001 description: Optional external ID of the site. description: Reference to a site. required: - id - external_id DeliveryLeg: type: object properties: id: type: string example: dll_01kjjkhkr6azkf10qx8te8ztv6 description: The ID of the delivery leg. sender_site: nullable: true description: >- The site this leg ships from. `null` while a draft is missing its sender. type: object allOf: - $ref: '#/components/schemas/SiteRef' receiver_site: nullable: true description: >- The site this leg ships to. `null` while a draft is missing its receiver. type: object allOf: - $ref: '#/components/schemas/SiteRef' description: One transport leg of a delivery. required: - id - sender_site - receiver_site securitySchemes: AccessToken: type: oauth2 flows: clientCredentials: tokenUrl: https://auth.demo.cula.earth/oauth2/token scopes: {} description: >- OAuth 2.0 client credentials. Exchange your client_id and client_secret for an access token scoped to the organisation that provides data access. ````