Authentication
PrimoDato uses API keys to authenticate requests.
Getting Your API Key
- Log in to your PrimoDato account at app.primodato.com
- Navigate to Settings -> API Keys
- Click Create new API key
- Give your key a name such as Production or Development
- Copy your key immediately. It is shown only once.
Using Your API Key
Pass your API key in the Authorization header as a Bearer token. Never expose your API key in client-side code, public repositories, or frontend applications. Use environment variables to store it securely.
Authorization: Bearer db_live_xxxxxxxxxxxxxxxxxxxx| Key Type | Prefix | Usage |
|---|---|---|
| Live keys | db_live_ | Production use. Deducts real credits. |
| Test keys | db_test_ | Development use. Returns mock data and spends no credits. |
Key Scopes
- read:companies - Search and retrieve company data
- read:contacts - Search and retrieve contact data
- write:reveals - Unlock company and contact profiles
- write:exports - Create and download exports
- read:account - Check balance and transaction history
curl https://api.primodato.com/v1/companies \
-H "Authorization: Bearer db_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json"