Skip to main content
The Cover Whale API has two environments. Pick the one that matches your stage of integration.

​
Environments

EnvironmentBase URLWhen to use
Productionhttps://api.coverwhale.com/v1Live policies, real premiums, real binds. Use once your integration is certified.
Testhttps://api.coverwhale.dev/v1Development and integration testing. Safe to experiment — no real policies are created.
All curl examples throughout this documentation use the test base URL so you can copy, paste, and run them safely. When you’re ready to go live, switch the host from api.coverwhale.dev to api.coverwhale.com — the path, headers, and payloads are identical.

​
Credentials

Test and production use separate credentials. Request both from api-support@coverwhale.com. Production credentials are issued after your integration is reviewed against the Integration Checklist.

​
Switching between environments

Only the host changes. A request that works against test will work against production once you swap the host and use production credentials. 
# Test
curl -X POST https://api.coverwhale.dev/v1/authentication \
  -H "Content-Type: application/json" \
  -d '{"username": "test-user", "password": "test-password"}'

# Production
curl -X POST https://api.coverwhale.com/v1/authentication \
  -H "Content-Type: application/json" \
  -d '{"username": "prod-user", "password": "prod-password"}'