> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Forager Person Detail Reverse Lookup By Email: Inputs,
> Do reverse lookup of person details by email. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=forager_person_detail_reverse_lookup_by_email:{"email":"{{email}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| --------------- | -------- | -------- | ------- | -------------------------------------------------------- |
| `payload.email` | `string` | Yes | | The personal email address of the person being searched. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Person reverse search by email request serializer.",
"properties": {
"email": {
"type": "string",
"description": "The personal email address of the person being searched.",
"format": "email"
}
},
"required": [
"email"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Person details serializer. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Person details serializer.",
"properties": {
"id": {
"type": "integer"
},
"full_name": {
"type": "string",
"maxLength": 255
},
"first_name": {
"type": "string",
"maxLength": 255
},
"last_name": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"photo": {
"type": [
"string",
"null"
],
"maxLength": 255,
"format": "uri"
},
"gender": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"headline": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"description": {
"type": [
"string",
"null"
]
},
"skills": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonSkill model.",
"properties": {
"name": {
"type": "string",
"maxLength": 255
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"location": {
"type": "object",
"description": "Serializer for the InnerLocation model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
},
"osm_locations": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the OSMLocation model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
},
"place_type": {
"type": "string",
"maxLength": 255
}
},
"required": [
"id",
"name",
"place_type"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"osm_locations"
],
"additionalProperties": false
},
"linkedin_info": {
"type": "object",
"description": "Serializer for the PersonLinkedinInfo model.",
"properties": {
"public_identifier": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"industry": {
"type": "object",
"description": "Serializer for the LinkedinIndustry document.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"public_profile_url": {
"type": "string",
"description": "Get LinkedIn public profile URL."
}
},
"required": [
"industry",
"public_profile_url"
],
"additionalProperties": false
},
"roles": {
"type": "array",
"items": {
"type": "object",
"description": "Child serializer for the OrganizationPersonRole model.",
"properties": {
"id": {
"type": "integer"
},
"role_title": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"start_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"duration": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"description": {
"type": [
"string",
"null"
]
},
"is_current": {
"type": "boolean"
},
"organization": {
"type": "object",
"description": "Short serializer for the Organization model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
},
"domain": {
"type": [
"string",
"null"
],
"maxLength": 200,
"format": "uri"
},
"linkedin_info": {
"type": "object",
"description": "Serializer for the OrganizationLinkedinInfo model.",
"properties": {
"public_identifier": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"industry": {
"type": "object",
"description": "Serializer for the LinkedinIndustry document.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"public_profile_url": {
"type": [
"string",
"null"
],
"description": "Get LinkedIn public profile URL."
}
},
"required": [
"industry",
"public_profile_url"
],
"additionalProperties": false
}
},
"required": [
"id",
"linkedin_info",
"name"
],
"additionalProperties": false
},
"organization_name": {
"type": [
"string",
"null"
],
"maxLength": 255
}
},
"required": [
"id",
"is_current",
"organization"
],
"additionalProperties": false
}
},
"educations": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonEducation model.",
"properties": {
"id": {
"type": "integer"
},
"school_name": {
"type": "string",
"maxLength": 255
},
"organization": {
"type": "object",
"description": "Short serializer for the Organization model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
},
"domain": {
"type": [
"string",
"null"
],
"maxLength": 200,
"format": "uri"
},
"linkedin_info": {
"type": "object",
"description": "Serializer for the OrganizationLinkedinInfo model.",
"properties": {
"public_identifier": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"industry": {
"type": "object",
"description": "Serializer for the LinkedinIndustry document.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"public_profile_url": {
"type": [
"string",
"null"
],
"description": "Get LinkedIn public profile URL."
}
},
"required": [
"industry",
"public_profile_url"
],
"additionalProperties": false
}
},
"required": [
"id",
"linkedin_info",
"name"
],
"additionalProperties": false
},
"description": {
"type": [
"string",
"null"
]
},
"grade": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"degree": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"activities": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"field_of_study": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"start_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date"
}
},
"required": [
"id",
"organization",
"school_name"
],
"additionalProperties": false
}
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonCertification model.",
"properties": {
"id": {
"type": "integer"
},
"organization_id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string",
"maxLength": 510
},
"certificate_id": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"url": {
"type": [
"string",
"null"
],
"maxLength": 16384,
"format": "uri"
},
"authority": {
"type": [
"string",
"null"
],
"maxLength": 255
}
},
"required": [
"id",
"name",
"organization_id"
],
"additionalProperties": false
}
},
"courses": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonCourse model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 1515
},
"number": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"associated_role_id": {
"type": [
"integer",
"null"
]
},
"associated_education_id": {
"type": [
"integer",
"null"
]
}
},
"required": [
"associated_education_id",
"associated_role_id",
"id",
"name"
],
"additionalProperties": false
}
},
"honors": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonHonor model.",
"properties": {
"id": {
"type": "integer"
},
"title": {
"type": "string",
"maxLength": 510
},
"description": {
"type": [
"string",
"null"
]
},
"issuer": {
"type": [
"string",
"null"
]
},
"issued_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"associated_role_id": {
"type": [
"integer",
"null"
]
},
"associated_education_id": {
"type": [
"integer",
"null"
]
}
},
"required": [
"associated_education_id",
"associated_role_id",
"id",
"title"
],
"additionalProperties": false
}
},
"languages": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonLanguage model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
},
"proficiency": {
"type": [
"string",
"null"
],
"maxLength": 255
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"organizations": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonOrganization model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 510
},
"description": {
"type": [
"string",
"null"
]
},
"role_title": {
"type": [
"string",
"null"
],
"maxLength": 1515
},
"associated_role_id": {
"type": [
"integer",
"null"
]
},
"associated_education_id": {
"type": [
"integer",
"null"
]
}
},
"required": [
"associated_education_id",
"associated_role_id",
"id",
"name"
],
"additionalProperties": false
}
},
"patents": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonPatent model.",
"properties": {
"id": {
"type": "integer"
},
"title": {
"type": "string",
"maxLength": 510
},
"description": {
"type": [
"string",
"null"
]
},
"patent_number": {
"type": [
"string",
"null"
],
"maxLength": 125
},
"application_number": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"is_pending": {
"type": "boolean"
},
"url": {
"type": [
"string",
"null"
],
"maxLength": 16384,
"format": "uri"
},
"issued_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"filled_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"linkedin_inventors_ids": {
"type": "array",
"description": "Get list of ids of persons who authored this patent.",
"items": {
"type": "integer"
}
},
"non_linkedin_inventors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 255
}
}
},
"required": [
"id",
"is_pending",
"linkedin_inventors_ids",
"title"
],
"additionalProperties": false
}
},
"publications": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonPublication model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 510
},
"description": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
],
"maxLength": 16384,
"format": "uri"
},
"publisher": {
"type": [
"string",
"null"
],
"maxLength": 510
},
"published_in": {
"type": [
"string",
"null"
],
"format": "date"
},
"linkedin_authors_ids": {
"type": "array",
"description": "Get list of ids of persons who authored this publication.",
"items": {
"type": "integer"
}
},
"non_linkedin_authors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 255
}
}
},
"required": [
"id",
"linkedin_authors_ids",
"name"
],
"additionalProperties": false
}
},
"test_scores": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonTestScore model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 510
},
"description": {
"type": [
"string",
"null"
]
},
"score": {
"type": [
"string",
"null"
],
"maxLength": 65
},
"date_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"associated_role_id": {
"type": [
"integer",
"null"
]
},
"associated_education_id": {
"type": [
"integer",
"null"
]
}
},
"required": [
"associated_education_id",
"associated_role_id",
"id",
"name"
],
"additionalProperties": false
}
},
"projects": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonProject model.",
"properties": {
"id": {
"type": "integer"
},
"title": {
"type": "string",
"maxLength": 510
},
"url": {
"type": [
"string",
"null"
],
"maxLength": 16384,
"format": "uri"
},
"description": {
"type": [
"string",
"null"
]
},
"start_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"associated_role_id": {
"type": [
"integer",
"null"
]
},
"associated_education_id": {
"type": [
"integer",
"null"
]
},
"linkedin_contributors_ids": {
"type": "array",
"description": "Get list of ids of persons who contributed to this project.",
"items": {
"type": "integer"
}
},
"non_linkedin_contributors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 255
}
}
},
"required": [
"associated_education_id",
"associated_role_id",
"id",
"linkedin_contributors_ids",
"title"
],
"additionalProperties": false
}
},
"volunteering": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the PersonVolunteering model.",
"properties": {
"id": {
"type": "integer"
},
"title": {
"type": "string",
"maxLength": 255
},
"description": {
"type": [
"string",
"null"
]
},
"cause": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"organization_name": {
"type": "string",
"maxLength": 255
},
"organization_id": {
"type": [
"integer",
"null"
]
},
"start_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date"
}
},
"required": [
"id",
"organization_id",
"organization_name",
"title"
],
"additionalProperties": false
}
}
},
"required": [
"certifications",
"courses",
"educations",
"first_name",
"full_name",
"honors",
"id",
"languages",
"linkedin_info",
"location",
"organizations",
"patents",
"projects",
"publications",
"roles",
"skills",
"test_scores",
"volunteering"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute forager_person_detail_reverse_lookup_by_email --payload '{
"email": "string"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `1.56` per pricing unit.
* Billing mode: `post_deduct`.