FAQ

Find the answers to common questions here.

Getting Started
API Related
Patient Access API
Provider Directory API
Payer-to-Payer API
Provider Access API
Prior Authorization API
Brokerage Agency
Contact Details
About CareFirst

Getting Started

Who is eligible to register a company account?

Any authorized representative of a company can register a company account. The representative should have the authority to act on behalf of the company.

What information do I need to prepare before registering as a company account?

Company Information:

  • Company Legal Name:
  • Company Email Domain:
  • Company ID/EIN:
  • Company Address:
  • Phone:
  • Company Website:
  • Customer Service Email:
  • Customer Service Phone:

Primary Contact Information:

  • Name:
  • Company Email: Official company email address of the primary contact, using the company email domain.
  • Company Phone Number:
  • Designation:

Secondary Contact Information:

  • Name:
  • Company Email: Official company email address of the secondary contact, using the company email domain.
  • Company Phone Number:
  • Designation:

Account Email:
An email address matching the company email domain, used to log in to the API Marketplace. A distribution list (DL) is recommended for continuity of access and account management.

Who should be the point of contact for customer service?

The point of contact for customer service should be a support email distribution list (DL) that includes the email addresses of technical personnel. In addition, a primary authorized individual should be identified who can provide the technical support email address and phone number for any technical conversations between CareFirst and the company. This setup ensures that all technical inquiries are handled efficiently and by the appropriate personnel.

Why is the company email domain required for company account registration?

The company email domain is essential for account registration for several reasons. We use the company email domain to ensure that all business communication is conducted using this domain and not personal email addresses such as Gmail, Yahoo, etc. All email addresses are validated to use this domain.

How do I register as a developer with the CareFirst API Marketplace?

To register as a developer with the CareFirst API Marketplace, click the "Register" link in the top menu of this portal. You will be asked to provide your email address, phone number, and other required details during registration. After completing the process, you can log in and access developer features on the portal. See the Register as a Developer section in Documentation for more information.

Learn more about the registration process.

Why am I not receiving a verification code through the email distribution list (DL)?

There could be several reasons why you are not receiving a verification code through the email distribution list (DL):

  • Email filtering: The email containing the verification code might be filtered out by your email system's spam or junk filters. Ensure that the email address sending the verification code is added to your safe sender list.
  • DL configuration: The distribution list might not be configured to receive external emails. Check with your IT department to ensure that the DL is set up to accept emails from external sources.
  • Email address validation: Ensure that all email addresses in the DL are validated and correctly configured to receive emails. Sometimes, issues with individual email addresses within the DL can cause delivery failures.

If you continue to experience issues, it might be helpful to contact your IT support team for further assistance.

What can I access when I have registered as a developer?

Once you have registered as a developer, you will be able to browse the API Catalog for a list of APIs available to you. You can create applications in the Manage Applications section to subscribe to those APIs and view credentials for each application within the Manage Applications page for the respective environment. See the application registration and credential management sections in Documentation.

What information do I need to supply in order to submit my application?

See the Register Your Application section in Documentation.

Where do I go to request API credentials?

To request API credentials, log in to the API Marketplace and go to the Manage Applications section. Create a new application and add the respective APIs to your application. Once your application is approved, you can get the credentials by clicking "Manage Credentials" to view your subscription key, client ID, and secret. Credentials are only usable after your application is approved.

API Related

Which interoperability APIs does CareFirst make available through the API Marketplace?

CareFirst supports five core interoperability APIs:

APIs introduced under CMS-9115-F:

  • Patient Access API
  • Provider Directory API
  • Payer-to-Payer API

APIs introduced under CMS-0057-F:

  • Provider Access API
  • Prior Authorization API

Note: CMS-0057-F expands the Patient Access and Payer-to-Payer APIs to include certain prior authorization information, where applicable to the plan. Plans marked with an asterisk (*) in the CMS API availability matrix are limited to CMS-9115-F requirements; the CMS-0057-F enhancements do not apply to those plans.

What APIs can I subscribe to for my application?

There are various APIs that your application can subscribe to. To view the available APIs, please visit the API Catalog page after logging in.

How do I get my application approved?

To get your application approved, you need to submit a request through the Contact Us form with the subject "Application Approval Request."

What is the difference between Interop 1.0 and Interop 2.0?

Interop 1.0 uses line-of-business (LOB)-specific endpoints and continues to be supported. Interop 2.0 uses shared environment hosts and is documented as available after January 1, 2027. These are platform version labels, not FHIR release labels, and do not mean every API is available to every plan.

Are all interoperability APIs available for every CareFirst plan?

No. Availability depends on the API, line of business, applicable mandate, and documented limitations. Consult the CMS and BCBSA API availability matrices for applicability: Yes indicates applicability for the listed API and LOB, subject to limitations; NA means not applicable.

How do the CMS and BCBSA interoperability requirements relate to API availability?

CMS-9115-F and CMS-0057-F define federal interoperability requirements. CareFirst documents BCBSA Inter-Plan Program (IPP) availability separately for Provider Access and Prior Authorization across additional LOBs.

Where can I find API base URLs and OAuth configuration?

See the Base URL section in Documentation for interoperable API hosts, paths, and OAuth Authorization Code endpoints. For client credentials gateway configuration, see the External Developers or Internal Developers section under Non-Interoperable APIs. Select the appropriate environment and LOB, and do not mix sandbox and production settings.

Where can I find sandbox test users for the Patient Access API?

See the Sandbox Test Credentials section in Documentation. These test-user credentials are for member sign-in during sandbox testing, not your application's client ID or secret, and are not production member accounts.

Does seeing an API in an availability matrix mean my application is approved to use it?

No. The matrix describes plan applicability, not application approval. For APIs requiring authorization, complete the applicable application onboarding, API subscription, approval, and credential requirements. The Provider Directory API is public and does not require member authorization.

Patient Access API

What is the Patient Access API?

The Patient Access API enables authorized third-party applications to access healthcare information on behalf of a CareFirst member who has granted permission.

What data is available through the Patient Access API?

Available data (subject to applicable regulatory requirements) may include:

  • Claims and encounters
  • Coverage information
  • Clinical data
  • Care team information
  • Formulary information
  • Prior authorization information
Which implementation guides are supported by the Patient Access API?

The Patient Access API aligns with applicable CARIN Blue Button, US Core, and PDex implementation guides.

Provider Directory API

What is the Provider Directory API?

The Provider Directory API provides access to CareFirst provider network information using FHIR-based standards.

Does the Provider Directory API require member authorization?

No. The Provider Directory API is publicly accessible and does not require member authorization.

Which implementation guide is supported by the Provider Directory API?

The Provider Directory API aligns with the HL7 Da Vinci Plan-Net Implementation Guide.

Payer-to-Payer API

What is the Payer-to-Payer API?

The Payer-to-Payer API supports the exchange of member healthcare information between health plans using standards-based interoperability frameworks.

Which implementation guide is supported by the Payer-to-Payer API?

The Payer-to-Payer API aligns with applicable HL7 PDex Payer-to-Payer implementation guidance.

Who can access the Payer-to-Payer API?

The API is intended for authorized payer organizations that have completed CareFirst onboarding and approval requirements.

Provider Access API

What is the Provider Access API?

The Provider Access API enables authorized provider organizations to access patient information maintained by CareFirst for treatment, care coordination, and healthcare operations as permitted by applicable regulations.

Who can integrate with the Provider Access API?

The Provider Access API is intended for contracted CareFirst providers, including provider organizations, health systems, EHR vendors, and other authorized healthcare technology partners approved by CareFirst.

What data is available through the Provider Access API?

Available data (subject to applicable regulatory requirements) may include:

  • Claims and encounter data
  • Clinical information
  • Care team information
  • Prior authorization information

Prior Authorization API

What is the Prior Authorization API?

The Prior Authorization API supports electronic prior authorization workflows using industry-standard FHIR-based APIs.

What prior authorization capabilities are supported?

Supported capabilities may include:

  • Prior authorization request submission
  • Prior authorization status inquiry
  • Prior authorization determination retrieval
Which implementation guides are supported by the Prior Authorization API?

CareFirst's Prior Authorization API strategy aligns with applicable HL7 Da Vinci implementation guides, including:

  • Coverage Requirements Discovery (CRD)
  • Documentation Templates and Rules (DTR)
  • Prior Authorization Support (PAS)
Does CareFirst support electronic prior authorization attachments?

Supported attachment capabilities, formats, and submission requirements are documented within the Prior Authorization API specifications.

What are CRD, DTR, PAS, and Subscription and Notification used for?

CRD discovers coverage and prior authorization requirements. DTR collects required documentation through questionnaires and rules. PAS submits and queries prior authorization requests. Subscription and Notification (SN) provides subscription notifications when a request's status changes. Consult the published API contract for supported operations and access requirements; availability is not universal.

Brokerage Agency

Which developer type should I choose to register my Brokerage Agency company account?

To register your Brokerage Agency company account, you should choose the "Healthcare Broker Developer" option. This type is appropriate if your main focus is on health insurance brokerage services, as it enables you to manage and integrate various brokerage-related functionalities seamlessly.

Contact Details

I'm not getting the necessary response. Who do I contact?

If you are not getting the necessary response, please send an email to DeveloperPortalSupport@carefirst.com with details about your concern.

About CareFirst

Where can I find more information about CareFirst BlueCross BlueShield?

You can find more information about CareFirst BlueCross BlueShield on the official website: www.carefirst.com