# apollo.people.enrich.bulk

Up to 10 people's titles, work emails from emails or names

> Use the bulk people enrichment endpoint to enrich data for up to ten people with a single API call.

Page: https://telipot.com/catalog/tasks/apollo.people.enrich.bulk · Markdown: https://telipot.com/catalog/tasks/apollo.people.enrich.bulk/md · JSON: https://telipot.com/catalog/tasks/apollo.people.enrich.bulk/json

| Field | Value |
| --- | --- |
| provider | [Apollo](https://telipot.com/catalog/providers/apollo) `apollo` |
| capability | [`people.enrich.bulk`](https://telipot.com/catalog/capabilities/people.enrich.bulk) |
| kind | data |
| tier | core |
| price | $0.0196 / result (1 credit · docs) |
| settles on | The charge Apollo reports in credits_consumed |
| price note | 1 credit per person when credit-consuming data (demographics or email) is found, 0 for an unmatched person. The docs give 1-9 credits per person: +8 when a mobile phone is returned, and waterfall enrichment costs more. This task sends no phone, personal-email or waterfall option, so it is priced at the 1-credit base per person. credits_consumed reports what the call used and can be a decimal. |
| identity | Your plan |
| auth | `api_key · in header as x-api-key` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `POST https://api.apollo.io/api/v1/people/bulk_match` |
| verification | Untestable. Needs specific people and answers with their profiles and work emails; a contact lookup, so it has no test request. |
| status | live |
| docs | https://docs.apollo.io/reference/bulk-people-enrichment |

## Preview the price · nothing runs

```bash
telipot run apollo.people.enrich.bulk \
  --input-json '{"details":"<details>"}' \
  --quote
```

## Run it

```bash
telipot run apollo.people.enrich.bulk \
  --input-json '{"details":"<details>"}'
```

```bash
curl https://api.telipot.com/v1/tasks/apollo.people.enrich.bulk/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"details":"<details>"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `details` | body | array | yes | 1 to 10 | One object per person, up to 10, each with any of first_name, last_name, name, email, hashed_email, organization_name, domain, id, linkedin_url. More fields improve the match; a name without a domain or email may match nothing. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "details": {
      "type": "array",
      "description": "One object per person, up to 10, each with any of first_name, last_name, name, email, hashed_email, organization_name, domain, id, linkedin_url. More fields improve the match; a name without a domain or email may match nothing.",
      "minItems": 1,
      "maxItems": 10
    }
  },
  "required": [
    "details"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "status",
    "total_requested_enrichments"
  ],
  "properties": {
    "request_id": {
      "type": "integer",
      "description": "A signed 64-bit integer that may be negative."
    },
    "status": {
      "type": "string",
      "description": "success for any 200 response, even when not every person matched."
    },
    "error_code": {
      "type": [
        "string",
        "null"
      ]
    },
    "error_message": {
      "type": [
        "string",
        "null"
      ]
    },
    "total_requested_enrichments": {
      "type": "integer",
      "description": "The number of objects sent in details. Always returned."
    },
    "unique_enriched_records": {
      "type": "integer",
      "description": "Distinct people whose enrichment consumed credits; a billing count, not a match count."
    },
    "missing_records": {
      "type": "integer",
      "description": "Entries in details that Apollo could not match."
    },
    "credits_consumed": {
      "type": "number",
      "description": "Credits the request consumed; can be a decimal."
    },
    "matches": {
      "type": "array",
      "items": {
        "type": [
          "object",
          "null"
        ],
        "description": "One entry per person; an unmatched person is null.",
        "properties": {
          "id": {
            "type": "string"
          },
          "first_name": {
            "type": "string"
          },
          "last_name": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "linkedin_url": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "headline": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "email_status": {
            "type": "string"
          },
          "organization_id": {
            "type": "string"
          },
          "match_confidence": {
            "type": "string",
            "enum": [
              "high",
              "medium",
              "low",
              "none"
            ]
          },
          "employment_history": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "organization_id": {
                  "type": "string"
                },
                "organization_name": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "start_date": {
                  "type": "string"
                },
                "current": {
                  "type": "boolean"
                }
              }
            }
          },
          "state": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "seniority": {
            "type": "string"
          },
          "departments": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "functions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "organization": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "website_url": {
                "type": "string"
              },
              "primary_domain": {
                "type": "string"
              },
              "industry": {
                "type": "string"
              },
              "estimated_num_employees": {
                "type": "integer"
              }
            }
          }
        }
      }
    }
  }
}
```