> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/enrichments/profile-with-company/batch-lookup.md).

# Batch Lookup

Fetch person + company for up to ten LinkedIn URLs in a single call. Returns every record inline — nothing is written to a list.

<mark style="color:green;">`POST`</mark> `/profile_with_company_bulk`

The batch counterpart of [Individual Lookup](/enrichments/profile-with-company/individual-lookup.md). Send up to 10 distinct LinkedIn profile URLs and get every person + company record back in one response. This route is synchronous — there is no list to poll and no download step.

{% hint style="info" %}
Pricing is per row and identical to calling `/profile_with_company` once per URL: **0.1 credit** for the person (**0.3** with `full_profile: true`), plus **0.1 credit** when company data comes back. Misses cost nothing.

Duplicate URLs are collapsed before billing, and people who share an employer share one company lookup.
{% endhint %}

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name                   | Type      | Description                                                                                                                |
| ---------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------- |
| `api_key`              | string    | Your API Key.                                                                                                              |
| `person_linkedin_urls` | string\[] | LinkedIn profile URLs to look up. At least 1, at most 10 distinct URLs per call. Duplicates are collapsed.                 |
| `full_profile`         | boolean   | Optional. Default `false`. Applies to every URL in the batch. `true` uses the richer full profile (0.3 credit per person). |
| `include_raw`          | boolean   | Optional. Default `false`. Asks for the provider payload alongside the normalized record.                                  |

{% hint style="warning" %}
Leave `include_raw` off unless you need it. At batch size — especially with `full_profile` — the raw payload is the main driver of response weight.
{% endhint %}

### Row statuses

Each row carries its own `status`, so one bad URL never costs you the rest of the batch.

| Status          | Meaning                                                  | Billed           |
| --------------- | -------------------------------------------------------- | ---------------- |
| `success`       | Person and company both returned.                        | Person + company |
| `person_only`   | Person returned; company missing or timed out.           | Person only      |
| `person_failed` | The provider had no data for this URL.                   | Free             |
| `not_found`     | Nothing came back for this URL. A `message` says why.    | Free             |
| `timed_out`     | The batch deadline was reached before this row finished. | Free             |

**Response**

`data` is an array with one object per unique URL you sent.

| Field                 | Type   | Description                                                                                |
| --------------------- | ------ | ------------------------------------------------------------------------------------------ |
| `person_linkedin_url` | string | The URL this row answers.                                                                  |
| `status`              | string | The row status from the table above.                                                       |
| `profile`             | object | The person. Same fields as [Profile Only](/enrichments/profile-only/individual-lookup.md). |
| `company`             | object | The company from their current position. `null` when the company could not be read.        |
| `credits_used`        | number | What this row cost.                                                                        |
| `message`             | string | Present only when the row returned nothing, saying why.                                    |

Alongside `data`, the response carries `total` (rows returned), `rows_requested` (URLs you sent) and `rows_unique` (URLs left after duplicates were collapsed).

See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "person_linkedin_urls": [
    "https://www.linkedin.com/in/williamhgates/",
    "https://www.linkedin.com/in/satyanadella/"
  ],
  "full_profile": false,
  "include_raw": false
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": [
    {
      "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
      "status": "success",
      "profile": {
        "person_name": "Bill Gates",
        "first_name": "Bill",
        "last_name": "Gates",
        "current_title": null,
        "headline": null,
        "person_linkedin_url": "https://www.linkedin.com/in/Williamhgates",
        "organization_name": "Gates Foundation",
        "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
        "city": null,
        "state": null,
        "country": null,
        "country_code": null,
        "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft…",
        "open_to_work": null,
        "follower_count": 40599152,
        "connection_count": null,
        "work_experience": [
          {
            "company_name": "Gates Foundation",
            "current_title": null,
            "location": null,
            "start_date": null,
            "end_date": null,
            "is_current": true,
            "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
            "description": null,
            "employment_type": null,
            "extra": { "company_id": "gates-foundation" }
          }
        ],
        "education_history": [
          {
            "school_name": "Harvard University",
            "degree": null,
            "field_of_study": null,
            "start_date": null,
            "end_date": null,
            "school_linkedin_url": "https://www.linkedin.com/school/harvard-university",
            "extra": { "period": "1973 - 1975" }
          }
        ],
        "skills": null,
        "profile_picture_url": null,
        "linkedin_id": "251749025",
        "extra": { "public_identifier": "williamhgates" }
      },
      "company": {
        "organization_name": "Gates Foundation",
        "company_linkedin_url": null,
        "company_website": null,
        "domain": null,
        "industry": "Non-profit Organizations",
        "industries": ["Non-profit Organizations"],
        "company_size": "1001-5000",
        "headcount": 4223,
        "headquarters": {
          "city": null,
          "state": null,
          "country": null,
          "country_code": null,
          "raw": "Seattle, WA 98109, US"
        },
        "company_description": null,
        "company_keywords": ["Global Health", "Global Development", "US Education"],
        "company_logo": null,
        "follower_count": 1523109,
        "year_founded": null,
        "organization_type": "Nonprofit",
        "linkedin_id": "gates-foundation"
      },
      "credits_used": 0.2
    }
  ],
  "total": 2,
  "rows_requested": 2,
  "rows_unique": 2,
  "credits_used": 0.4,
  "credits_remaining": 4522.3,
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

```json
{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "person_linkedin_urls: Field required"
  },
  "success": false
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
The second row is trimmed from the example above for brevity — `data` holds one object per unique URL you sent.
{% endhint %}

**Related**

* [Individual Lookup](/enrichments/profile-with-company/individual-lookup.md) — a single URL.
* [List Lookup](/enrichments/profile-with-company/list-lookup.md) — more than 10 contacts.