Outbox

Pending VES events

GET /v1/outbox

cURL

curl --silent --show-error --fail-with-body --request GET \
  --url 'https://api.edi.stateset.com/v1/outbox' \
  --header "Authorization: Bearer $EDI_API_TOKEN"

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,null

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

Using this contract

Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.

cURL

curl --silent --show-error --fail-with-body --request GET \
  --url 'https://api.edi.stateset.com/v1/outbox' \
  --header "Authorization: Bearer $EDI_API_TOKEN"

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"
  }
]