accounts

list edi documents

Every EDI document this organisation has exchanged with its accounts: purchase orders (850) in, acknowledgements (855), shipping notices (856) and invoices (810) out, and the inventory (846) and sell-out (852) reports that arrive on the same connection. Each row says which account it belongs to, which order it became or answered, what state it reached, and the sentence behind that state where it has one, so a file that was refused or an acknowledgement a network would not take is readable here rather than in the network's own console. network says which lane a document came through, and it is also the filter: this log holds every lane an order can arrive on, so ask for network=sps_commerce for the EDI lane alone. Read only: documents are made by the acts that make them, never posted here.

Scope: accounts:read.

get/api/v1/wholesale/edi/documents

Request

  • Base URL: https://api.app.tightly.io
  • URL: https://api.app.tightly.io/api/v1/wholesale/edi/documents
  • Auth: HTTP bearer

Query parameters

trading_partner_idstring

One account's documents only.

document_type'850' | '855' | '856' | '810' | '846' | '852'

One kind of document only, by its X12 number.

direction'inbound' | 'outbound'

Documents that arrived (inbound) or that Tightly sent (outbound).

state'received' | 'parsed' | 'applied' | 'refused' | 'queued' | 'sent' | 'failed'

Documents in this state only.

network'sps_commerce' | 'email' | 'upload' | 'link' | 'portal'

The lane the document came through. sps_commerce is the EDI lane; the other four are the paper lanes that share this table. Omit it for every lane.

offsetinteger

Rows to skip before the page starts.

limitinteger

Rows on the page.

Headers

Tightly-Versionstring
Example:2026-11

The date train to answer on. One train exists today, 2026-11, the one this reference describes and the one every key is minted on, so the call answers on it with or without this header. Send it anyway, so a client built now names its train from the start.

Response

The documents, newest first.

Changes

No recorded changes to this operation across all 1 revision of this API.