Use the Try It Interface

📘

BEARER TOKEN LIFESPAN

The lifespan of a Bearer token is one hour (3600 seconds) for both sandbox and production environments.

Interactive Try It interface

Use the API reference's Try It interface as shown below by using our sandbox predefined values to familiarize yourself with our APIs.

1. For example, to generate a Bearer token, click API Tools in the developer portal.
2. Click /apip/auth/v2/token.
3. Use your sandbox client Id and client secret in their respective fields, and use client_credentials in the grant_type field and click Try It.

curl --request POST \
     --url https://sandbox-apigw.optum.com/apip/auth/v2/token \
     --header 'accept: */*' \
     --header 'content-type: application/json' \
     --data '
{
  "client_id": "your client ID",
  "client_secret": "your secret",
  "grant_type": "client_credentials"
}'

API Healthcheck

1. Use the following curl request to check the API status.

curl --request GET \
     --url https://sandbox-apigw.optum.com/medicalnetwork/eligibility/v3/healthcheck \
     --header 'Authorization: Bearer eyJraWQiOiIxIiwidHl... \
     --header 'accept: */*'

3. Enter your Bearer token in the Authorization box exactly as shown in the example above and in the image below.

If the API engine is working correctly and if the entry points are accessible, the API operating status response shows OK with the active product version.

👍

IMPORTANT

For sandbox usage, all fields must have the correct predefined values to obtain a successful response. Inventing new PMI values or using real-world PMI values will result in errors. Please provide all of the values, such as tradingPartnerServiceId, controlNumber, subscriber, and so on marked as required (R) (see example) in your API requests.

Related Topics

• API URLs and Endpoints
• API environments
• API FAQs
• sandbox predefined fields and values
• JSON-to-EDI API mapping