--- title: "GET /payers" method: GET path: "/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. - `conciseName` string — A shorter version of the payer's display name for use in dense UI views. This property is only returned when a concise name is available for the payer. - `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", "vision"]`. 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' | 'OVER_4_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' | 'OVER_4_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' | 'OVER_4_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' | 'OVER_4_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' | 'OVER_4_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' | 'OVER_4_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' | 'OVER_4_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' | 'OVER_4_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 in all 50 U.S. states. Supported territories are listed separately. When this array isn't in the response, it means Stedi hasn't classified the payer's operating states yet. - `parentPayerGroupId` string — The identifier for the corporate or brand group to which the payer belongs. The parent payer group is organizational metadata only – it doesn't affect routing, enrollment, or transaction support. Payers sharing a parent payer group may have different enrollment processes or other behaviors. This property is only returned when the payer has a parent payer group. - `parentPayerGroupName` string — The name of the corporate or brand group to which the payer belongs. The parent payer group is organizational metadata only – it doesn't affect routing, enrollment, or transaction support. Payers sharing a parent payer group may have different enrollment processes or other behaviors. This property is only returned when the payer has a parent payer group. - `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. - `programs` Program[], required — A list of insurance programs that this payer participates in. For example: `["MEDICAID", "MEDICARE"]`. If Stedi hasn't assigned any programs to this payer, this array is empty. - `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/277 claim status requests, 837 claims (professional, dental, institutional), 835 ERAs (claim payments), 275 unsolicited claim attachments, and coordination of benefits checks. 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 - `404` — ResourceNotFoundException 404 response - `500` — InternalFailureException 500 response ## Changes - **2026-08-10** `45a2088b99ae` — 2 breaking, 2 warning - removed the required property `items/items/transactionSupport/claimPaymentAdviceWithElectronicFundsTransfer` from the response with the `200` status - removed the required property `items/items/transactionSupport/electronicFundsTransfer` from the response with the `200` status - removed the optional property `items/items/enrollment/transactionEnrollmentProcesses/claimPaymentAdviceWithElectronicFundsTransfer` from the response with the `200` status - removed the optional property `items/items/enrollment/transactionEnrollmentProcesses/electronicFundsTransfer` from the response with the `200` status - **2026-08-07** `15409ffbbb1f` — 4 info - added the optional property `items/items/enrollment/transactionEnrollmentProcesses/claimPaymentAdviceWithElectronicFundsTransfer` to the response with the `200` status - added the optional property `items/items/enrollment/transactionEnrollmentProcesses/electronicFundsTransfer` to the response with the `200` status - added the required property `items/items/transactionSupport/claimPaymentAdviceWithElectronicFundsTransfer` to the response with the `200` status - added the required property `items/items/transactionSupport/electronicFundsTransfer` to the response with the `200` status - **2026-07-14** `1dcc06bebd7c` — 1 info - added the optional property `items/items/parentPayerGroupName` to the response with the `200` status - …earlier changes not shown [Full history](https://skmtc.dev/stedi/apis/stedi-payers/changes/payers/get.md) --- [API](https://skmtc.dev/stedi/apis/stedi-payers.md) · [All operations](https://skmtc.dev/stedi/apis/stedi-payers/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stedi/stedi-payers/revisions/45a2088b99ae/schema)