first_name + last_name & company (domain or company_name)
linkedin_url
For the best results, provide as much information as possible. Including a LinkedIn URL can improve enrichment rates by +5–20% for emails and +10–60% for mobile phone numbers.If you pass a linkedin_url, we will also return a full contact and company profile (job title, location, headcount, etc.).
You can enrich up to 100 contacts in bulk. If you want to enrich only 1 contact, you can pass only 1 contact in the list.All enrichments started on the API are visible on your FullEnrich dashboard. It is good practice to use a readable ‘name’ for each enrichment. This way, you can easily search through them. For instance, if you are enriching just one contact, you might name your enrichment ‘Firstname Lastname’.To pass specific properties, utilize the ‘custom’ field by passing an object. For example, if you are enriching a contact from your CRM, include the CRM ‘contact_id’ in the custom object. This allows you to reference the contact_id when you receive the result on your webhook. The custom value should be a cast as a string (number will return an error)To retrieve the results of your enrichment, you can either provide a webhook URL [recommended] or call the GET /bulk/enrichment_id endpoint [not recommended].
How Do Webhooks Work? [Recommended Read]
Learn how to receive results in real-time, set up per-contact webhooks, and track requests with custom fields.
Default = False. When true, a contact with invalid or missing input data (professional network URL, domain, name) is skipped instead of failing the whole request. Skipped contacts are returned in the results without enrichment data.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FullEnrich API Documentation","colors":{"primary":"#8164F4","light":"#BFADFF","dark":"#5031AE"},"logo":{"light":"https://mintcdn.com/fullenrich/QlQ00joQ41SH1_-N/logo/light.svg?fit=max\u0026auto=format\u0026n=QlQ00joQ41SH1_-N\u0026q=85\u0026s=d419fb1f166c8f93bf1790cb80538391","dark":"https://mintcdn.com/fullenrich/QlQ00joQ41SH1_-N/logo/dark.svg?fit=max\u0026auto=format\u0026n=QlQ00joQ41SH1_-N\u0026q=85\u0026s=500ebe5ca6c71328f2ab4f7362527eff","href":"https://fullenrich.com"},"favicon":"https://mintcdn.com/fullenrich/QlQ00joQ41SH1_-N/logo/favicon.svg?fit=max\u0026auto=format\u0026n=QlQ00joQ41SH1_-N\u0026q=85\u0026s=506fc45913db6ecb52d3ad0375123d88","api":{"openapi":"api/v2/reference/openapi.yaml","playground":{"display":"interactive"}},"appearance":{"default":"light","strict":false},"navbar":{"links":[{"href":"mailto:support@fullenrich.com","label":"Support Email"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.fullenrich.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/fullenrich"}},"search":{"prompt":"Ask AI about the docs"},"fonts":{"family":"Inter"},"integrations":{"intercom":{"appId":"g63coocn"},"posthog":{"apiKey":"phc_4tMzUCbRspveYQwHj5ZyE6c0q2BacflNxaIqTY9Nu9b","apiHost":"https://eu.i.posthog.com"}},"errors":{"404":{"redirect":true,"title":"/"}},"contextual":{"options":["chatgpt","assistant","claude","cursor","vscode","mcp",{"title":"Download OpenAPI spec","description":"Download the FullEnrich API v2 OpenAPI specification","icon":"file-code","href":"/api/v2/reference/openapi.yaml"}],"display":"header"},"interaction":{"drilldown":true},"markdown":{"schema":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Help Center","icon":"book-open-cover","href":"https://help.fullenrich.com"},{"anchor":"FullEnrich App","icon":"computer-classic","href":"https://app.fullenrich.com/app/enrich"},{"anchor":"OpenAPI Spec","icon":"file-code","href":"/api/v2/reference/openapi.yaml"},{"anchor":"MCP Server","icon":"Robot","href":"https://help.fullenrich.com/en/articles/14190120-mcp-server"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fullenrich","hasAudioNarration":false,"actualSubdomain":"fullenrich","customDomains":["docs.fullenrich.com"],"gitSource":{"type":"github","owner":"fullenrich","repo":"mintlify-api-documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae9b059eb38dc51d1c81fda","collectionId":"1abc0d8d-6add-42e4-905b-019be8f548df","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae9b059eb38dc51d1c81fda"},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae9b059eb38dc51d1c81fda","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Search","count":7},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"API — Enrichment","count":4},{"language":"default","tag":"Reverse Email Lookup","count":4},{"language":"default","tag":"FullEnrich in your Product","count":4},{"language":"default","tag":"Tools","count":2},{"language":"default","tag":"Enrichment","count":2}]},"assistantConfig":{"enableStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6a063c4d8d70fb04ed8e9606","deploymentId":"665e0dd31a0370d545430463","questionText":"Write me a code sample in TS to use the people search","status":"active","generatedBy":"manual","createdAt":"2026-05-14T21:19:09.035Z","updatedAt":"2026-05-14T21:19:09.035Z","__v":0},{"_id":"6a063c328d70fb04ed8e9555","deploymentId":"665e0dd31a0370d545430463","questionText":"How much credits cost?","status":"active","generatedBy":"manual","createdAt":"2026-05-14T21:18:42.193Z","updatedAt":"2026-05-14T21:18:42.193Z","__v":0},{"_id":"6a063c248d70fb04ed8e9518","deploymentId":"665e0dd31a0370d545430463","questionText":"How do webhooks works?","status":"active","generatedBy":"manual","createdAt":"2026-05-14T21:18:28.384Z","updatedAt":"2026-05-14T21:18:47.443Z","__v":0}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/v2/contact/enrich/bulk/post","slug":"/api/v2/contact/enrich/bulk/post","pageMetadata":{"title":"Start Bulk Enrichment","openapi":"api/v2/reference/openapi.yaml POST /contact/enrich/bulk","description":"","href":"/api/v2/contact/enrich/bulk/post"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,Heading}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Card,{title:`First time? Set up Authentication`,icon:`key`,iconType:`duotone`,horizontal:true,href:`/api/v2/general/authentication`,children:_jsx(_components.p,{children:`Learn how to authenticate your API requests with your API key.`})}),`\n`,_jsx(_components.p,{children:`Use this endpoint to find the contact information of any B2B person:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Work email (1 credit)`}),`\n`,_jsx(_components.li,{children:`Mobile phone number (10 credits)`}),`\n`,_jsx(_components.li,{children:`Personal Email (3 credits)`}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`input-needed`,children:`Input needed`}),`\n`,_jsx(_components.p,{children:`To enrich a contact, you must provide either:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`first_name`}),` + `,_jsx(_components.code,{children:`last_name`}),` \u0026 `,_jsx(_components.code,{children:`company`}),` (domain or company_name)`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`linkedin_url`})}),`\n`]}),`\n`,_jsx(_components.p,{children:`For the best results, provide as much information as possible. Including a LinkedIn URL can improve enrichment rates by +5–20% for emails and +10–60% for mobile phone numbers.`}),`\n`,_jsxs(_components.p,{children:[`If you pass a `,_jsx(_components.code,{children:`linkedin_url`}),`, we will also return a full contact and company profile (job title, location, headcount, etc.).`]}),`\n`,_jsx(Heading,{level:`4`,id:`practical-tips`,children:`Practical tips`}),`\n`,_jsx(_components.p,{children:`You can enrich up to 100 contacts in bulk. If you want to enrich only 1 contact, you can pass only 1 contact in the list.`}),`\n`,_jsx(_components.p,{children:`All enrichments started on the API are visible on your FullEnrich dashboard. It is good practice to use a readable ‘name’ for each enrichment. This way, you can easily search through them. For instance, if you are enriching just one contact, you might name your enrichment ‘Firstname Lastname’.`}),`\n`,_jsx(_components.p,{children:`To pass specific properties, utilize the ‘custom’ field by passing an object. For example, if you are enriching a contact from your CRM, include the CRM ‘contact_id’ in the custom object. This allows you to reference the contact_id when you receive the result on your webhook. The custom value should be a cast as a string (number will return an error)`}),`\n`,_jsxs(_components.p,{children:[`To retrieve the results of your enrichment, you can either provide a `,_jsx(_components.strong,{children:`webhook URL`}),` [recommended] or call the `,_jsx(_components.strong,{children:`GET /bulk/enrichment_id`}),` endpoint [not recommended].`]}),`\n`,_jsx(Card,{title:_jsx(_Fragment,{children:`How Do Webhooks Work? [Recommended Read]`}),icon:`webhook`,iconType:`duotone`,horizontal:true,href:`/api/v2/general/webhooks`,children:_jsx(_components.p,{children:`Learn how to receive results in real-time, set up per-contact webhooks, and track requests with custom fields.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Start Bulk Enrichment","openapi":"api/v2/reference/openapi.yaml POST /contact/enrich/bulk","description":"","href":"/api/v2/contact/enrich/bulk/post"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Input needed","slug":"input-needed","depth":4,"children":[]},{"title":"Practical tips","slug":"practical-tips","depth":4,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Enrich Contacts In Bulk","description":"","operationId":"postContactBulkEnrich","parameters":["8aa85220-dcdd-4aff-8178-e9374d8f1f05"],"requestBody":"7dc9b012-2825-456b-9014-defb4c14c8cb","responses":{"200":"503d1d91-9ef5-4e4a-acb9-50840de8fd21","400":"48b2a372-ff2c-4d42-be91-b09af3913f71","401":"f8d19ea2-6d82-446e-8e4a-80d7123156e3","429":"a935337a-a0e9-4cdf-b9f5-92ca0777f2c9"},"security":["8ea501fc-2b8a-4780-887c-6ce23978fa4e"],"method":"post","type":"path","servers":["af1d48fe-c141-4e90-84e9-71e2db9078c5"],"path":"/contact/enrich/bulk","baseUrlOptions":["https://app.fullenrich.com/api/v2"],"title":"Enrich Contacts In Bulk","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"8aa85220-dcdd-4aff-8178-e9374d8f1f05":{"name":"silentFail","in":"query","schema":{"type":"boolean","description":"Default = False. When true, a contact with invalid or missing input data (professional network URL, domain, name) is skipped instead of failing the whole request. Skipped contacts are returned in the results without enrichment data.","uniqueKey":"","typeLabel":"boolean"},"description":"Default = False. When true, a contact with invalid or missing input data (professional network URL, domain, name) is skipped instead of failing the whole request. Skipped contacts are returned in the results without enrichment data."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","example":{"name":"Sales Operations in London","webhook_url":"https://example.com/webhook","webhook_events":{"contact_finished":"https://example.com/webhook/contact"},"data":[{"first_name":"John","last_name":"Snow","domain":"example.com","company_name":"Example Inc","professional_network_url":"https://www.linkedin.com/in/demoge/","enrich_fields":["contact.work_emails","contact.personal_emails","contact.phones"],"custom":{"user_id":"12584"}}]},"properties":{"name":{"type":"string","description":"A readable name for this enrichment (visible in your dashboard)","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"data":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","uniqueKey":"data.items.[INDEX].first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"data.items.[INDEX].last_name","typeLabel":"string"},"domain":{"type":"string","uniqueKey":"data.items.[INDEX].domain","typeLabel":"string"},"company_name":{"type":"string","uniqueKey":"data.items.[INDEX].company_name","typeLabel":"string"},"linkedin_url":{"type":"string","description":"Supports standard LinkedIn profile URLs (e.g., https://www.linkedin.com/in/demoge) as well as LinkedIn Sales Navigator URLs (e.g., https://www.linkedin.com/in/ACwAACLLwaIBKi655883b).","uniqueKey":"data.items.[INDEX].linkedin_url","typeLabel":"string"},"enrich_fields":{"type":"array","items":{"type":"string","enum":["contact.work_emails","contact.phones","contact.personal_emails"],"uniqueKey":"data.items.[INDEX].enrich_fields.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"data.items.[INDEX].enrich_fields","typeLabel":"enum\u003cstring>[]"},"custom":{"type":"object","description":"Returned in the enrichment result. Use it to identify a user, a CRM contact, or to pass any other information. All values must be strings. Limited to 20 entries.","uniqueKey":"data.items.[INDEX].custom","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"webhook_url":{"type":"string","description":"URL that will receive a POST request when the entire enrichment is finished (all contacts processed).","uniqueKey":"webhook_url","typeLabel":"string"},"webhook_events":{"type":"object","description":"Optional webhook URLs for specific events during enrichment","properties":{"contact_finished":{"type":"string","description":"URL that receives a POST request each time a single contact is enriched, without waiting for the entire batch to complete. Useful for real-time updates.","uniqueKey":"webhook_events.contact_finished","typeLabel":"string"}},"uniqueKey":"webhook_events","typeLabel":"object"}},"required":["name","data"],"uniqueKey":"","typeLabel":"object"},"example":{"name":"Sales Operations in London","webhook_url":"https://example.com/webhook","webhook_events":{"contact_finished":"https://example.com/webhook/contact"},"data":[{"first_name":"John","last_name":"Snow","domain":"example.com","company_name":"Example Inc","linkedin_url":"https://www.linkedin.com/in/demoge/","enrich_fields":["contact.work_emails","contact.personal_emails","contact.phones"],"custom":{"user_id":"12584"}}]},"examples":{"Example":{"title":"Example","value":{"name":"Sales Operations in London","webhook_url":"https://example.com/webhook","webhook_events":{"contact_finished":"https://example.com/webhook/contact"},"data":[{"first_name":"John","last_name":"Snow","domain":"example.com","company_name":"Example Inc","linkedin_url":"https://www.linkedin.com/in/demoge/","enrich_fields":["contact.work_emails","contact.personal_emails","contact.phones"],"custom":{"user_id":"12584"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"503d1d91-9ef5-4e4a-acb9-50840de8fd21":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enrichment_id":{"type":"string","format":"uuid","examples":["2db5ea61-1752-42cf-8ea1-ab1da060cd0a"],"uniqueKey":"enrichment_id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"enrichment_id":"2db5ea61-1752-42cf-8ea1-ab1da060cd0a"}}},"exampleType":"generated"}},"exampleType":"generated"},"48b2a372-ff2c-4d42-be91-b09af3913f71":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"EnrichmentNameNotSet":{"title":"EnrichmentNameNotSet","value":{"code":"error.enrichment.name.empty","message":"Enrichment name not set"}},"WebhookURLInvalid":{"title":"WebhookURLInvalid","value":{"code":"error.enrichment.webhook_url","message":"Webhook URL must be start with http or https"}},"ProviderNotSet":{"title":"ProviderNotSet","value":{"code":"error.enrichment.provider.empty","message":"Providers not set"}},"DataNotSet":{"title":"DataNotSet","value":{"code":"error.enrichment.data.empty","message":"Data is empty"}},"FirstNameNotSet":{"title":"FirstNameNotSet","value":{"code":"error.enrichment.first_name.empty","message":"First name cannot be empty"}},"LastNameNotSet":{"title":"LastNameNotSet","value":{"code":"error.enrichment.last_name.empty","message":"Last name cannot be empty"}},"DomainNotSet":{"title":"DomainNotSet","value":{"code":"error.enrichment.domain.empty","message":"Domain cannot be empty"}},"EnrichFieldsNotSet":{"title":"EnrichFieldsNotSet","value":{"code":"error.enrichment.enrich_fields.empty","message":"enrichFields cannot be empty"}},"EnrichFieldValue":{"title":"EnrichFieldValue","value":{"code":"error.enrichment.enrich_field.value","message":"enrichField 'xxxx' not valid must be contact.work_emails or contact.phones or contact.personal_emails"}},"CustomKeyExceeded":{"title":"CustomKeyExceeded","value":{"code":"error.enrichment.custom.key.exceeded","message":"Custom field contains too many keys (max: 10 keys)"}},"CustomKeyValueExceeded":{"title":"CustomKeyValueExceeded","value":{"code":"error.enrichment.custom.value.exceeded","message":"Custom field value max len exceeded (max: 100 character)"}}},"exampleType":"examples"}},"exampleType":"examples"},"f8d19ea2-6d82-446e-8e4a-80d7123156e3":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"AuthorizationHeaderNotSet":{"title":"AuthorizationHeaderNotSet","value":{"code":"error.authorization.not_set","message":"Authorization headers not set"}},"AuthorizationHeaderNotAnBearer":{"title":"AuthorizationHeaderNotAnBearer","value":{"code":"error.authorization.not_bearer","message":"Authorization headers do not have prefix 'bearer'"}},"UnknownApiKey":{"title":"UnknownApiKey","value":{"code":"error.api.key","message":"Unknown api key"}}},"exampleType":"examples"}},"exampleType":"examples"},"a935337a-a0e9-4cdf-b9f5-92ca0777f2c9":{"description":"Too Many Requests","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"RateLimitExceeded":{"title":"RateLimitExceeded","value":{"code":"error.rate.limit","message":"Too many requests. Try again in 1m"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"8ea501fc-2b8a-4780-887c-6ce23978fa4e":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"string","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"af1d48fe-c141-4e90-84e9-71e2db9078c5":{"url":"https://app.fullenrich.com/api/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"string","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api/v2/reference/openapi.yaml"},"subdomain":"fullenrich","siteName":"FullEnrich API Documentation","title":"Start Bulk Enrichment - FullEnrich API Documentation","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api/v2/contact/enrich/bulk/post","matchLevel":0},"v1":{"href":"/api/v1/contact/enrich/bulk/post","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-03-30T13:55:44.970Z","originalFileLocation":"api/v2/contact/enrich/bulk/post.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"FullEnrich API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start Bulk Enrichment - FullEnrich API Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FullEnrich API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fullenrich.mintlify.app/_mintlify/api/og/v2?division=Enrichment\u0026amp;title=Start+Bulk+Enrichment\u0026amp;theme=a4e962dd3a789e87cd15bff4\u0026amp;signature=c7567551ef35cd59fc39940c86ea5e35b56dd08ecf15f16b7ab26ebc9036a3e1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Start Bulk Enrichment - FullEnrich API Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fullenrich.mintlify.app/_mintlify/api/og/v2?division=Enrichment\u0026amp;title=Start+Bulk+Enrichment\u0026amp;theme=a4e962dd3a789e87cd15bff4\u0026amp;signature=c7567551ef35cd59fc39940c86ea5e35b56dd08ecf15f16b7ab26ebc9036a3e1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fullenrich/aUz86RZpLrt_y4p3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FullEnrich API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8164F4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/v2/contact/enrich/bulk/post.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fullenrich.com/#organization\",\"name\":\"FullEnrich API Documentation\",\"url\":\"https://docs.fullenrich.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fullenrich/QlQ00joQ41SH1_-N/logo/light.svg?fit=max\u0026auto=format\u0026n=QlQ00joQ41SH1_-N\u0026q=85\u0026s=d419fb1f166c8f93bf1790cb80538391\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fullenrich.com#website\",\"name\":\"FullEnrich API Documentation\",\"url\":\"https://docs.fullenrich.com\",\"publisher\":{\"@id\":\"https://docs.fullenrich.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post#webpage\",\"url\":\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post\",\"name\":\"Start Bulk Enrichment\",\"dateModified\":\"2026-03-30T13:55:44.970Z\",\"isPartOf\":{\"@id\":\"https://docs.fullenrich.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"FullEnrich API Documentation\",\"item\":\"https://docs.fullenrich.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Start Bulk Enrichment\",\"item\":\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post#apireference\",\"headline\":\"Start Bulk Enrichment\",\"name\":\"Start Bulk Enrichment\",\"url\":\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fullenrich.com/api/v2/contact/enrich/bulk/post#webpage\"},\"dateModified\":\"2026-03-30T13:55:44.970Z\",\"publisher\":{\"@id\":\"https://docs.fullenrich.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fullenrich.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FullEnrich API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"FullEnrich API Documentation","nav":{"global":{"anchors":[{"anchor":"Help Center","icon":"book-open-cover","href":"https://help.fullenrich.com"},{"anchor":"FullEnrich App","icon":"computer-classic","href":"https://app.fullenrich.com/app/enrich"},{"anchor":"OpenAPI Spec","icon":"file-code","href":"/api/v2/reference/openapi.yaml"},{"anchor":"MCP Server","icon":"Robot","href":"https://help.fullenrich.com/en/articles/14190120-mcp-server"}]},"versions":[{"version":"v2","groups":[{"group":"Getting Started","pages":[{"title":"API Overview","icon":"house","href":"/api/v2/general/introduction"},{"title":"Authentication","icon":"key","href":"/api/v2/general/authentication"},{"title":"How Webhooks Work","icon":"webhook","href":"/api/v2/general/webhooks"},{"title":"Credits \u0026 Testing Tips","icon":"coin","href":"/api/v2/general/credit"},{"title":"Email Verification Status","icon":"envelope-circle-check","href":"/api/v2/general/email-status"},{"title":"Data Dictionary","icon":"table-list","href":"/api/v2/general/data-dictionary"},{"title":"Rate Limit","icon":"gauge-max","href":"/api/v2/general/ratelimit"}]},{"group":"FullEnrich in your Product","pages":[{"title":"Getting Started \u0026 Concepts","icon":"plug","href":"/api/v2/implement-in-product/getting-started"},{"title":"Rate Limits \u0026 Volume","icon":"gauge-high","href":"/api/v2/implement-in-product/volume"},{"title":"Deploying in Production","icon":"rocket","href":"/api/v2/implement-in-product/production"},{"title":"Quality Over Speed","icon":"gem","description":null,"href":"/api/v2/implement-in-product/quality-over-speed"}]},{"group":"Enrichment","pages":[{"title":"Start Bulk Enrichment","openapi":"api/v2/reference/openapi.yaml POST /contact/enrich/bulk","href":"/api/v2/contact/enrich/bulk/post"},{"title":"Get Enrichment Result","openapi":"api/v2/reference/openapi.yaml GET /contact/enrich/bulk/{enrichment_id}","description":"Use this endpoint to retrieve the result from an enrich.\nYou don’t need to use this endpoint if you are using a webhook. Using a webhook is the method we recommend to get the result as soon as the enrichment is done.","href":"/api/v2/contact/enrich/bulk/get"}]},{"group":"Reverse Email Lookup","pages":[{"title":"Reverse Email Lookup","openapi":"api/v2/reference/openapi.yaml POST /contact/reverse/email/bulk","href":"/api/v2/contact/reverse/email/bulk/post"},{"title":"Get Reverse Email Result","openapi":"api/v2/reference/openapi.yaml GET /contact/reverse/email/bulk/{enrichment_id}","href":"/api/v2/contact/reverse/email/bulk/get"}]},{"group":"Search","pages":[{"title":"Getting Started — Search","icon":"play","href":"/api/v2/general/intro-search"},{"title":"Search People","openapi":"api/v2/reference/openapi.yaml POST /people/search","href":"/api/v2/people/search/post"},{"title":"Search Company","openapi":"api/v2/reference/openapi.yaml POST /company/search","href":"/api/v2/company/search/post"},{"title":"Look Up People","openapi":"api/v2/reference/openapi.yaml POST /people/lookup","href":"/api/v2/people/lookup/post"},{"title":"Look Up Company","openapi":"api/v2/reference/openapi.yaml POST /company/lookup","href":"/api/v2/company/lookup/post"},{"title":"Accepted Filter Values","icon":"tags","href":"/api/v2/general/enums"},{"title":"Filtering Logic Explained","icon":"filter","href":"/api/v2/general/filtering-logic-explained"}]},{"group":"Tools","pages":[{"title":"Get Credit Balance","openapi":"api/v2/reference/openapi.yaml GET /account/credits","href":"/api/v2/account/credits/get"},{"title":"Check If API Key Is Valid","openapi":"api/v2/reference/openapi.yaml GET /account/keys/verify","href":"/api/v2/account/keys/verify/get"}]}]},{"version":"v1","pages":[{"title":"v1","href":"/api/v1/contact/enrich/bulk/post"}]}]},"basePath":"","title":"Start Bulk Enrichment - FullEnrich API Documentation","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}