Director Contact API
DIN → director basics, current/past companies, and one phone + one email — 30 credits only when phone exists.
Overview
The Director Contact API returns a director's profile from Director_Profile by DIN: basic details, current and past companies with designation, plus one contact phone and one email. A usable phone is required — if phone is missing you get NOT_FOUND and are not charged. When phone is present, the call costs 30 credits (email may be null). Does not return PAN, DOB or full address.
- Director basics from DIN
- One phone (required) and one email (optional)
- Current and past companies with designation
- 30 credits only when phone is returned
- No charge when phone is unavailable
Auth, limits & freshness
- Auth: Send Authorization: Bearer <api_key> (pk_test_… or pk_live_…).
- Rate / credits: Fair-use and plan limits apply; see your API console for remaining credits.
- Freshness: Sourced from Infyner’s MCA-aligned company master; refresh cadence varies by dataset.
- Errors: Errors return a JSON envelope with success=false and an error code (e.g. NOT_FOUND, UNAUTHORIZED).
How it works
- Generate an API key in your developer console (test keys are free).
- Call the endpoint with your Bearer key.
- Read the JSON response (standard envelope with credits info).
- Map the fields into your product or workflow.
Request & response
Try it live with a free test key from your sandbox.
Where it's used
- Outreach and lead enrichment
- Director KYC with contact
- Due diligence contact discovery
- CRM enrichment from DIN
Frequently asked questions
When am I charged?
30 credits only on a successful response when a usable phone exists. Missing director or missing phone returns NOT_FOUND with no charge.
What if email is missing?
Email may be null. As long as phone is present, the call succeeds and is charged.
Does Director Lookup also return phone?
No. DIRECTOR_LOOKUP and DIRECTOR_COMPANIES never return contact fields — use this endpoint for phone/email.
Start building in minutes
Generate a free test key, call the sandbox, and go live when you're ready.
Get API access