Cargo trailer references

2 operations at https://api.zaitrack.app. Request and response bodies are JSON with camelCase keys; ids are UUIDs; times are RFC 3339 in UTC.

Every operation needs an API key, a personal access token or an OAuth access token unless it says otherwise. An Idempotency-Key is replayed for 24 hours; see Idempotency. Errors are application/problem+json; see Errors.

Paginated trailer identities and seal addressing for Cargo

GET /v1/cargo-trailer-references

• Scope: trailers:read or trailers:*
• Rate class: read (100 per second and 360,000 per hour)
• Idempotency-Key: not used
• Audited: no
• Step-up MFA: no

Query parameter	Type	Notes
class	string
cursor	string
identifier	string
kind	string
limit	string
status	string

Request

No body.

Response

200: fields the handler writes, taken from its source.

Field	Type	Notes
items	array of object
items[].id	string (UUID)
items[].name	string
items[].identifier	string
items[].status	string
items[].trackerDeviceId	string (UUID)	may be null
items[].sealSerial	string	may be null
nextCursor	—

Example

curl "https://api.zaitrack.app/v1/cargo-trailer-references" \
  -H "Authorization: Bearer zk_test_…"

Trailer identity and seal addressing without Fleet telemetry

GET /v1/cargo-trailer-references/{id}

• Scope: trailers:read or trailers:*
• Rate class: read (100 per second and 360,000 per hour)
• Idempotency-Key: not used
• Audited: no
• Step-up MFA: no

Path parameters: id.

Request

No body.

Response

200: fields the handler writes, taken from its source.

Field	Type	Notes
id	string (UUID)
name	string
identifier	string
status	string
trackerDeviceId	string (UUID)	may be null
sealSerial	string	may be null

Example

curl "https://api.zaitrack.app/v1/cargo-trailer-references/$ID" \
  -H "Authorization: Bearer zk_test_…"