---
title: "GET /payer/{stediId}"
method: GET
path: "/payer/{stediId}"
---

# GET /payer/{stediId}

`GET /payer/{stediId}`

Retrieve a single payer record by its Stedi payer ID.

## Path parameters

- `stediId` string, required — 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.

## Response `200`

GetPayerRecord 200 response

- GetPayerRecordResponseContent
  - `payer` PayerRecord, required
    - `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.
        - `claimPaymentAdviceWithElectronicFundsTransfer` ClaimPaymentAdviceWithElectronicFundsTransferEnrollmentProcess — Details about the enrollment process for Electronic Remittance Advice (ERA) with Electronic Funds Transfer (EFT).
          - `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.
        - `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.
        - `electronicFundsTransfer` ElectronicFundsTransferEnrollmentProcess — Details about the enrollment process for Electronic Funds Transfer (EFT).
          - `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 claim status requests, 837 professional claims, 835 ERAs (claim payments), Electronic Funds Transfer (EFT), and 835 ERA with Electronic Funds Transfer (EFT). 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
      - `claimPaymentAdviceWithElectronicFundsTransfer` '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
      - `electronicFundsTransfer` '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.

## Other responses

- `400` — ValidationException 400 response
- `401` — UnauthorizedException 401 response
- `404` — ResourceNotFoundException 404 response
- `500` — InternalFailureException 500 response

---

[API](https://skmtc.net/stedi/apis/stedi-payers.md) · [All operations](https://skmtc.net/stedi/apis/stedi-payers/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stedi/stedi-payers/versions/15409ffbbb1f/schema)
