API Keys
API keys authenticate requests to the Orca geolocation API. New keys are provisioned after an integration review.
Requesting a key
API access is included with Pro for individual development, testing, and low-volume internal use. Pro receives 25 API-only credits monthly and can add up to two 25-credit boosters; regular app credits and credit packs cannot fund API calls. For organizational, client-facing, batch, or production use, contact Oceanir with your company, use case, expected volume, and timeline. Enterprise integrations receive organization-scoped keys and contracted limits.
Important: Provisioned keys are secrets. Store the supplied key server-side and never expose it in client code.
Key limits
Each key has rate limits scoped to the approved evaluation or production integration.
| Tier | Per minute | Per hour |
|---|---|---|
| Evaluation | Scoped | Scoped |
| Production | Contracted | Contracted |
| Enterprise | 120 | 2,000 |
Revoking a key
Revoked keys are invalidated immediately. New requests will receive 401 Unauthorized.
Programmatic management
Team and enterprise plans can manage keys via the API. Contact support@oceanir.ai to enable this feature.

