Reference

API Documentation

A single endpoint. Five identifiers. Exact-match lookup over our indexed 300M-record B2B contact database. You pay 1 credit for every email returned and 4 credits for every mobile number returned; all other fields are free (N/A when unavailable). Not found = free.

Authentication

All requests use Bearer tokens in the Authorization header. Create keys from your dashboard; the full key is shown once at creation.

Authorization: Bearer dpp_live_YOUR_API_KEY

POST /v1/enrich

Supply exactly one identifier.

curl -X POST https://trevon.io/api/v1/enrich \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"aarav.sharma@acmeanalytics.com"}'

Mobile (E.164 or raw + country)

curl -X POST https://trevon.io/api/v1/enrich \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"mobile":"9876543210","country_code":"IN"}'

LinkedIn / Facebook / Twitter URL

{"linkedin_url":"https://linkedin.com/in/handle"}
{"facebook_url":"https://facebook.com/handle"}
{"twitter_url":"https://twitter.com/handle"}

Successful response (200)

{
  "match": true,
  "identifier_type": "email",
  "credits_used": 5,
  "data": {
    "name": "Aarav Sharma",
    "email": "aarav.sharma@acmeanalytics.com",
    "mobile": "+919876543210",
    "company": "Acme Analytics",
    "title": "Head of Growth",
    "linkedin_url": "https://linkedin.com/in/..."
  }
}

Response codes & billing

Code	Meaning	Credits
200	Match found — record returned.	−1
404	No match found.	0
400	Bad input or ambiguous phone (missing country_code).	0
401	Missing or invalid API key.	0
402	Insufficient credits.	0
429	Rate limit exceeded (default 10 rps/key).	0
5xx	Server/DB error.	0

Normalization rules

• Email — trimmed + lowercased. Dots and plus-addressing preserved.
• Mobile — normalized to E.164 via phonenumbers. Non-E.164 inputs require country_code (ISO-2).
• Social URLs — host lowercased, trailing slash stripped, query/fragment removed. No fuzzy matching.
• Data is returned from a single matched record. We never merge fields across records.