--- title: "GET /payers" method: GET path: "/payers" tags: ["Payers"] --- # GET /payers `GET /payers` List Stedi's supported payers in JSON format ## Query parameters - `pageSize` integer — The maximum number of elements to return per page. If not set, Stedi returns all payers in a single response (no pagination). - `pageToken` string — 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. ## Response `200` ListPayerRecords 200 response - ListPayerRecordsResponseContent — Common output structure for list operations with pagination support. - `items` PayerRecord[], required — Payers that Stedi supports for each transaction type. Results are returned in alphabetical order of the Stedi ID. - `aliases` string[], required — Alternative IDs associated with a payer. If a payer changes their `primaryPayerId`, aliases allow you to continue sending transactions to the payer using the old ID uninterrupted. - `avatarUrl` string — A URL pointing to an image file (`.png`, `.jpeg`, or `.jpg`) with the payer's logo. This is the same logo Stedi displays in the [Payer Network](https://www.stedi.com/healthcare/network). You can use this property to display payer logos in your system or application. This property is only returned when a payer logo is available. - `coverageTypes` CoverageType[] — A list of insurance coverage types that indicates whether this payer supports transactions for medical coverage, dental coverage, vision coverage, or a combination of these. For example: `["medical"]` or `["medical", "dental"]`. When this array isn't in the response, it means Stedi hasn't classified the payer's coverage types yet, **not** that the payer doesn't support any coverage types. - `displayName` string, required — The payer's business name, such as Cigna or Aetna. This is the name most commonly used to identify the payer. - `employerIdentificationNumbers` string[] — Employer Identification Numbers (EINs) associated with this payer. - `enrollment` EnrollmentInfo — Information about enrollment requirements for the payer - `ptanRequired` boolean — Whether a PTAN (Provider Transaction Access Number) is required for transaction enrollment. The Provider Transaction Access Number (PTAN) is a Medicare-issued number given to providers upon enrollment with Medicare. This number is usually six digits and is assigned based on the type of service and the location of the provider. Upon enrollment, Medicare Administrating Contracting (MAC) providers should receive their assigned PTAN number in their approval letter. - `transactionEnrollmentProcesses` TransactionEnrollmentProcesses — Information about the transaction enrollment requirements and expected timeframes for each transaction type. - `claimPayment` ClaimPaymentEnrollmentProcess — Details about the enrollment process for Electronic Remittance Advice (ERAs). - `requestedEffectiveDate` 'SUPPORTED' | 'NOT_SUPPORTED' — Whether a payer supports specifying a requested effective date for transaction enrollments. - `supportedAggregationPreferences` SupportedAggregationType[] — Aggregation types this payer supports for 835 Electronic Remittance Advice (ERA) transactions. Payers can aggregate by the provider's NPI, tax ID (TIN), or both. - You can use this information to specify an `aggregationPreference` when submitting ERA enrollment requests. - This property is only returned when Stedi can determine the payer's supported aggregation types. - `timeframe` 'INSTANT' | 'HOURS' | 'DAYS' | 'WEEKS' — Stedi's expected timeframe for completing the transaction enrollment process. `INSTANT` indicates that the enrollment will be in `LIVE` status within minutes of submitting the request. - `type` 'ONE_CLICK' | 'MULTI_STEP' — Whether transaction enrollment is single or multi-step. - `ONE_CLICK` indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you. - `MULTI_STEP` indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps. - `claimStatusInquiry` ClaimStatusInquiryEnrollmentProcess — Details about the enrollment process for real-time claim status requests. - `requestedEffectiveDate` 'SUPPORTED' | 'NOT_SUPPORTED' — Whether a payer supports specifying a requested effective date for transaction enrollments. - `timeframe` 'INSTANT' | 'HOURS' | 'DAYS' | 'WEEKS' — Stedi's expected timeframe for completing the transaction enrollment process. `INSTANT` indicates that the enrollment will be in `LIVE` status within minutes of submitting the request. - `type` 'ONE_CLICK' | 'MULTI_STEP' — Whether transaction enrollment is single or multi-step. - `ONE_CLICK` indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you. - `MULTI_STEP` indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps. - `coordinationOfBenefits` CoordinationOfBenefitsEnrollmentProcess — Details about the enrollment process for coordination of benefits (COB) checks. - `requestedEffectiveDate` 'SUPPORTED' | 'NOT_SUPPORTED' — Whether a payer supports specifying a requested effective date for transaction enrollments. - `timeframe` 'INSTANT' | 'HOURS' | 'DAYS' | 'WEEKS' — Stedi's expected timeframe for completing the transaction enrollment process. `INSTANT` indicates that the enrollment will be in `LIVE` status within minutes of submitting the request. - `type` 'ONE_CLICK' | 'MULTI_STEP' — Whether transaction enrollment is single or multi-step. - `ONE_CLICK` indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you. - `MULTI_STEP` indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps. - `dentalClaim` DentalClaimEnrollmentProcess — Details about the enrollment process for dental claim submission. - `requestedEffectiveDate` 'SUPPORTED' | 'NOT_SUPPORTED' — Whether a payer supports specifying a requested effective date for transaction enrollments. - `timeframe` 'INSTANT' | 'HOURS' | 'DAYS' | 'WEEKS' — Stedi's expected timeframe for completing the transaction enrollment process. `INSTANT` indicates that the enrollment will be in `LIVE` status within minutes of submitting the request. - `type` 'ONE_CLICK' | 'MULTI_STEP' — Whether transaction enrollment is single or multi-step. - `ONE_CLICK` indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you. - `MULTI_STEP` indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps. - `eligibilityInquiry` EligibilityInquiryEnrollmentProcess — Details about the enrollment process for eligibility checks. - `requestedEffectiveDate` 'SUPPORTED' | 'NOT_SUPPORTED' — Whether a payer supports specifying a requested effective date for transaction enrollments. - `timeframe` 'INSTANT' | 'HOURS' | 'DAYS' | 'WEEKS' — Stedi's expected timeframe for completing the transaction enrollment process. `INSTANT` indicates that the enrollment will be in `LIVE` status within minutes of submitting the request. - `type` 'ONE_CLICK' | 'MULTI_STEP' — Whether transaction enrollment is single or multi-step. - `ONE_CLICK` indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you. - `MULTI_STEP` indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps. - `institutionalClaim` InstitutionalClaimEnrollmentProcess — Details about the enrollment process for institutional claim submission. - `requestedEffectiveDate` 'SUPPORTED' | 'NOT_SUPPORTED' — Whether a payer supports specifying a requested effective date for transaction enrollments. - `timeframe` 'INSTANT' | 'HOURS' | 'DAYS' | 'WEEKS' — Stedi's expected timeframe for completing the transaction enrollment process. `INSTANT` indicates that the enrollment will be in `LIVE` status within minutes of submitting the request. - `type` 'ONE_CLICK' | 'MULTI_STEP' — Whether transaction enrollment is single or multi-step. - `ONE_CLICK` indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you. - `MULTI_STEP` indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps. - `professionalClaim` ProfessionalClaimEnrollmentProcess — Details about the enrollment process for professional claim submission. - `requestedEffectiveDate` 'SUPPORTED' | 'NOT_SUPPORTED' — Whether a payer supports specifying a requested effective date for transaction enrollments. - `timeframe` 'INSTANT' | 'HOURS' | 'DAYS' | 'WEEKS' — Stedi's expected timeframe for completing the transaction enrollment process. `INSTANT` indicates that the enrollment will be in `LIVE` status within minutes of submitting the request. - `type` 'ONE_CLICK' | 'MULTI_STEP' — Whether transaction enrollment is single or multi-step. - `ONE_CLICK` indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you. - `MULTI_STEP` indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps. - `unsolicitedClaimAttachment` UnsolicitedClaimAttachmentEnrollmentProcess — Details about the enrollment process for unsolicited claim attachments. - `requestedEffectiveDate` 'SUPPORTED' | 'NOT_SUPPORTED' — Whether a payer supports specifying a requested effective date for transaction enrollments. - `timeframe` 'INSTANT' | 'HOURS' | 'DAYS' | 'WEEKS' — Stedi's expected timeframe for completing the transaction enrollment process. `INSTANT` indicates that the enrollment will be in `LIVE` status within minutes of submitting the request. - `type` 'ONE_CLICK' | 'MULTI_STEP' — Whether transaction enrollment is single or multi-step. - `ONE_CLICK` indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you. - `MULTI_STEP` indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps. - `names` string[], required — Alternative names associated with a payer. These additional names help you search for and identify payers using the name most familiar to your organization. - `operatingStates` OperatingStateCode[] — A list of US state codes, territories, or `NATIONAL` that indicates the geographic regions where this payer operates. For example: `["CA", "OR"]` for a regional payer, or `["NATIONAL"]` for a payer that operates throughout the entire United States. When this array isn't in the response, it means Stedi hasn't classified the payer's operating states yet. - `parentPayerGroupId` string — The payer's parent payer group entity. This is metadata Stedi uses internally. It doesn't necessarily relate to the payer's enrollment process or other capabilities. - `primaryPayerId` string, required — The most commonly used ID for a payer. This value often corresponds to the name the payer uses internally and provides to patients on member ID cards. - `stediId` string, required — A unique ID that Stedi assigned to this payer and uses internally for routing requests. This ID will not change even if the `primaryPayerId` is updated. - `transactionSupport` TransactionSupport, required — Whether the following transaction types are supported: 270 eligibility checks, 276 claim status requests, 837 professional claims, and 835 ERAs (claim payments). If the value is `ENROLLMENT_REQUIRED`, Stedi supports the transaction type, but you must [enroll with the payer](https://www.stedi.com/docs/healthcare/supported-payers#enrollment) first. - `claimPayment` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `claimStatus` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `claimSubmission` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `coordinationOfBenefits` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `dentalClaimSubmission` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `eligibilityCheck` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `institutionalClaimSubmission` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `professionalClaimSubmission` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `unsolicitedClaimAttachment` 'SUPPORTED' | 'NOT_SUPPORTED' | 'ENROLLMENT_REQUIRED', required - `urls` PayerUrls — URLs associated with a payer. - `website` string — The payer's website URL. - `nextPageToken` string — Token that you can supply in subsequent requests to retrieve the next page of results. If not returned, there are no more results. ## Other responses - `400` — ValidationException 400 response - `403` — AccessDeniedException 403 response - `404` — ResourceNotFoundException 404 response - `429` — ThrottlingException 429 response - `500` — InternalFailureException 500 response - `503` — ServiceUnavailableException 503 response - `504` — GatewayTimeoutException 504 response --- [API](https://skmtc.net/stedi/apis/stedi-healthcare.md) · [All operations](https://skmtc.net/stedi/apis/stedi-healthcare/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stedi/stedi-healthcare/versions/c156a60615bb/schema)