Getting started
From signup to your first successful response in about two minutes.
1. Create an account
New accounts start with free balance, so you can make real calls before paying anything. No card is required.
2. Create an API key
In your dashboard, open API keys and create one. The key is shown once — it is stored as a hash, so we cannot show it to you again. Store it in your secret manager.
3. Make a request
Every endpoint is a GET with query parameters and one header.
curl 'https://api.enricho.io/v1/profile?publicIdentifier=williamhgates' \
-H 'X-API-Key: YOUR_API_KEY'
4. Read the cost headers
Every response carries three headers worth wiring into your client:
X-Request-Cost— what this call cost, in USD to six decimalsX-Balance-Remaining— what is left afterwardsX-RateLimit-Concurrency— how many requests you may have in flight
Those let you meter your own spend without a second API call, which is the main thing we would change about how most APIs in this category report usage.
5. Handle the failure cases
Three are worth handling explicitly from day one: 402 when the balance runs out, 429 when you exceed concurrency, and 502 when the source is unreachable. None of them are charged. See errors.