Stedi Payers API
The Payers API from Stedi — 4 operation(s) for payers.
OpenAPI Specification
openapi: 3.0.3
info:
contact:
email: healthcare@stedi.com
license:
name: Proprietary
url: https://stedi.com
title: Stedi Healthcare Claims Claim acknowledgments Payers API
version: '2025-03-07'
servers:
- description: Production
url: https://claims.us.stedi.com/2025-03-07
security:
- httpApiKeyAuth: []
tags:
- name: Payers
paths:
/payer/{stediId}:
get:
description: Retrieve a single payer record by its Stedi payer ID.
operationId: GetPayerRecord
parameters:
- description: 'The Stedi payer ID, a unique identifier Stedi assigns to each payer that will never change. You can find the Stedi payer ID for any supported payer in the [Payer Network](https://www.stedi.com/healthcare/network).
This must be the Stedi payer ID - querying with the primary payer ID or payer ID aliases isn''t supported.'
examples:
GetPayerRecord_example1:
description: ''
summary: Retrieve payer record
value: QDTRP
in: path
name: stediId
required: true
schema:
description: 'The Stedi payer ID, a unique identifier Stedi assigns to each payer that will never change. You can find the Stedi payer ID for any supported payer in the [Payer Network](https://www.stedi.com/healthcare/network).
This must be the Stedi payer ID - querying with the primary payer ID or payer ID aliases isn''t supported.'
pattern: ^[A-Z]{5}$
type: string
responses:
'200':
content:
application/json:
examples:
GetPayerRecord_example1:
description: ''
summary: Retrieve payer record
value:
payer:
aliases:
- '00420'
- '13123'
- '1584'
- '4714'
- '95655'
- MEDGL
- MEDGLD
- MEDIGOLD
avatarUrl: https://prod-payer-avatars.payers.us.stedi.com/YKHRB/avatar.png?v=1766600157693
coverageTypes:
- dental
- medical
displayName: Trinity Health Plan
enrollment:
ptanRequired: false
transactionEnrollmentProcesses:
claimPayment:
requestedEffectiveDate: NOT_SUPPORTED
supportedAggregationPreferences:
- NPI
- TIN
timeframe: DAYS
type: ONE_CLICK
names:
- MediGold
- Medigold Health Plans
- Mount Carmel Health Plan
- Mount Carmel MediGold
- Trinity Health Plan of Michigan
operatingStates:
- ID
- IA
- MI
- NY
- OH
parentPayerGroupId: GTRSH
primaryPayerId: '95655'
stediId: YKHRB
transactionSupport:
claimPayment: ENROLLMENT_REQUIRED
claimStatus: SUPPORTED
claimSubmission: SUPPORTED
coordinationOfBenefits: NOT_SUPPORTED
dentalClaimSubmission: NOT_SUPPORTED
eligibilityCheck: SUPPORTED
institutionalClaimSubmission: SUPPORTED
professionalClaimSubmission: SUPPORTED
unsolicitedClaimAttachment: NOT_SUPPORTED
urls:
website: https://www.thpmedicare.org
schema:
$ref: '#/components/schemas/GetPayerRecordResponseContent'
description: GetPayerRecord 200 response
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationExceptionResponseContent'
description: ValidationException 400 response
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedExceptionResponseContent'
description: UnauthorizedException 401 response
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedExceptionResponseContent'
description: AccessDeniedException 403 response
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundExceptionResponseContent'
description: ResourceNotFoundException 404 response
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingExceptionResponseContent'
description: ThrottlingException 429 response
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/InternalFailureExceptionResponseContent'
description: InternalFailureException 500 response
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailableExceptionResponseContent'
description: ServiceUnavailableException 503 response
'504':
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutExceptionResponseContent'
description: GatewayTimeoutException 504 response
tags:
- Payers
/payers:
get:
description: List Stedi's supported payers in JSON format
operationId: ListPayerRecords
parameters:
- description: The maximum number of elements to return per page. If not set, Stedi returns all payers in a single response (no pagination).
examples:
ListPayerRecords_example1:
description: ''
summary: List payers with pagination
value: 100
in: query
name: pageSize
schema:
description: The maximum number of elements to return per page. If not set, Stedi returns all payers in a single response (no pagination).
minimum: 10
type: integer
- description: The `nextPageToken` value from a previous response. You can use this to get the next page of results. If not set, Stedi returns the first page of results.
in: query
name: pageToken
schema:
description: The `nextPageToken` value from a previous response. You can use this to get the next page of results. If not set, Stedi returns the first page of results.
maxLength: 1024
minLength: 1
type: string
responses:
'200':
content:
application/json:
examples:
ListPayerRecords_example1:
description: ''
summary: List payers with pagination
value:
items:
- aliases:
- '00420'
- '13123'
- '1584'
- '4714'
- '95655'
- MEDGL
- MEDGLD
- MEDIGOLD
avatarUrl: https://prod-payer-avatars.payers.us.stedi.com/YKHRB/avatar.png?v=1766600157693
coverageTypes:
- dental
- medical
displayName: Trinity Health Plan
enrollment:
ptanRequired: false
transactionEnrollmentProcesses:
claimPayment:
requestedEffectiveDate: NOT_SUPPORTED
supportedAggregationPreferences:
- NPI
- TIN
timeframe: DAYS
type: ONE_CLICK
names:
- MediGold
- Medigold Health Plans
- Mount Carmel Health Plan
- Mount Carmel MediGold
- Trinity Health Plan of Michigan
operatingStates:
- ID
- IA
- MI
- NY
- OH
parentPayerGroupId: GTRSH
primaryPayerId: '95655'
stediId: YKHRB
transactionSupport:
claimPayment: ENROLLMENT_REQUIRED
claimStatus: SUPPORTED
claimSubmission: SUPPORTED
coordinationOfBenefits: NOT_SUPPORTED
dentalClaimSubmission: NOT_SUPPORTED
eligibilityCheck: SUPPORTED
institutionalClaimSubmission: SUPPORTED
professionalClaimSubmission: SUPPORTED
unsolicitedClaimAttachment: NOT_SUPPORTED
urls:
website: https://www.thpmedicare.org
nextPageToken: yrZ3we9982etYlMgmw==
schema:
$ref: '#/components/schemas/ListPayerRecordsResponseContent'
description: ListPayerRecords 200 response
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationExceptionResponseContent'
description: ValidationException 400 response
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedExceptionResponseContent'
description: AccessDeniedException 403 response
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundExceptionResponseContent'
description: ResourceNotFoundException 404 response
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingExceptionResponseContent'
description: ThrottlingException 429 response
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/InternalFailureExceptionResponseContent'
description: InternalFailureException 500 response
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailableExceptionResponseContent'
description: ServiceUnavailableException 503 response
'504':
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutExceptionResponseContent'
description: GatewayTimeoutException 504 response
tags:
- Payers
/payers/csv:
get:
description: List Stedi's supported payers in CSV format
operationId: ListPayerRecordsCsv
responses:
'200':
content:
text/plain:
examples:
ListPayerRecordsCsv_example1:
description: ''
summary: List payers
value: '"StediId","PrimaryPayerId","DisplayName","Names","Aliases","EligibilityInquiry","EligibilityInquiryEnrollmentRequired","EligibilityInquiryEnrollmentType","EligibilityInquiryEnrollmentTimeframe","EligibilityInquiryEnrollmentRequestedEffectiveDate","ClaimStatusInquiry","ClaimStatusInquiryEnrollmentRequired","ClaimStatusInquiryEnrollmentType","ClaimStatusInquiryEnrollmentTimeframe","ClaimStatusInquiryEnrollmentRequestedEffectiveDate","ProfessionalClaim","ProfessionalClaimEnrollmentRequired","ProfessionalClaimEnrollmentType","ProfessionalClaimEnrollmentTimeframe","ProfessionalClaimEnrollmentRequestedEffectiveDate","InstitutionalClaim","InstitutionalClaimEnrollmentRequired","InstitutionalClaimEnrollmentType","InstitutionalClaimEnrollmentTimeframe","InstitutionalClaimEnrollmentRequestedEffectiveDate","DentalClaim","DentalClaimEnrollmentRequired","DentalClaimEnrollmentType","DentalClaimEnrollmentTimeframe","DentalClaimEnrollmentRequestedEffectiveDate","ClaimPaymentAdvice","ClaimPaymentAdviceEnrollmentRequired","ClaimPaymentEnrollmentType","ClaimPaymentEnrollmentTimeframe","ClaimPaymentEnrollmentSupportedAggregationPreferences","ClaimPaymentEnrollmentRequestedEffectiveDate","CoordinationOfBenefits","CoordinationOfBenefitsEnrollmentRequired","CoordinationOfBenefitsEnrollmentType","CoordinationOfBenefitsEnrollmentTimeframe","CoordinationOfBenefitsEnrollmentRequestedEffectiveDate","ClaimAttachmentsSupport","ClaimAttachmentsSupportEnrollmentRequired","ClaimAttachmentEnrollmentType","ClaimAttachmentEnrollmentTimeframe","ClaimAttachmentEnrollmentRequestedEffectiveDate","EmployerIdentificationNumbers","CoverageTypes","OperatingStates","PtanRequired","ParentPayerGroupId","WebsiteUrl"
"YKHRB","95655","Trinity Health Plan","MediGold|Medigold Health Plans|Mount Carmel Health Plan|Mount Carmel MediGold|Trinity Health Plan of Michigan","00420|13123|1584|4714|95655|MEDGL|MEDGLD|MEDIGOLD","true","false","","","","true","false","","","","true","false","","","","true","false","","","","false","false","","","","true","true","ONE_CLICK","DAYS","NPI|TIN","NOT_SUPPORTED","false","false","","","","false","false","","","","","dental|medical","ID|IA|MI|NY|OH","false","GTRSH","https://www.thpmedicare.org"'
schema:
$ref: '#/components/schemas/ListPayerRecordsCsvOutputPayload'
description: ListPayerRecordsCsv 200 response
headers:
Content-Type:
description: Content type for CSV data
schema:
description: Content type for CSV data
type: string
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationExceptionResponseContent'
description: ValidationException 400 response
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedExceptionResponseContent'
description: AccessDeniedException 403 response
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundExceptionResponseContent'
description: ResourceNotFoundException 404 response
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingExceptionResponseContent'
description: ThrottlingException 429 response
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/InternalFailureExceptionResponseContent'
description: InternalFailureException 500 response
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailableExceptionResponseContent'
description: ServiceUnavailableException 503 response
'504':
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutExceptionResponseContent'
description: GatewayTimeoutException 504 response
tags:
- Payers
/payers/search:
get:
description: Search for payers by name, ID, or alias.
operationId: SearchPayers
parameters:
- description: The maximum number of elements to return in a page. If not specified, the default is 20.
in: query
name: pageSize
schema:
description: The maximum number of elements to return in a page. If not specified, the default is 20.
maximum: 100
minimum: 10
type: integer
- description: An opaque token returned by a previous call to this endpoint in the `nextPageToken` property. You can use it to request the next page of results. If not specified, Stedi returns the first page of results.
in: query
name: pageToken
schema:
description: An opaque token returned by a previous call to this endpoint in the `nextPageToken` property. You can use it to request the next page of results. If not specified, Stedi returns the first page of results.
maxLength: 1024
minLength: 1
type: string
- description: The query Stedi will use to search the Payer Network database. You can supply a payer's name, ID, or alias. The query is case-insensitive, and fuzzy matching is supported. For example, `cig`, `62308`, and `SX071` all return Cigna in the results. If not provided, the other search options are used to conduct the search.
examples:
SearchPayers_example1:
description: ''
summary: Search for query string
value: Blue Cross
SearchPayers_example2:
description: ''
summary: Search with multiple filters
value: Blue Cross
in: query
name: query
schema:
description: The query Stedi will use to search the Payer Network database. You can supply a payer's name, ID, or alias. The query is case-insensitive, and fuzzy matching is supported. For example, `cig`, `62308`, and `SX071` all return Cigna in the results. If not provided, the other search options are used to conduct the search.
maxLength: 200
type: string
- description: Filter for matching payers with the specified 270 eligibility checks support. When combined with other transaction filters, payers must satisfy **all** specified criteria to be included in results.
examples:
SearchPayers_example2:
description: ''
summary: Search with multiple filters
value: SUPPORTED
in: query
name: eligibilityCheck
schema:
$ref: '#/components/schemas/TransactionFilterValue'
- description: Filter for matching payers with the specified 276/277 real-time claim status checks support. When combined with other transaction filters, payers must satisfy **all** specified criteria to be included in results.
examples:
SearchPayers_example2:
description: ''
summary: Search with multiple filters
value: SUPPORTED
in: query
name: claimStatus
schema:
$ref: '#/components/schemas/TransactionFilterValue'
- description: Filter for matching payers with the specified 837 professional claims support. When combined with other transaction filters, payers must satisfy **all** specified criteria to be included in results.
in: query
name: professionalClaimSubmission
schema:
$ref: '#/components/schemas/TransactionFilterValue'
- description: Filter for matching payers with the specified 837 dental claims support. When combined with other transaction filters, payers must satisfy **all** specified criteria to be included in results.
in: query
name: dentalClaimSubmission
schema:
$ref: '#/components/schemas/TransactionFilterValue'
- description: Filter for matching payers with the specified 837 institutional claims support. When combined with other transaction filters, payers must satisfy **all** specified criteria to be included in results.
in: query
name: institutionalClaimSubmission
schema:
$ref: '#/components/schemas/TransactionFilterValue'
- description: Filter for matching payers with the specified 835 Electronic Remittance Advice (ERA) support. When combined with other transaction filters, payers must satisfy **all** specified criteria to be included in results.
in: query
name: claimPayment
schema:
$ref: '#/components/schemas/TransactionFilterValue'
- description: Filter for matching payers with the specified coordination of benefits (COB) checks support. When combined with other transaction filters, payers must satisfy **all** specified criteria to be included in results.
in: query
name: coordinationOfBenefits
schema:
$ref: '#/components/schemas/TransactionFilterValue'
- description: Filter for matching payers with the specified unsolicited 275 claim attachments support. When combined with other transaction filters, payers must satisfy **all** specified criteria to be included in results.
in: query
name: unsolicitedClaimAttachment
schema:
$ref: '#/components/schemas/TransactionFilterValue'
- description: 'Filter for matching payers that support transactions for **all** of the specified coverage types. For example, setting this array to `["medical", "dental"]` returns only payers who provide both medical and dental coverage.
The results also exclude payers without coverage type classifications in Stedi''s database.'
explode: true
in: query
name: coverageTypes
schema:
description: 'Filter for matching payers that support transactions for **all** of the specified coverage types. For example, setting this array to `["medical", "dental"]` returns only payers who provide both medical and dental coverage.
The results also exclude payers without coverage type classifications in Stedi''s database.'
items:
$ref: '#/components/schemas/CoverageType'
type: array
style: form
- description: 'Filter for matching payers that operate in **all** of the specified states. For example, setting this array to `["CA", "OR"]` returns only payers that operate in both California and Oregon, and setting it to `["NATIONAL"]` returns payers that operate throughout the entire United States.
The results also exclude payers without operating state classifications in Stedi''s database.'
explode: true
in: query
name: operatingStates
schema:
description: 'Filter for matching payers that operate in **all** of the specified states. For example, setting this array to `["CA", "OR"]` returns only payers that operate in both California and Oregon, and setting it to `["NATIONAL"]` returns payers that operate throughout the entire United States.
The results also exclude payers without operating state classifications in Stedi''s database.'
items:
$ref: '#/components/schemas/OperatingStateCode'
type: array
style: form
responses:
'200':
content:
application/json:
examples:
SearchPayers_example1:
description: ''
summary: Search for query string
value:
items:
- matches:
names:
- Highmark <b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b>
- Highmark <b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> Pennsylvania
- Highmark <b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> Pennsylvania Professional
- Highmark <b>Blue</b> <b>Shield</b>
- Keystone Health Plan West - Community <b>Blue</b> HMO
payer:
aliases:
- '10046'
- '100900'
- '10264'
- '10524'
- '2413'
- '54771'
- '95462'
- PABCBS
- PABLS
- SB865
- SB865MA
- SZXAY
avatarUrl: https://prod-payer-avatars.payers.us.stedi.com/GUFCO/avatar.png?v=1763077235241
coverageTypes:
- dental
- medical
- vision
displayName: Highmark of Pennsylvania
enrollment:
ptanRequired: false
transactionEnrollmentProcesses:
claimPayment:
requestedEffectiveDate: NOT_SUPPORTED
supportedAggregationPreferences:
- NPI
- TIN
timeframe: DAYS
type: ONE_CLICK
claimStatusInquiry:
timeframe: DAYS
type: ONE_CLICK
names:
- Highmark Blue Cross Blue Shield
- Highmark Blue Cross Blue Shield Pennsylvania
- Highmark Blue Cross Blue Shield Pennsylvania Professional
- Highmark Blue Shield
- Keystone Health Plan West - Community Blue HMO
- First Priority Life Insurance Company (FPLIC) Out-of-Area Claims
- Highmark of Pennsylvania - Medicare Advantage
operatingStates:
- PA
parentPayerGroupId: QOSPQ
primaryPayerId: '54771'
stediId: GUFCO
transactionSupport:
claimPayment: ENROLLMENT_REQUIRED
claimStatus: ENROLLMENT_REQUIRED
coordinationOfBenefits: SUPPORTED
dentalClaimSubmission: NOT_SUPPORTED
eligibilityCheck: ENROLLMENT_REQUIRED
institutionalClaimSubmission: NOT_SUPPORTED
professionalClaimSubmission: SUPPORTED
unsolicitedClaimAttachment: NOT_SUPPORTED
score: 2314894167593451500
stats:
total: 142
transactionSupport:
claimPayment:
enrollmentRequired: 113
notSupported: 29
supported: 0
claimStatus:
enrollmentRequired: 3
notSupported: 55
supported: 84
coordinationOfBenefits:
enrollmentRequired: 0
notSupported: 114
supported: 28
dentalClaimSubmission:
enrollmentRequired: 2
notSupported: 95
supported: 45
eligibilityCheck:
enrollmentRequired: 5
notSupported: 33
supported: 104
institutionalClaimSubmission:
enrollmentRequired: 10
notSupported: 30
supported: 102
professionalClaimSubmission:
enrollmentRequired: 9
notSupported: 16
supported: 117
unsolicitedClaimAttachment:
enrollmentRequired: 0
notSupported: 109
supported: 33
transactionSupportCounts:
claimPayment:
notSupported:
total: 29
supported:
enrollmentNotRequired: 0
enrollmentRequired: 113
total: 113
claimStatus:
notSupported:
total: 55
supported:
enrollmentNotRequired: 84
enrollmentRequired: 3
total: 87
coordinationOfBenefits:
notSupported:
total: 114
supported:
enrollmentNotRequired: 28
enrollmentRequired: 0
total: 28
dentalClaimSubmission:
notSupported:
total: 95
supported:
enrollmentNotRequired: 45
enrollmentRequired: 2
total: 47
eligibilityCheck:
notSupported:
total: 33
supported:
enrollmentNotRequired: 104
enrollmentRequired: 5
total: 109
institutionalClaimSubmission:
notSupported:
total: 30
supported:
enrollmentNotRequired: 102
enrollmentRequired: 10
total: 112
professionalClaimSubmission:
notSupported:
total: 16
supported:
enrollmentNotRequired: 117
enrollmentRequired: 9
total: 126
unsolicitedClaimAttachment:
notSupported:
total: 109
supported:
enrollmentNotRequired: 33
enrollmentRequired: 0
total: 33
SearchPayers_example2:
description: ''
summary: Search with multiple filters
value:
items:
- matches:
aliases:
- <b>BCSNC</b>
displayName: <b>Blue</b> <b>Cross</b> NC
names:
- <b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> North Carolina
- <b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> of North Carolina
- <b>Blue</b> <b>Cross</b> NC - Medicare Advantage
- <b>Blue</b> <b>Cross</b> NC – Dental <b>Blue</b>
primaryPayerId: <b>BCSNC</b>
payer:
aliases:
- BCSNC
- '10383'
- 12B23
- '1411'
- '560894904'
- '61472'
- '61473'
- '7472'
- '7514'
- '7814'
- NCBCBS
- NCBLS
- NCPNHP
- SB810
- SB810MA
avatarUrl: https://prod-payer-avatars.payers.us.stedi.com/UPICO/avatar.png?v=1765912707668
coverageTypes:
- dental
- medical
- vision
displayName: Blue Cross NC
employerIdentificationNumbers:
- 56-0894904
enrollment:
ptanRequired: false
# --- truncated at 32 KB (81 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stedi/refs/heads/main/openapi/stedi-payers-api-openapi.yml