curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/270/{partner_id}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header "Idempotency-Key: ${IDEMPOTENCY_KEY:?Set a unique key for this operation; preserve it on retries}" \
--header 'Content-Type: application/json' \
--data '{
"inquiry_date": "2026-08-31",
"payer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"payer_name": "string",
"provider_name": "string",
"provider_npi": "string",
"service_types": [
"string"
],
"subscriber": {
"date_of_birth": "2026-08-31",
"first_name": "Ada",
"gender": "string",
"last_name": "Lovelace",
"member_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"trace_number": "string"
}'
270
Wire-ready X12 270 eligibility inquiry
POST
/
v1
/
edi
/
outbound
/
270
/
{partner_id}
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/270/{partner_id}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header "Idempotency-Key: ${IDEMPOTENCY_KEY:?Set a unique key for this operation; preserve it on retries}" \
--header 'Content-Type: application/json' \
--data '{
"inquiry_date": "2026-08-31",
"payer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"payer_name": "string",
"provider_name": "string",
"provider_npi": "string",
"service_types": [
"string"
],
"subscriber": {
"date_of_birth": "2026-08-31",
"first_name": "Ada",
"gender": "string",
"last_name": "Lovelace",
"member_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"trace_number": "string"
}'
Path parameters
string
required
Partner ID
Headers
string,null
Stable unique request key (1–128 ASCII letters/digits or -_.:). Requires Postgres. Retries return the original EDI bytes; changed JSON payload returns 409.
Request body
EligibilityInquiry270
string (date)
required
BHT04 — inquiry date.
string
required
string
required
2100A NM1*PR — payer name and id (PI).
string
required
2100B NM1*1P — provider name and NPI (XX).
string
required
string[]
2110C EQ — service type codes (default
30, health benefit plan coverage).Subscriber
required
string
required
TRN02 — trace number tying the response back to this inquiry.
Response
No response body. Wire-ready X12 270 eligibility inquiry.Status codes
| Code | Meaning |
|---|---|
200 | Wire-ready X12 270 eligibility inquiry |
403 | Not this credential’s partner |
409 | Idempotency-Key reused with a different payload |
422 | Invalid payload or delimiter collision |
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://api.edi.stateset.com/v1/edi/outbound/270/{partner_id}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header "Idempotency-Key: ${IDEMPOTENCY_KEY:?Set a unique key for this operation; preserve it on retries}" \
--header 'Content-Type: application/json' \
--data '{
"inquiry_date": "2026-08-31",
"payer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"payer_name": "string",
"provider_name": "string",
"provider_npi": "string",
"service_types": [
"string"
],
"subscriber": {
"date_of_birth": "2026-08-31",
"first_name": "Ada",
"gender": "string",
"last_name": "Lovelace",
"member_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"trace_number": "string"
}'
Last modified on October 20, 2026