Your account and data
Create, store and revoke API keys
How to create an API key, where to keep it and what to do if it leaks.
Create a key
- Open API keys in the dashboard.
- Choose to create a key and name it after the application that will use it.
- Copy the key right away. It is shown once and cannot be recovered.
Use it
Send the key as a bearer token. Keys begin with lv_live_.
curl -X POST https://YOUR_API_HOST/v1/phone \
-H "Authorization: Bearer $LOOKVALID_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+14155552671"}'
Sending a key in a request
Keep it safe
- Keep keys in environment variables or a secret manager, never in source control or browser code.
- Use one key per application so you can revoke one without touching the others.
- If a key leaks, revoke it in the dashboard. A revoked key stops working on the next request.
Stored as a hash
We store only a hash and a short prefix of each key, so we cannot show you a key again.
Related
Still stuck? Write to hello@lookvalid.com.