> 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/individual-lookup.md).

# Individual Lookup

Fetch a LinkedIn profile plus the person's current company in one call.

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

{% hint style="info" %}
Profile with Company costs **0.2 credit** per call (5 profiles + companies for 1 credit). Set `full_profile` to `true` for the richer person lookup plus company, which costs **0.4 credit** per call. If the company cannot be retrieved you are billed for the person only. Pass `listname` and a company already checked on that list recently is free: you pay for the person only.
{% endhint %}

The field is `person_linkedin_url`. The older `profile_url` name is no longer accepted and returns a 422.

**Reusing a recent company lookup.** If the person is on one of your lists, pass that list as `listname`. When their company was already checked and charged on that list recently (by this endpoint, Company Profile, a Flow, or a list enrichment), the saved company record is used, the company part (0.1) is not charged, and `message` says when it was checked. Without `listname` the company is looked up and charged as usual.

**Headers**

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

**Body**

| Name                  | Type    | Description                                                                                            |
| --------------------- | ------- | ------------------------------------------------------------------------------------------------------ |
| `api_key`             | string  | Your API Key.                                                                                          |
| `person_linkedin_url` | string  | The LinkedIn profile URL to look up.                                                                   |
| `full_profile`        | boolean | Optional. Default `false` (0.2 credit). `true` returns the full person profile + company (0.4 credit). |
| `listname`            | string  | Optional. A list the person is on. A company checked on that list recently is not charged again.       |

**Response**

`data` holds two records.

| Field     | Type   | Description                                                                                |
| --------- | ------ | ------------------------------------------------------------------------------------------ |
| `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.        |

The company record carries `organization_name`, `company_linkedin_url`, `company_website`, `domain`, `industry`, `industries`, `company_size`, `headcount`, `headquarters`, `company_description`, `company_keywords`, `company_logo`, `follower_count`, `year_founded`, `organization_type` and `linkedin_id`. Anything the source returned that has no name here is kept under `extra`.

The record is under `data`. 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_url": "https://www.linkedin.com/in/williamhgates/",
  "full_profile": false
}
```

{% endtab %}

{% tab title="Output: Basic" %}

```json
{
  "status": "success",
  "data": {
    "profile": {
      "person_name": "Bill Gates",
      "first_name": null,
      "last_name": null,
      "current_title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
      "headline": null,
      "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
      "organization_name": "Gates Foundation",
      "company_linkedin_url": null,
      "city": "Seattle",
      "state": "Washington",
      "country": "United States",
      "country_code": "us",
      "about": null,
      "open_to_work": null,
      "follower_count": 40527042,
      "connection_count": null,
      "work_experience": null,
      "education_history": null,
      "skills": null,
      "profile_picture_url": null,
      "linkedin_id": "williamhgates"
    },
    "company": {
      "organization_name": "Gates Foundation",
      "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
      "company_website": "https://www.gatesfoundation.org/about/careers",
      "domain": "gatesfoundation.org",
      "industry": "Non-profit Organizations",
      "industries": ["Non-profit Organizations"],
      "company_size": "1001-5000",
      "headcount": null,
      "headquarters": {
        "city": null,
        "state": null,
        "country": null,
        "country_code": null,
        "raw": "Seattle, WA"
      },
      "company_description": null,
      "company_keywords": null,
      "company_logo": null,
      "follower_count": null,
      "year_founded": null,
      "organization_type": null,
      "linkedin_id": "8736"
    }
  },
  "credits_used": 0.2,
  "credits_remaining": 4822.8,
  "success": true
}
```

{% endtab %}

{% tab title="Output: Full profile" %}

```json
{
  "status": "success",
  "data": {
    "profile": {
      "person_name": "Bill Gates",
      "first_name": "Bill",
      "last_name": "Gates",
      "current_title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
      "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
      "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
      "organization_name": "Gates Foundation",
      "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
      "city": "Seattle",
      "state": "Washington",
      "country": "United States",
      "country_code": "us",
      "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft.",
      "open_to_work": false,
      "follower_count": 40527040,
      "connection_count": 8,
      "work_experience": [
        {
          "company_name": "Gates Foundation",
          "current_title": "Co-chair",
          "location": null,
          "start_date": "2000",
          "end_date": null,
          "is_current": true,
          "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
          "description": null,
          "employment_type": null
        }
      ],
      "education_history": [
        {
          "school_name": "Harvard University",
          "degree": null,
          "field_of_study": null,
          "start_date": "1973",
          "end_date": "1975",
          "school_linkedin_url": null
        }
      ],
      "skills": [],
      "profile_picture_url": null,
      "linkedin_id": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc"
    },
    "company": {
      "organization_name": "Gates Foundation",
      "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
      "company_website": "https://www.gatesfoundation.org/about/careers",
      "domain": "gatesfoundation.org",
      "industry": "Non-profit Organizations",
      "industries": ["Non-profit Organizations"],
      "company_size": "1001-5000",
      "headcount": 4223,
      "headquarters": {
        "city": null,
        "state": null,
        "country": null,
        "country_code": "us",
        "raw": "Seattle, WA"
      },
      "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": "8736"
    }
  },
  "credits_used": 0.4,
  "credits_remaining": 4822.6,
  "success": true
}
```

{% endtab %}

{% tab title="Output: Still running" %}

```json
{
  "status": "processing",
  "data": null,
  "credits_used": 0,
  "credits_remaining": 4823,
  "message": "The lookup is still running and is being collected in the background. Call again shortly and the record will be returned.",
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

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

{% endtab %}
{% endtabs %}

**Related**

* [Batch Lookup](/enrichments/profile-with-company/batch-lookup.md): up to 10 URLs in one call.
* [List Lookup](/enrichments/profile-with-company/list-lookup.md): a whole Parvenu list.
