270

Wire-ready X12 270 eligibility inquiry

POST /v1/edi/outbound/270/{partner_id}

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/edi/outbound/270/{partner_id}' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --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

partner_id · string · required

Partner ID

Request body

EligibilityInquiry270

inquiry_date · string (date) · required

BHT04 — inquiry date.

payer_id · string · required

payer_name · string · required

2100A NM1*PR — payer name and id (PI).

provider_name · string · required

2100B NM1*1P — provider name and NPI (XX).

provider_npi · string · required

service_types · string[]

2110C EQ — service type codes (default 30, health benefit plan coverage).

subscriber · Subscriber · required

trace_number · 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
422	Invalid payload or delimiter collision

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/edi/outbound/270/{partner_id}' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --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"
}'