# Data enrichment API for people and company records > Data enrichment API for people and companies: send a LinkedIn URL, work email, name with company, or domain. Pay only for valid emails. Free plan, no card. https://getprospect.com/developers/enrichment-api Send a LinkedIn URL, work email, name with company, or domain. Get the person, with a verified email when found, or the company, from 810M+ business profiles and 47M+ companies. You pay only for valid emails. Company enrichment is free. 50 valid emails free every month. No card. Or run it from Claude, ChatGPT or Cursor with the [GetProspect MCP server](https://getprospect.com/mcp). Rated 4.8 out of 5 on the Chrome Web Store (1,300+ ratings) and 4.0 out of 5 on G2. 140,000+ extension users. - No charge when nothing matches - 98% accuracy guarantee or your credits back - No sales call to get a key Request: ```bash curl --request POST \ --url https://api.getprospect.com/v2/people/enrich \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --data '{ "data": { "linkedin_url": "https://linkedin.com/in/jane-doe-example" } }' ``` Response 200: ```json { "success": true, "data": { "full_name": "Jane Doe", "email": { "status": "valid", "address": "jane.doe@acme.com" }, "primary_position": { "job_title": "Head of Sales", "company": { "name": "Acme", "website": "acme.com", "employee_range": "51-200" } } } } ``` [Get a free API key](https://app.getprospect.com/sign-up) ยท [Read the API docs](https://getprospect.com/api-docs.md) ## Enrich your first record in three steps ### Create an API key Sign up free, open the **API** page in the app and click **Create API Key**. ### Send what you know POST a LinkedIn URL, work email, or name and company domain to `/v2/people/enrich` with your key in `x-api-key`. ### Read the full record A match returns the person, with `email.status` valid when an email passes. No match answers 200 with `NOT_FOUND`. cURL: ```bash curl --request POST \ --url https://api.getprospect.com/v2/people/enrich \ --max-time 95 \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --data '{ "data": { "first_name": "Jane", "last_name": "Doe", "company_domain": "acme.com" } }' ``` JavaScript: ```javascript const response = await fetch("https://api.getprospect.com/v2/people/enrich", { method: "POST", headers: { "Content-Type": "application/json", "x-api-key": process.env.GETPROSPECT_API_KEY, }, body: JSON.stringify({ data: { first_name: "Jane", last_name: "Doe", company_domain: "acme.com" }, }), signal: AbortSignal.timeout(95_000), // a first email search can take over a minute }); const { data: person, errors } = await response.json(); if (person?.email.status === "searching") { // nothing charged: ask again after person.email.retry_after seconds } else if (person) { console.log(person.full_name, person.email.status, person.email.address); } else { console.log(errors[0].name); // NOT_FOUND: nothing charged } ``` Python: ```python import os import requests response = requests.post( "https://api.getprospect.com/v2/people/enrich", headers={"x-api-key": os.environ["GETPROSPECT_API_KEY"]}, json={"data": {"first_name": "Jane", "last_name": "Doe", "company_domain": "acme.com"}}, timeout=95, # a first email search can take over a minute ) body = response.json() person = body.get("data") if person and person["email"]["status"] == "searching": pass # nothing charged: ask again after person["email"]["retry_after"] seconds elif person: print(person["full_name"], person["email"]["status"], person["email"]["address"]) else: print(body["errors"][0]["name"]) # NOT_FOUND: nothing charged ``` Bulk companies: ```bash # Up to 50 companies per request. Company enrichment spends no credits. curl --request POST \ --url https://api.getprospect.com/v2/companies/bulk-enrich \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --data '{ "data": [ { "identifier": "acct-1", "domain": "acme.com" }, { "identifier": "acct-2", "domain": "example.com" }, { "identifier": "acct-3", "linkedin_url": "https://www.linkedin.com/company/acme-example/" } ] }' # The answer sorts every item into data.matched, data.not_matched or data.invalid, # each with your identifier. ``` Async job: ```bash # Up to 10,000 rows per job, within your plan's daily enrich limit and your email credits. curl --request POST \ --url https://api.getprospect.com/v2/people/enrichments \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --header 'Idempotency-Key: webinar-leads-2026-11-11' \ --data '{ "name": "Webinar leads", "data": [ { "identifier": "lead-1", "linkedin_url": "https://www.linkedin.com/in/jane-doe-example/" }, { "identifier": "lead-2", "first_name": "John", "last_name": "Smith", "company_domain": "example.com" }, { "identifier": "lead-3", "email": "ann.lee@acme.com" } ], "enrich_email": true, "enrich_phone": false }' # 202 Accepted. Poll GET /v2/jobs/{id}, or subscribe once to the job.finished webhook, # then page GET /v2/enrichments/{id}/results. ``` ## Get the full person or company record back Enrich each inbound sign-up by work email, route accounts by domain, or fill in a list of LinkedIn URLs. ### People Enrichment API Send a LinkedIn URL, work email, or name with a company. Get the current job title, location, LinkedIn URL and an email that passed verification, or none instead of a guess. ### Company Enrichment API Company enrichment by domain, LinkedIn URL or name returns firmographic data: industry, NAICS codes, headcount, founded year and locations, plus website technologies on single lookups. ### 50 records per request Bulk enrich up to 50 people or companies in one call. Each item comes back matched, not matched or invalid, with your own identifier. ### Async jobs for whole lists Send a list as one job, then poll it or get a signed `job.finished` webhook when it ends. Jobs run within your plan's daily limit. | Record | You send | You get back | | --- | --- | --- | | Person | LinkedIn URL or id, work email, name with company, or GetProspect id | Name, verified email and status, current job title, seniority, department, location, LinkedIn URL, followers, current company; mobile on request | | Company | Domain, LinkedIn URL or id, company name, or GetProspect id | Description, logo, website, industry, NAICS codes, keywords, founded year, headcount, locations, social profiles; website technologies on single lookups | ## Pay for new valid emails, not for lookups 1 email credit = 1 valid email your workspace does not own yet. Example: enrich 1,000 LinkedIn URLs. You spend at most 1,000 email credits, one per new valid email; rows with no valid email cost nothing. Paid plans add more valid emails a month, 30% off with annual billing. Mobile numbers are paid from the wallet, a US-dollar balance your team shares, only when found. Cancel in Settings. No call needed. See [GetProspect pricing](https://getprospect.com/pricing). | Enrichment API call | Cost | | --- | --- | | People Enrich that reveals a new valid email | 1 email credit | | No match, or no valid email found | Free | | A `searching` answer for a new person | Free; the retry charges only a valid email | | Person your workspace already owns | Free, and no enrich unit used | | Companies Enrich: single, bulk or job | Free | | Mobile number with `enrich_phone: true` | From the wallet, only when found; not for people located in Colorado, US | | Job polling and webhooks | Free | [Get a free API key](https://app.getprospect.com/sign-up) ## Enrichment API limits for bulk jobs Enrich limits count one unit per person or company looked up. The API, app, Chrome extension, Google Sheets add-on and MCP share them; the day resets at 00:00 UTC. Most lookups answer in seconds; a first email search can take over a minute, so set a 95-second client timeout. A job needs today's limit to cover all its rows, or it does not start; nothing is charged. Up to 5 enrichment jobs run at once. Each plan's daily, per-minute and per-second limits are listed in [usage limits](https://getprospect.com/help-center/credits-and-billing/usage-limits.md). Every plan includes the Enrichment API, unlimited teammates, 5 API keys per member and 25 webhooks per workspace. ## GetProspect Enrichment API at a glance - The GetProspect Enrichment API is a B2B data enrichment API (REST, v2) at https://api.getprospect.com/v2, with one x-api-key header. - GetProspect People Enrich matches by GetProspect id, LinkedIn URL or id, work email, or first and last name with a company; the strongest identifier wins. - GetProspect Companies Enrich matches by GetProspect id, LinkedIn URL or id, web domain or company name, and spends no credits in any mode. - The GetProspect Enrichment API takes up to 50 records per request and 10,000 rows per job, within your plan's daily enrich limit. - GetProspect data comes from publicly available professional sources and licensed B2B data providers; a DPA is available. - Anyone can see or delete their own GetProspect data at getprospect.com/personal-data; corrections go by email. ## Data enrichment API: frequently asked questions The help center guide walks through creating an API key, reading your rate limits and the request log step by step. [Read the API keys and logs guide](https://getprospect.com/help-center/integrations-and-api/api-keys-and-logs.md) ### What is a data enrichment API? A data enrichment API takes a partial record, such as a work email, LinkedIn URL or domain, and returns the full person or company record. Teams use it as a lead or contact enrichment API on inbound sign-ups, CRM records and account lists. ### How much does the enrichment API cost, and does a call with no match cost anything? A call with no match costs nothing. GetProspect People Enrich charges 1 email credit per newly revealed valid email, and people you already own are free again. Company enrichment is free. A mobile number is paid from the wallet, only when found. ### What do I need to send to enrich a person or a company? One identifier is enough. The GetProspect person enrichment API takes a LinkedIn URL, a work email, or a name with a company domain or name; Companies Enrich takes a domain, LinkedIn URL or company name. When you send several, the strongest wins. ### What fields does the people enrichment API return? GetProspect People Enrich returns the name, the email with its verification status, current job title, seniority, departments, location, LinkedIn URL, followers and current company. The job title and company are the current ones. Add enrich_phone to get a mobile number too. ### What are the enrichment API rate limits for bulk enrichment? GetProspect enrich limits follow your plan, per second, minute and day; each plan's numbers are in [usage limits](https://getprospect.com/help-center/credits-and-billing/usage-limits.md). The API takes 50 records per request and 10,000 rows per job, and a job starts only when today's remaining limit covers all its rows. A people job also needs 1 email credit to start and stops, keeping its results, when credits run out. ### Is the enrichment API included in the free plan? Yes. The GetProspect Free plan includes the Enrichment API and 50 valid emails a month, renewing every 30 days, with no card. Free also gets a one-time wallet balance for your first mobile numbers. ### Can I get enrichment results by webhook instead of polling? Yes. Subscribe once to the job.finished webhook and every GetProspect enrichment job sends a signed POST when it ends, retried if your endpoint fails. A workspace holds up to 25 webhooks, and job results stay available for 30 days. ### How is enrichment different from the email finder API? GetProspect enrichment returns a whole person or company record from any identifier you hold. The [email finder API](https://getprospect.com/developers/email-finder-api) takes a name and a company domain or name and returns a verified business email, or not found. ### Will the emails bounce, and why did People Enrich return no email? GetProspect People Enrich returns only emails that passed verification, and found emails bounce under 2% of the time. GetProspect guarantees 98% data accuracy or gets your credits back: if a valid email we found turns out to be wrong, tell us in the support chat and we return the credit after checking the case. If no email passes, you get none instead of a guess and pay nothing. Coverage varies by country. To check addresses you hold, use the [email verification API](https://getprospect.com/developers/email-verification-api). ### Can I call the enrichment API from Claude, ChatGPT or Cursor? Yes. The GetProspect MCP server gives AI assistants the same enrichment as tools: enrich_people, enrich_companies and start_bulk_enrichment. The same credits and daily limits apply. ## Test the enrichment API on records you know Get an enrichment API key on the Free plan and enrich ten people whose emails you already know. No card, no sales call. Building more than enrichment? See the whole [B2B data API](https://getprospect.com/developers). [Get a free API key](https://app.getprospect.com/sign-up)