Retrieve Payer

Retrieve a single payer record by its Stedi payer ID.

GET /payer/{stediId}

You can use this endpoint to retrieve a specific payer record with the Stedi payer ID (stediId). You can find the Stedi payer ID for any supported payer in the Payer Network. Note that you must supply the Stedi payer ID - this endpoint doesn't support querying with the primary payer ID or payer ID aliases.

The payer record includes the payer's names, aliases, and supported use cases (medical, dental, or vision). It also contains supported transaction types and specifies whether transaction enrollment is required.

Payer records can change. If you store payer details in your own system, refresh them at least once a day.

Authorizations

Authorization · Required Header

A Stedi API Key for authentication.

Path Parameters

stediId · String Regex pattern : ^[A-Z]{5}$

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.

This must be the Stedi payer ID - querying with the primary payer ID or payer ID aliases isn't supported.

Response

application/json

payer · Object Required

The payer record matching the provided Stedi payer ID. The record includes the payer's display name and aliases as well as supported transaction types and details about the payer's transaction enrollment process.

Request

curl --request GET \
  --url "https://payers.us.stedi.com/2024-04-01/payer/{stediId}" \
  --header "Authorization: <api_key>"

Response

{
  "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",
    "parentPayerGroupName": "Trinity Health",
    "primaryPayerId": "95655",
    "programs": [
      "MEDICARE"
    ],
    "stediId": "YKHRB",
    "transactionSupport": {
      "claimPayment": "ENROLLMENT_REQUIRED",
      "claimPaymentAdviceWithElectronicFundsTransfer": "NOT_SUPPORTED",
      "claimStatus": "SUPPORTED",
      "claimSubmission": "SUPPORTED",
      "coordinationOfBenefits": "NOT_SUPPORTED",
      "dentalClaimSubmission": "NOT_SUPPORTED",
      "electronicFundsTransfer": "NOT_SUPPORTED",
      "eligibilityCheck": "SUPPORTED",
      "institutionalClaimSubmission": "SUPPORTED",
      "professionalClaimSubmission": "SUPPORTED",
      "unsolicitedClaimAttachment": "NOT_SUPPORTED"
    },
    "urls": {
      "website": "https://www.thpmedicare.org"
    }
  }
}