curl --silent --show-error --fail-with-body --request POST \
--url 'https://edi.stateset.com/v1/as1/inbound' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY" \
--header 'Content-Type: application/json' \
--data @as1-email.json
{
"success": true,
"data": {
"ack_997": "string",
"ack_contrl": "string",
"ack_ta1": "string",
"documents": [
{
"control_number": "string",
"error": "string",
"parsed": {},
"reference": "ORD-10042",
"status": "pending",
"transaction_set": "string"
}
],
"error": "string",
"events_queued": 1,
"interchange_control_number": "string",
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending"
}
}
Receive an EDI email
Process a forwarded EDI email through the inbound pipeline. Save the mail connector’s complete JSON envelope as as1-email.json, including an actual X12…
POST
/
v1
/
as1
/
inbound
curl --silent --show-error --fail-with-body --request POST \
--url 'https://edi.stateset.com/v1/as1/inbound' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY" \
--header 'Content-Type: application/json' \
--data @as1-email.json
{
"success": true,
"data": {
"ack_997": "string",
"ack_contrl": "string",
"ack_ta1": "string",
"documents": [
{
"control_number": "string",
"error": "string",
"parsed": {},
"reference": "ORD-10042",
"status": "pending",
"transaction_set": "string"
}
],
"error": "string",
"events_queued": 1,
"interchange_control_number": "string",
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending"
}
}
Process a forwarded EDI email through the inbound pipeline. Save the mail connector’s complete JSON envelope as as1-email.json, including an actual X12 attachment or body and the correct partner context. Empty or illustrative text is not a valid interchange. Check the processing result and acknowledgment before treating the business document as accepted.
Request body
As1InboundEmail
As1InboundAttachment[]
string
Plain-text body — the fallback EDI source when there is no attachment.
string
Sender address, for logging/audit.
string
Optional explicit partner id; when absent the ISA sender resolves it.
string
Response
object
boolean
required
Fixed value:
true.InboundResult
required
Show InboundResult
Show InboundResult
string
Serialized 997 interchange acknowledging what we received.
None when the inbound interchange only contained FA groups or was rejected.string
Serialized EDIFACT CONTRL acknowledgment, for inbound EDIFACT interchanges.
string
Serialized TA1 interchange rejection, when envelope validation failed.
InboundDocument[]
required
string
integer
required
Minimum:
0.string
required
string
required
string
required
processed or interchange_rejected.Status codes
| Code | Meaning |
|---|---|
200 | Processing result with acknowledgment |
404 | No partner matches the ISA sender |
409 | Duplicate interchange control number |
422 | Email carries no EDI attachment/body, or unparseable |
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 --silent --show-error --fail-with-body --request POST \
--url 'https://edi.stateset.com/v1/as1/inbound' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY" \
--header 'Content-Type: application/json' \
--data @as1-email.json
{
"success": true,
"data": {
"ack_997": "string",
"ack_contrl": "string",
"ack_ta1": "string",
"documents": [
{
"control_number": "string",
"error": "string",
"parsed": {},
"reference": "ORD-10042",
"status": "pending",
"transaction_set": "string"
}
],
"error": "string",
"events_queued": 1,
"interchange_control_number": "string",
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending"
}
}
Last modified on August 31, 2026