firstname + lastname & company (domain or the 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].
Your webhook URL will receive a POST request when the enrichment is finished, lacks credits, or is canceled. If we fail to deliver a result to your webhook (receiving a non-2xx status code), we will retry every minute, up to 5 times. The content sent to your webhook is the same as that provided by the /bulk/enrichment_id endpoint.
{"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":"6ac4b72b2633e7e05829aeae","collectionId":"333a2fe4-0402-4584-8457-43983c52f3e2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac4b72b2633e7e05829aeae"},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ac4b72b2633e7e05829aeae","clientVersion":"0.0.3990","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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/v1/contact/enrich/bulk/post","slug":"/api/v1/contact/enrich/bulk/post","pageMetadata":{"title":"Start Bulk Enrichment","openapi":"reference/openapi.yml POST /contact/enrich/bulk","description":null,"href":"/api/v1/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},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_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:`firstname + lastname`}),` \u0026 `,_jsx(_components.code,{children:`company`}),` (domain or the 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(Heading,{level:`4`,id:`how-do-webhooks-work`,children:`How do webhooks work?`}),`\n`,_jsx(_components.p,{children:`Your webhook URL will receive a POST request when the enrichment is finished, lacks credits, or is canceled. If we fail to deliver a result to your webhook (receiving a non-2xx status code), we will retry every minute, up to 5 times. The content sent to your webhook is the same as that provided by the /bulk/enrichment_id endpoint.`})]})}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":"reference/openapi.yml POST /contact/enrich/bulk","description":null,"href":"/api/v1/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":[]},{"title":"How do webhooks work?","slug":"how-do-webhooks-work","depth":4,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Enrich Contacts In Bulk","description":"","operationId":"postContactBulkEnrich","requestBody":"b50d505a-7459-4ad6-bf73-2f8ce398dc86","responses":{"200":"20094f56-5e35-4379-95aa-fca9a022eb78","400":"7b92f64b-3ad2-4485-85a3-54eea827a4d9","401":"fd9c57e0-d166-440a-b7a0-6222c2c50a56"},"security":["0e8a7e6e-623f-407d-a70f-88543fab3d5b"],"x-stoplight":{"id":"3rja23gz4xvhv"},"method":"post","type":"path","servers":["dafa4714-ecee-46e8-83a4-cf1a713b6235"],"path":"/contact/enrich/bulk","baseUrlOptions":["https://app.fullenrich.com/api/v1"],"title":"Enrich Contacts In Bulk","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","examples":["Sales Operations in London"],"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"datas":{"type":"array","items":{"type":"object","properties":{"firstname":{"type":"string","examples":["john"],"uniqueKey":"datas.items.[INDEX].firstname","typeLabel":"string"},"lastname":{"type":"string","examples":["snow"],"uniqueKey":"datas.items.[INDEX].lastname","typeLabel":"string"},"domain":{"type":"string","examples":["example.com"],"uniqueKey":"datas.items.[INDEX].domain","typeLabel":"string"},"company_name":{"type":"string","examples":["example inc"],"uniqueKey":"datas.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).","examples":["https://www.linkedin.com/in/demoge/"],"uniqueKey":"datas.items.[INDEX].linkedin_url","typeLabel":"string"},"enrich_fields":{"type":"array","examples":[["contact.emails","contact.phones"]],"items":{"type":"string","examples":[["contact.emails","contact.phones"]],"enum":["contact.emails","contact.phones"],"uniqueKey":"datas.items.[INDEX].enrich_fields.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"datas.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.","examples":[{"user_id":"12584"},{"crm_contact_id":"123"}],"uniqueKey":"datas.items.[INDEX].custom","typeLabel":"object"}},"x-stoplight":{"id":"fwqx8iw6iu2ve"},"uniqueKey":"datas.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"datas","typeLabel":"object[]"},"webhook_url":{"type":"string","description":"If you are using n8n, this is where you add the Webhook that will be triggered when the enrichment is done.","examples":["https://example.com/webhook","https://n8n.com/webhook/36ajcd81-7f76-4b43-ab21-ba8a67264da7"],"uniqueKey":"webhook_url","typeLabel":"string"}},"required":["name","providers","datas"],"x-stoplight":{"id":"qbqd1bt6pfpb6"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"Sales Operations in London","datas":[{"firstname":"john","lastname":"snow","domain":"example.com","company_name":"example inc","linkedin_url":"https://www.linkedin.com/in/demoge/","enrich_fields":["contact.emails","contact.phones"],"custom":{"user_id":"12584"}}],"webhook_url":"https://example.com/webhook"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"20094f56-5e35-4379-95aa-fca9a022eb78":{"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>"}},"x-stoplight":{"id":"yujio9ljywunw"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"enrichment_id":"2db5ea61-1752-42cf-8ea1-ab1da060cd0a"}}},"exampleType":"generated"}},"exampleType":"generated"},"7b92f64b-3ad2-4485-85a3-54eea827a4d9":{"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"],"x-stoplight":{"id":"v5d69l7ks2svx"},"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"}},"DatasNotSet":{"title":"DatasNotSet","value":{"code":"error.enrichment.datas.empty","message":"Datas is empty"}},"FirstnameNotSet":{"title":"FirstnameNotSet","value":{"code":"error.enrichment.firstname.empty","message":"Firstname cannot be empty"}},"LastnameNotSet":{"title":"LastnameNotSet","value":{"code":"error.enrichment.lastname.empty","message":"Lastname 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 valide must be contact.emails or contact.phones"}},"CustomKeyExceeded":{"title":"CustomKeyExceeded","value":{"code":"error.enrichment.custom.key.exceeded","message":"Custom field containe 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"},"fd9c57e0-d166-440a-b7a0-6222c2c50a56":{"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"],"x-stoplight":{"id":"v5d69l7ks2svx"},"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 not have prefix 'bearer'"}},"UnknownApiKey":{"title":"UnknownApiKey","value":{"code":"error.api.key","message":"Unknown api key"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"0e8a7e6e-623f-407d-a70f-88543fab3d5b":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"string","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"dafa4714-ecee-46e8-83a4-cf1a713b6235":{"url":"https://app.fullenrich.com/api/v1"}},"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/v1/reference/openapi.yml"},"subdomain":"fullenrich","siteName":"FullEnrich API Documentation","title":"Start Bulk Enrichment - FullEnrich API Documentation","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api/v2/contact/enrich/bulk/post","matchLevel":1},"v1":{"href":"/api/v1/contact/enrich/bulk/post","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-10-06T08:54:09.723Z","originalFileLocation":"api/v1/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/v1/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=API+%E2%80%94+Enrichment\u0026amp;title=Start+Bulk+Enrichment\u0026amp;theme=a4e962dd3a789e87cd15bff4\u0026amp;signature=59e0ced315b71ff6e45a04cd6c83b7832689ab8b5306d67af687ea7791194112\">\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=API+%E2%80%94+Enrichment\u0026amp;title=Start+Bulk+Enrichment\u0026amp;theme=a4e962dd3a789e87cd15bff4\u0026amp;signature=59e0ced315b71ff6e45a04cd6c83b7832689ab8b5306d67af687ea7791194112\">\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/v1/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/v1/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/v1/contact/enrich/bulk/post#webpage\",\"url\":\"https://docs.fullenrich.com/api/v1/contact/enrich/bulk/post\",\"name\":\"Start Bulk Enrichment\",\"dateModified\":\"2026-10-06T08:54:09.723Z\",\"isPartOf\":{\"@id\":\"https://docs.fullenrich.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fullenrich.com/api/v1/contact/enrich/bulk/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fullenrich.com/api/v1/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/v1/contact/enrich/bulk/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fullenrich.com/api/v1/contact/enrich/bulk/post#apireference\",\"headline\":\"Start Bulk Enrichment\",\"name\":\"Start Bulk Enrichment\",\"url\":\"https://docs.fullenrich.com/api/v1/contact/enrich/bulk/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fullenrich.com/api/v1/contact/enrich/bulk/post#webpage\"},\"dateModified\":\"2026-10-06T08:54:09.723Z\",\"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","pages":[{"title":"v2","href":"/api/v2/contact/enrich/bulk/post"}]},{"version":"v1","groups":[{"group":"API — Enrichment","pages":[{"title":"Start Bulk Enrichment","openapi":"reference/openapi.yml POST /contact/enrich/bulk","href":"/api/v1/contact/enrich/bulk/post"},{"title":"Get Enrichment Result","openapi":"reference/openapi.yml get /contact/enrich/bulk/{enrichment_id}","description":"Use this endpoint to retrieve the result from an enrich. You 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/v1/contact/enrich/bulk/get"},{"title":"Get Current Credit Balance","openapi":"reference/openapi.yml get /account/credits","href":"/api/v1/account/credits/get"},{"title":"Check If API Key Is Valid","openapi":"reference/openapi.yml get /account/keys/verify","href":"/api/v1/account/keys/verify/get"}]},{"group":"Reverse Email Lookup","pages":[{"title":"Reverse Email Lookup","openapi":"POST /contact/reverse/email/bulk","href":"/api/v1/contact/reverse/email/bulk/post"},{"title":"Get Reverse Email Result","openapi":"get /contact/reverse/email/bulk/{reverse_email_id}","href":"/api/v1/contact/reverse/email/bulk/get"}]}]}]},"title":"Start Bulk Enrichment - FullEnrich API Documentation","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}