---
title: "Enrich from LinkedIn URLs"
method: POST
path: "/api/v1/enrich/from-linkedin"
tags: ["Enrich"]
---

# Enrich from LinkedIn URLs

`POST /api/v1/enrich/from-linkedin`

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/enrich/from-linkedin`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Look up contact details (email, company, etc.) from LinkedIn profile URLs.
1 credit per successful enrichment.

## Request body

- object
  - `items` object[], required
    - `linkedin_url` string, uri, required
  - `limit_per_item` integer

## Response `200`

Enrichment results

- object
  - `ok` boolean
  - `creditsRemaining` integer, nullable
  - `credits_exhausted` boolean
  - `message` string
  - `code` string
  - `results` object[]
    - `success` boolean
    - `data` object: Full enrichment data (varies by upstream).
    - `skipped_reason` string
    - `linkedinUrl` string
    - `email` string

## Other responses

- `401`: Missing or invalid API key
- `402`: Insufficient credits or fair-use limit reached

---

[API](https://skmtc.dev/getleads/apis/getleads-api.md) - [All operations](https://skmtc.dev/getleads/apis/getleads-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getleads/apis/getleads-api/revisions/f5dbc32e0c3a?raw)