Generate an API Token
BEARER TOKEN LIFESPAN
The lifespan of a Bearer token is one hour (3600 seconds) for both sandbox and production environments.
We recommend automating transactions to use the tokens generated over the token lifespan. Obtaining tokens for each transaction is less efficient and does not improve the security criteria for any transactions.
Bearer token request header
Content-Type: application/json
Authorization: Bearer <Your-Access-Token>
Bearer token request
Please see Bearer Token Request & Response examples.
Bearer token response
To test API in your sandbox, use your client_id and client_secret to get your token. If you do not have your credentials, reach out to your account manager or contact in Optum.
Please see Bearer Token Request & Response examples.
NOTE
When you are ready to move from sandbox to production, replace the sandbox authorization URL with the production URL:
https://sandbox-apigw.optum.com/apip/auth/v2/token
Production API credentials
You will need a separate set of credentials for the production APIs. For more information, see API Onboarding.
You can use your bearer token to call all your contracted Optum APIs with these HTTP headers:
- Content-Type: application/json
- Authorization: Bearer
Legacy Authorization
For more information about the legacy Authorization APIs implementation:
Updated about 1 month ago