Enrichment

Submit a phone enrichment request

Look up a prospect's direct business phone number using their name, company, and optionally their LinkedIn profile — enabling warm outreach and contact validation for B2B sales and recruiting.

Input: firstName, lastName, company (required); linkedinUrl, email (optional — significantly improve hit rate when provided); webhookUrl (optional — for async delivery).

Output: An E.164-formatted phone number (if found) returned via polling GET /api/v1/enrichment/phone/{enrichmentId} or POSTed to your webhookUrl once lookup completes (typically 30s–5min). Response includes status (pending, completed, or failed), phone (null if not found), and creditsCharged (5 on success, 0 otherwise). Job state retained for 1 hour after submission.

post/api/v1/enrichment/phone

Request

Base URL: https://api.rodz.io (the document declares no server; this is the origin it was published from)
URL: https://api.rodz.io/api/v1/enrichment/phone
Auth: HTTP bearer

Request body

firstNamestring required

lastNamestring required

companystring required

Company name or domain

linkedinUrlstring nullable

LinkedIn profile URL — significantly improves accuracy when provided

emailstring nullable

Known email address — improves matching

webhookUrlstring nullable

Optional webhook to receive the result. POSTed once when the job completes (success OR failure). Customers can also poll the GET endpoint instead.

Example request

{
  "company": "Acme Corp",
  "email": "marie.dupont@acme.com",
  "firstName": "Marie",
  "lastName": "Dupont",
  "linkedinUrl": "https://linkedin.com/in/marie-dupont",
  "webhookUrl": "https://your-server.com/webhooks/phone"
}

Response

Successful Response

enrichmentIdstring required

statusstring required

One of: pending, completed, failed

phonestring nullable

E.164 phone number; null if not found

creditsChargedinteger

Credits deducted (5 on success, 0 otherwise)

errorstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.