Getting Started

Three steps to your first authenticated request.

1. Authenticate (OAuth 2.0 client_credentials)

Provision client_id + client_secret from the SuperAdmin → API Keys panel. Exchange them for a 1-hour bearer token.

Token request
curl -X POST https://api.cubeonecare.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=cube_partner_xxx" \
  -d "client_secret=secret_xxx" \
  -d "scope=eligibility:read fhir:read"

2. Make your first request

Use the bearer token in the Authorization header. Every endpoint enforces tenant + scope on the server.

Eligibility lookup
curl -X POST https://api.cubeonecare.com/api/v1/eligibility/check \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payerId": "62308",
    "memberId": "5641296",
    "dateOfBirth": "1976-05-06",
    "providerNpi": "1999999984"
  }'

3. Respect rate limits

Default partner tier: 60 req/min, 5,000 req/day. White-label tier: 600 req/min. Burst above your quota returns HTTP 429 with a Retry-After header.

Environments

Production

api.cubeonecare.com

Sandbox

api-sandbox.cubeonecare.com

Use synthetic sandbox fixtures only. Never submit PHI to an unapproved sandbox workflow.

Support

Partner support: [email protected] · SLA 24h business days. Status page: status.cubeonecare.com.

CUBE API Developer Portal