List Payers JSON

List Stedi's supported payers in JSON format

GET/payers

You can use this endpoint to retrieve Payer IDs, determine which transactions each payer supports, and check whether transaction enrollment is required for the transaction types you plan to send and receive.

You can also find a searchable list of payers in the Payer Network.

Authorizations

Authorizationstringrequiredheader

A Stedi API Key for authentication.

Response

application/json

ListPayerRecords 200 response

itemsarray<object>required

Payers that Stedi supports for each transaction type. Results are returned in alphabetical order of the Stedi ID.

Array item

items[].aliasesarray<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.

items[].coverageTypesarray<string>

A list of insurance coverage types that indicates whether this payer supports transactions for medical coverage, dental coverage, or both. 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.

items[].displayNamestringrequired

The payer's business name, such as Cigna or Aetna. This is the name most commonly used to identify the payer.

items[].employerIdentificationNumbersarray<string>

Employer Identification Numbers (EINs) associated with this payer.

items[].enrollmentobject

Details about the transaction enrollment process for this payer, if available. This object may not be returned for some payers.

Show attributes

items[].enrollment.ptanRequiredboolean

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.

items[].enrollment.transactionEnrollmentProcessesobject

Enrollment details for specific transaction types.

Stedi only returns this object when information about the enrollment process is available for one or more transaction types. When this object isn't included in the response, it doesn't mean no transaction types require enrollment. Refer to the transactionSupport object for details about which transaction types require enrollment.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.claimPaymentobject

Details about the enrollment process for Electronic Remittance Advice (ERAs) with this payer.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.claimPayment.typestring

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.

Possible values

ONE_CLICK

MULTI_STEP

items[].enrollment.transactionEnrollmentProcesses.claimStatusInquiryobject

Details about the enrollment process for real-time claim status requests with this payer.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.claimStatusInquiry.typestring

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.

Possible values

ONE_CLICK

MULTI_STEP

items[].enrollment.transactionEnrollmentProcesses.coordinationOfBenefitsobject

Details about the enrollment process for coordination of benefits (COB) checks with this payer.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.coordinationOfBenefits.typestring

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.

Possible values

ONE_CLICK

MULTI_STEP

items[].enrollment.transactionEnrollmentProcesses.dentalClaimobject

Details about the enrollment process for dental claim submission with this payer.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.dentalClaim.typestring

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.

Possible values

ONE_CLICK

MULTI_STEP

items[].enrollment.transactionEnrollmentProcesses.eligibilityInquiryobject

Details about the enrollment process for eligibility checks with this payer.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.eligibilityInquiry.typestring

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.

Possible values

ONE_CLICK

MULTI_STEP

items[].enrollment.transactionEnrollmentProcesses.institutionalClaimobject

Details about the enrollment process for institutional claim submission with this payer.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.institutionalClaim.typestring

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.

Possible values

ONE_CLICK

MULTI_STEP

items[].enrollment.transactionEnrollmentProcesses.professionalClaimobject

Details about the enrollment process for professional claim submission with this payer.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.professionalClaim.typestring

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.

Possible values

ONE_CLICK

MULTI_STEP

items[].enrollment.transactionEnrollmentProcesses.unsolicitedClaimAttachmentobject

Details about the enrollment process for unsolicited claim attachments with this payer.

Show attributes

items[].enrollment.transactionEnrollmentProcesses.unsolicitedClaimAttachment.typestring

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.

Possible values

ONE_CLICK

MULTI_STEP

items[].namesarray<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.

items[].parentPayerGroupIdstring

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.

items[].primaryPayerIdstringrequired

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.

items[].stediIdstringrequired

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.

items[].transactionSupportobjectrequired

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 first.

Show attributes

items[].transactionSupport.claimPaymentstringrequired

Whether you can receive 835 Electronic Remittance Advice (ERA) transactions from this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

items[].transactionSupport.claimStatusstringrequired

Whether you can send 276 claim status requests to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

items[].transactionSupport.claimSubmissionstringrequireddeprecated

Whether you can send 837 professional claims to this payer. This shape is deprecated since 2024-11-13: This claimSubmission property is deprecated and will be removed in a future release. Instead, use the professionalClaimSubmission property.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

items[].transactionSupport.coordinationOfBenefitsstringrequired

Coordination of Benefits (COB) support.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

items[].transactionSupport.dentalClaimSubmissionstringrequired

Whether you can send 837p dental claims to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

items[].transactionSupport.eligibilityCheckstringrequired

Whether you can send 270 eligibility checks to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

items[].transactionSupport.institutionalClaimSubmissionstringrequired

Whether you can send 837i institutional claims to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

items[].transactionSupport.professionalClaimSubmissionstringrequired

Whether you can send 837p professional claims to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

items[].transactionSupport.unsolicitedClaimAttachmentstringrequired

Whether you can send unsolicited claim attachments to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

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

fetch("https://healthcare.us.stedi.com/2024-04-01/payers", {
  headers: {
    "Authorization": "<api_key>"
  }
})

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://healthcare.us.stedi.com/2024-04-01/payers"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "<api_key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

import requests

url = "https://healthcare.us.stedi.com/2024-04-01/payers"

response = requests.request("GET", url, headers = {
  "Authorization": "<api_key>"
})

print(response.text)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;

HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://healthcare.us.stedi.com/2024-04-01/payers"))
  .header("Authorization", "<api_key>")
  .GET()
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}

{
  "items": [
    {
      "aliases": [
        "1411",
        "560894904",
        "61473",
        "7472",
        "7814",
        "BCSNC",
        "NCBCBS",
        "NCPNHP",
        "SB810",
        "SB810MA"
      ],
      "coverageTypes": [
        "dental",
        "medical"
      ],
      "displayName": "Blue Cross Blue Shield of North Carolina",
      "employerIdentificationNumbers": [
        "56-0894904"
      ],
      "names": [
        "Blue Cross Blue Shield North Carolina",
        "Partners National Health Plans of North Carolina Inc"
      ],
      "parentPayerGroupId": "OVWIG",
      "primaryPayerId": "BCSNC",
      "stediId": "UPICO",
      "transactionSupport": {
        "claimPayment": "ENROLLMENT_REQUIRED",
        "claimStatus": "SUPPORTED",
        "claimSubmission": "SUPPORTED",
        "coordinationOfBenefits": "SUPPORTED",
        "dentalClaimSubmission": "SUPPORTED",
        "eligibilityCheck": "SUPPORTED",
        "institutionalClaimSubmission": "SUPPORTED",
        "professionalClaimSubmission": "SUPPORTED",
        "unsolicitedClaimAttachment": "NOT_SUPPORTED"
      }
    }
  ]
}

{
  "code": "string",
  "message": "string"
}

{
  "code": "string",
  "message": "string"
}

{
  "code": "string",
  "message": "string"
}

{
  "code": "string",
  "message": "string"
}

{
  "code": "string",
  "message": "string"
}

{
  "code": "string",
  "message": "string"
}

{
  "code": "string",
  "message": "string"
}

List Payers JSON

Authorizations

Response

List payers - JSON