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 thelimit 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’sapplicability lists only these payers. Production serves the full corpus.
Date & Time Formats
- Dates: ISO 8601 date format (
YYYY-MM-DD)- Example:
2025-01-07
- Example:
- Timestamps: ISO 8601 datetime format with UTC timezone (
YYYY-MM-DDTHH:MM:SSZ)- Example:
2025-01-07T14:32:15Z
- Example:
Rate Limits
Sandbox endpoints are rate-limited to 100 requests per minute per API key. When exceeded, the API returns a429 Too Many Requests response with a Retry-After header.