Outbox

Pending VES events

GET /v1/outbox

cURL

curl --request GET \
  --url 'https://edi.stateset.com/v1/outbox' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY"

200

[
  {
    "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "entity_type": "string",
    "event_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "event_type": "string",
    "occurred_at": "2026-08-31T14:22:05Z",
    "payload": {},
    "signature": "sha256:9f86d081884c7d659a2feaa0c55ad015"
  }
]

Response

EdiEvent[] — each element:

entity_id · string · required

entity_type · string · required

event_id · string · required

event_type · string · required

occurred_at · string (date-time) · required

payload · object · required

signature · string

Ed25519 signature (hex) over the canonical event message. Absent when signing is disabled. See [crate::signing].

Status codes

Code	Meaning
200	Pending VES events
403	Admin credential required

cURL

curl --request GET \
  --url 'https://edi.stateset.com/v1/outbox' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY"

200

[
  {
    "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "entity_type": "string",
    "event_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "event_type": "string",
    "occurred_at": "2026-08-31T14:22:05Z",
    "payload": {},
    "signature": "sha256:9f86d081884c7d659a2feaa0c55ad015"
  }
]