Skip to main content

Base URL

Production: https://api.penelope.health Sandbox: https://api-sandbox.penelope.health

Pagination

All list endpoints return 20 results by default, configurable up to 100 via the limit parameter.

Sandbox payers

The sandbox serves a fixed subset of payers: UnitedHealthcare, Humana, Aetna, Cigna, Anthem Blue Cross and Blue Shield Virginia, Centene (Medical), and Medicare (every MAC jurisdiction, Part A and Part B). Payers, lines of business, policies, and policy updates outside this set are not available in the sandbox, and a policy’s applicability lists only these payers. Production serves the full corpus.

Date & Time Formats

  • Dates: ISO 8601 date format (YYYY-MM-DD)
    • Example: 2025-01-07
  • Timestamps: ISO 8601 datetime format with UTC timezone (YYYY-MM-DDTHH:MM:SSZ)
    • Example: 2025-01-07T14:32:15Z

Rate Limits

Sandbox endpoints are rate-limited to 100 requests per minute per API key. When exceeded, the API returns a 429 Too Many Requests response with a Retry-After header.