Getting Started

Create an account

Create a free account with your user name and password

Create Account

Browse our APIs

Browse our catalog of APIs to see what we have available.

API Catalog

Create your App

When you've found an API you'd like to integrate with, click 'Request Access' and create your app before selecting the API.

*** Note: Mock endpoints are available for you to use. However, before you can consume Non-Prod and Prod endpoints, you'll need to become an approved vendor with a contract on file containing a BAA and an ISA


API Documentation

Humana offers a variety of Application Programming Interfaces (APIs) to help you make data more manageable, accessible and valuable for clients and consumers. This list will continue to grow as more APIs become available.

Being RESTful

Humana APIs follow the Representational state transfer (REST) format allowing resources (accounts, client, etc) to be standardized with a uniform set of GET, POST, PUT, DELETE HTTP requests. Communication with Humana follows the REST architecture constraints including being stateless & cacheable. All responses are returned as JSON objects.

Swagger

Swagger is used to describe and document RESTful APIs. More information can be found at Swagger.IO

FHIR

Fast Healthcare Interoperability Resources is a standard for data formats for application programming interfaces for exchanging health information. More information can be found at HL7.org/FHIR

Endpoints

Humana is a multi_tenated environment with all tenants having access at their own sub_domain. To make a request to a tenant use the pattern ?.humana.com/api/.

Posting data

API requests which post data can either use url_encoding or json to enter data. The content_type header must be set to "application/json" for the json request. The following two example shows the two methods for posting data. Note that for some requests, much more information can be posted using the json input that is available with url_encoding but all url_encoded requests are supported with their json equivalents.