Skip to main content
GET
Get a delivery

Authorizations

Authorization
string
header
required

OAuth 2.0 client credentials. Exchange your client_id and client_secret for an access token scoped to the organisation that provides data access.

Headers

Cula-Organisation-Id
string
required

ID of the organisation the request operates on behalf of (e.g. org_...). Must be an organisation the API client has access to.

Example:

"org_01k83mfmhgchya944v86ryvhpq"

Path Parameters

id
string
required
Example:

"dlv_01k204p7hghzdtwjb3n48s5fs5"

Response

id
string
required

The ID of the delivery.

Example:

"dlv_01k204p7hghzdtwjb3n48s5fs5"

config_id
string
required

The ID of the delivery config the delivery was created from.

Example:

"dlvc_01kkygy9cxxqhhr93aw74aycbr"

config_version_id
string
required

The ID of the exact delivery config version the delivery was created from.

Example:

"dlvcv_01kkw6g3ayad6f092rbkbjcaxq"

external_id
string | null
required

Optional external ID of the delivery.

Example:

"MY-CUSTOM-ID"

display_id
string
required

Human-readable, server-generated identifier scoped to the issuing site.

Example:

"D-148"

status
enum<string>
required

Lifecycle status. draft deliveries are still being prepared and may be missing data point values, payload or leg sites; finished deliveries are complete.

Available options:
draft,
finished
Example:

"finished"

site
object
required

The site that issued the delivery (owns its config).

legs
object[]
required

The transport legs of the delivery, in order.

occurred_at
string<date-time>
required

When the delivery took place.

Example:

"2026-01-15T08:00:00Z"

created_at
string<date-time>
required

When the delivery was recorded in Cula.

Example:

"2026-01-15T08:00:00Z"

data_points
(short_text · object | long_text · object | multi_text · object | number · object | percentage · object | amount · object | timestamp · object | duration · object | boolean · object | material · object | material_batch · object | container_type · object | material_pool · object)[]
required

Data points set on the delivery itself.

Data point holding a single line of text.

payload_containers
object[]
required

The material containers carried by the delivery.

payload
object[]
required
deprecated

Use payload_containers instead.