docs
Leads

Get a revealed lead

GET
/v1/leads/{id}

Returns one lead your workspace has revealed. Free.

Authorization

bearerAuth
headerAuthorizationBearer <API key>

Create a key in the app under Developers. Keys start with dcd_live_.

Path Parameters

id*string

Lead id. Starts with lead_.

Match^lead_

Response Body

Success.

application/json
  1. response

A revealed lead with every available field.

id*string

Lead id. Starts with lead_.

Match^lead_
first_name*|

First name.

last_name*|

Last name.

email*|

Primary personal email address.

emails*array<string>

All known email addresses, including the primary one.

business_email*|

Work email address.

phone*|

Personal phone number.

mobile_phone*|

Mobile phone number.

direct_phone*|

Direct work phone number.

linkedin_url*|

LinkedIn profile URL.

address*

Home address.

demographics*

Who the person is.

job*

What the person does.

company*

Where the person works.

intent*|null
household*|

Extra household details from an enrichment lookup, such as home value. Null when there are none.

updated_at*|

When this lead's data was last updated, as an ISO 8601 timestamp.

request_id*string

Id of the request that produced this response. A replayed idempotent response keeps the original id.

Example Request
curl -X GET 'https://api.diced.si/v1/leads/lead_3kPq8ZrT1mXv6NbW2sLc9GhY' \  -H 'Authorization: Bearer dcd_live_your_key'
Example Response
{  "id": "string",  "first_name": "string",  "last_name": "string",  "email": "string",  "emails": [    "string"  ],  "business_email": "string",  "phone": "string",  "mobile_phone": "string",  "direct_phone": "string",  "linkedin_url": "string",  "address": {    "line1": "string",    "line2": "string",    "city": "string",    "state": "string",    "zip": "string",    "country": "string"  },  "demographics": {    "gender": "male",    "age_range": "18-24",    "married": true,    "children": true,    "income_range": "<20k",    "net_worth": "<0",    "homeowner": true  },  "job": {    "title": "string",    "seniority": "c_suite",    "department": "administrative"  },  "company": {    "name": "string",    "domain": "string",    "phone": "string",    "industry": "string",    "size": "1-10",    "revenue": "<1m",    "sic": "string",    "naics": "string",    "city": "string",    "state": "string",    "country": "string"  },  "intent": {    "level": "high",    "topic": {      "id": "string",      "name": "string",      "category": "string"    },    "last_active": "string"  },  "household": {    "property1": "string",    "property2": "string"  },  "updated_at": "string",  "request_id": "string"}