POST/api/public/edi/translate

Translate raw EDI into JSON

Auto-detects the EDI standard (X12 or EDIFACT), parses the envelope, walks every transaction set, and returns a clean JSON representation.

Request
POST /api/public/edi/translate HTTP/1.1
Authorization: Bearer edi_live_••••
Content-Type: text/plain

ISA*00*          *00*          *ZZ*SENDERID       *ZZ*RECEIVERID     *240611*1453*U*00401*000000001*0*P*:~
GS*PO*SENDERID*RECEIVERID*20240611*1453*1*X*004010~
ST*850*0001~
BEG*00*SA*PO998877**20240611~
PO1*1*120*EA*9.25**BP*ABC123~
SE*4*0001~GE*1*1~IEA*1*000000001~
Response
{
  "ok": true,
  "standard": "X12",
  "parsed": {
    "interchange": { "sender": { "qualifier": "ZZ", "id": "SENDERID" }, ... },
    "transactions": [
      { "type": "850",
        "summary": { "document": "Purchase Order", "poNumber": "PO998877", "lineCount": 1 }
      }
    ]
  }
}
POST/api/public/edi/detect

Detect the standard of a payload

A lightweight check that returns the standard (X12, EDIFACT or UNKNOWN) without fully parsing.

Request
POST /api/public/edi/detect
Authorization: Bearer edi_live_••••

UNB+UNOC:3+SENDER:14+RECEIVER:14+240611:1453+1++ORDERS'...
Response
{ "ok": true, "standard": "EDIFACT" }
GET/api/public/edi/samples

Fetch sample EDI payloads

Returns a library of sample X12 850/810/856/855 and EDIFACT ORDERS/INVOIC payloads for testing your integration.

Request
GET /api/public/edi/samples
Authorization: Bearer edi_live_••••
Response
{ "ok": true,
  "samples": {
    "X12": { "850": { "label": "Purchase Order (850)", "value": "ISA*..." }, ... },
    "EDIFACT": { "ORDERS": { ... } }
  }
}

Authentication

All API requests require a Bearer API key in the Authorization header. Issue keys from the API Keys page in your dashboard. Keys are hashed at rest — you'll see the secret only once at creation.