Paged: data stays a plain array (newest first) and page carries {total, limit,…

Recent processed documents, newest first

GET /v1/documents

cURL

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

200

{
  "data": [
    {
      "control_number": "string",
      "correlation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "direction": "string",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "processed_at": "2026-08-31T14:22:05Z",
      "reference": "ORD-10042",
      "status": "pending",
      "transaction_set": "string",
      "validation_summary": {
        "errors": 1,
        "findings": 1,
        "validation_error": true,
        "warnings": 1
      }
    }
  ],
  "page": {
    "limit": 20,
    "offset": 1,
    "total": 102
  },
  "success": true
}

Query parameters

limit · integer

Page size (default 200, max 1000)

offset · integer

Documents to skip, newest first (default 0)

Response

PagedDocuments

data · DocumentListEntry[] · required

The requested page, newest first.

Show DocumentListEntry

control_number · string · required

correlation_id · string

Ties this record to the request’s logs (and, for outbound, its delivery). Defaulted for log lines written before correlation tracking existed.

direction · string · required

inbound or outbound.

id · string · required

partner_id · string · required

processed_at · string (date-time) · required

reference · string · required

Human-readable handle: PO number, shipment ID, invoice number.

status · string · required

accepted, rejected, generated, queued, or legacy sent.

transaction_set · string · required

Transaction set ID, e.g. 850.

validation_summary · DocumentValidationSummary,null

Historical validation evidence only; not current guide compliance, delivery, or business completion. Null counts mean the stored findings were malformed.

Show DocumentValidationSummary

errors · integer,null

Minimum: 0.

findings · integer,null

Minimum: 0.

validation_error · boolean · required

warnings · integer,null

Minimum: 0.

page · PageInfo · required

Pagination metadata carried alongside a paged list’s data.

Show PageInfo

limit · integer · required

The applied page size (after clamping). Minimum: 0.

offset · integer · required

The applied offset. Minimum: 0.

total · integer · required

Total records available (before paging). Minimum: 0.

success · boolean · required

Status codes

Code	Meaning
200	Recent processed documents, newest first
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/documents' \
  --header "Authorization: Bearer $EDI_API_TOKEN"

200

{
  "data": [
    {
      "control_number": "string",
      "correlation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "direction": "string",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "processed_at": "2026-08-31T14:22:05Z",
      "reference": "ORD-10042",
      "status": "pending",
      "transaction_set": "string",
      "validation_summary": {
        "errors": 1,
        "findings": 1,
        "validation_error": true,
        "warnings": 1
      }
    }
  ],
  "page": {
    "limit": 20,
    "offset": 1,
    "total": 102
  },
  "success": true
}