Amplemarket uses convention HTTP response codes to indicate the success or failure of an API request.Some errors that could be handled programmatically include an error code that briefly describes the reported error. When this happens, you can find details within the response under the field _errors.
An error object MAY have the following members, and MUST contain at least on of:
id (string) - a unique identifier for this particular occurrence of the problem
status (string) - the HTTP status code applicable to this problem
code (string) - an application-specific error code
title (string) - human-readable summary of the problem that SHOULD NOT
change from occurrence to occurrence of the problem, except for purposes of localization
detail (string) - a human-readable explanation specific to this occurrence of the problem, and can be localized
source (object) - an object containing references to the primary source of the error which SHOULD include one of the following members or be omitted:
pointer: a JSON Pointer RFC6901 to the value in the request document that caused the error (e.g. "/data" for a primary data object, or "/data/attributes/title" for a specific attribute). This MUST point to a value in the request document that exists; if it doesn’t, then client SHOULD simply ignore the pointer.
parameter: a string indicating which URI query parameter caused the error.
header: a string indicating the name of a single request header which caused the error.
When receiving data from Amplemarket please take into consideration that adding fields to the JSON output is considered a backwards-compatible change and it may happen without prior warning or through explicit versioning.
It is recommended to future proof your code so that it disregards all JSON fields you don’t actually use.
Was this page helpful?
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Amplemarket API","colors":{"primary":"#111111","light":"#EFEEE6","dark":"#111111"},"favicon":"https://mintcdn.com/amplemarket-50/6NkDp2ZAvd_pPh3s/icons/favicon.png?fit=max\u0026auto=format\u0026n=6NkDp2ZAvd_pPh3s\u0026q=85\u0026s=e252b1796ac49cd8feb323d51c6a5624","logo":{"light":"https://mintcdn.com/amplemarket-50/nKiDtQFwoEC-eryS/icons/logo-light.svg?fit=max\u0026auto=format\u0026n=nKiDtQFwoEC-eryS\u0026q=85\u0026s=613c52ac28bd4a2ed1f393bdc4de0e8a","dark":"https://mintcdn.com/amplemarket-50/nKiDtQFwoEC-eryS/icons/logo-dark.svg?fit=max\u0026auto=format\u0026n=nKiDtQFwoEC-eryS\u0026q=85\u0026s=41612ae3c685f400edd8b60f34a1fa49"},"api":{"openapi":"https://api.amplemarket.com/api-docs/v1/swagger.yaml"},"background":{"decoration":null,"color":{"light":"#F7F7F3","dark":"#262626"}},"navbar":{"links":[{"label":"Support","href":"mailto:support@amplemarket.com"},{"label":"Postman","href":"https://god.gw.postman.com/run-collection/20053380-5f813bad-f399-4542-a36a-b0900cd37d4d"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.amplemarket.com"}},"footer":{"socials":{"x":"https://x.com/amplemarket","github":"https://github.com/amplemarket/api-docs"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Blog","href":"https://amplemarket.com/blog","icon":"newspaper"},{"anchor":"Status Page","href":"http://status.amplemarket.com","icon":"power-off"},{"anchor":"Knowledge Base","href":"https://knowledge.amplemarket.com","icon":"book-open-cover"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"amplemarket-50","hasAudioNarration":false,"actualSubdomain":"amplemarket-50","customDomains":["docs.amplemarket.com"],"gitSource":{"type":"github","owner":"amplemarket","repo":"api-docs","deployBranch":"master","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae1ce2bdec5e8cb5c24ea86","collectionId":"a58aab26-fa72-4927-94ae-854a83bd2d81","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae1ce2bdec5e8cb5c24ea86"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae1ce2bdec5e8cb5c24ea86","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":62},{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"Exclusion lists","count":6},{"language":"default","tag":"Tasks","count":5},{"language":"default","tag":"Calls","count":4},{"language":"default","tag":"Companies Enrichment","count":4},{"language":"default","tag":"Contacts","count":4},{"language":"default","tag":"Lead List","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"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":"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":"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},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/errors","slug":"/api-reference/errors","pageMetadata":{"title":"Errors and Compatibility","description":"How to navigate the API responses.","href":"/api-reference/errors"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How to navigate the API responses.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"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={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`handling-errors`,children:`Handling Errors`}),`\n`,_jsx(_components.p,{children:`Amplemarket uses convention HTTP response codes to indicate the success or failure of an API request.`}),`\n`,_jsxs(_components.p,{children:[`Some errors that could be handled programmatically include an `,_jsx(_components.a,{href:`#error-codes`,children:`error code`}),` that briefly describes the reported error. When this happens, you can find details within the response under the field `,_jsx(_components.code,{children:`_errors`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-object`,children:`Error Object`}),`\n`,_jsx(_components.p,{children:`An error object MAY have the following members, and MUST contain at least on of:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`id`}),` (string) - a unique identifier for this particular occurrence of the problem`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`status`}),` (string) - the HTTP status code applicable to this problem`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`code`}),` (string) - an application-specific `,_jsx(_components.a,{href:`#error-codes`,children:`error code`})]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`title`}),` (string) - human-readable summary of the problem that SHOULD NOT\nchange from occurrence to occurrence of the problem, except for purposes of localization`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`detail`}),` (string) - a human-readable explanation specific to this occurrence of the problem, and can be localized`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`source`}),` (object) - an object containing references to the primary source of the error which `,_jsx(_components.strong,{children:`SHOULD`}),` include one of the following members or be omitted:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`pointer`}),`: a JSON Pointer `,_jsx(_components.a,{href:`https://tools.ietf.org/html/rfc6901`,children:`RFC6901`}),` to the value in the request document that caused the error (e.g. `,_jsx(_components.code,{children:`\"/data\"`}),` for a primary data object, or `,_jsx(_components.code,{children:`\"/data/attributes/title\"`}),` for a specific attribute). This `,_jsx(_components.strong,{children:`MUST`}),` point to a value in the request document that exists; if it doesn’t, then client `,_jsx(_components.strong,{children:`SHOULD`}),` simply ignore the pointer.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`parameter`}),`: a string indicating which URI query parameter caused the error.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`header`}),`: a string indicating the name of a single request header which caused the error.`]}),`\n`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Example:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\t\"_errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:[`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\t\t{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\t\t\t\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"400\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\t\t\t\"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"unsupported_value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\t\t\t\"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Unsupported Value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\t\t\t\"detail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Number of emails exceeds 100000 limit\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\t\t\t\"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\t\t\t\t\"pointer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"/emails\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\t\t\t}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\t\t}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\t]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsx(_components.p,{children:`The following error codes may be returned by the API:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`code`}),_jsx(_components.th,{children:`title`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`internal_server_error`}),_jsx(_components.td,{children:`Internal Server Error`}),_jsx(_components.td,{children:`An unexpected error occurred`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`insufficient_credits`}),_jsx(_components.td,{children:`Insufficient Credits`}),_jsx(_components.td,{children:`The account doesn’t have enough credits to continue the operation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`person_not_found`}),_jsx(_components.td,{children:`Person Not Found`}),_jsx(_components.td,{children:`A matching person was not found in our database`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`unavailable_for_legal_reasons`}),_jsx(_components.td,{children:`Unavailable For Legal Reasons`}),_jsx(_components.td,{children:`A matching person was found in our database, but has been removed due to privacy reasons`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`unsupported_value`}),_jsx(_components.td,{children:`Unsupported Value`}),_jsxs(_components.td,{children:[`Request has a field containing a value unsupported by the operation; more details within the corresponding `,_jsx(_components.a,{href:`#error-object`,children:`error object`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`missing_field`}),_jsx(_components.td,{children:`Missing Field`}),_jsxs(_components.td,{children:[`Request is missing a mandatory field; more details within the corresponding `,_jsx(_components.a,{href:`#error-object`,children:`error object`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`unauthorized`}),_jsx(_components.td,{children:`Unauthorized`}),_jsx(_components.td,{children:`The API credentials used are either invalid, or the user is not authorized to perform the operation`})]})]})]}),`\n`,_jsx(Heading,{level:`1`,id:`compatibility`,children:`Compatibility`}),`\n`,_jsx(_components.p,{children:`When receiving data from Amplemarket please take into consideration that adding fields to the JSON output is considered a backwards-compatible change and it may happen without prior warning or through explicit versioning.`}),`\n`,_jsx(Tip,{children:`It is recommended to future proof your code so that it disregards all JSON fields you don’t actually use.`})]})}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":"Errors and Compatibility","description":"How to navigate the API responses.","href":"/api-reference/errors"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Handling Errors","slug":"handling-errors","depth":1,"children":[]},{"title":"Error Object","slug":"error-object","depth":2,"children":[]},{"title":"Error Codes","slug":"error-codes","depth":2,"children":[]},{"title":"Compatibility","slug":"compatibility","depth":1,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"amplemarket-50","siteName":"Amplemarket API","title":"Errors and Compatibility - Amplemarket API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-10-20T12:58:27.762Z","originalFileLocation":"api-reference/errors.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=\"system\"}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=\"description\" content=\"How to navigate the API responses.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Amplemarket API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/amplemarket-50/mca-0KUOMtPMXsSB/_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/amplemarket-50/mca-0KUOMtPMXsSB/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/amplemarket-50/mca-0KUOMtPMXsSB/_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/amplemarket-50/mca-0KUOMtPMXsSB/_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/amplemarket-50/mca-0KUOMtPMXsSB/_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/amplemarket-50/mca-0KUOMtPMXsSB/_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/amplemarket-50/mca-0KUOMtPMXsSB/_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/amplemarket-50/mca-0KUOMtPMXsSB/_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/amplemarket-50/mca-0KUOMtPMXsSB/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Errors and Compatibility - Amplemarket API\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to navigate the API responses.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Amplemarket API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.amplemarket.com/api-reference/errors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://amplemarket-50.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Errors+and+Compatibility\u0026amp;description=How+to+navigate+the+API+responses.\u0026amp;theme=60393c4a5f19d1b30a9c94f6\u0026amp;signature=911345f6b55f61cc0c33a9237cedbd6794dfba3ee0aa09ebba8de1ad6a081c2b\">\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=\"Errors and Compatibility - Amplemarket API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to navigate the API responses.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://amplemarket-50.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Errors+and+Compatibility\u0026amp;description=How+to+navigate+the+API+responses.\u0026amp;theme=60393c4a5f19d1b30a9c94f6\u0026amp;signature=911345f6b55f61cc0c33a9237cedbd6794dfba3ee0aa09ebba8de1ad6a081c2b\">\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/amplemarket-50/mca-0KUOMtPMXsSB/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Amplemarket API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111111\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.amplemarket.com/api-reference/errors\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/errors.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.amplemarket.com/#organization\",\"name\":\"Amplemarket API\",\"url\":\"https://docs.amplemarket.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/amplemarket-50/nKiDtQFwoEC-eryS/icons/logo-light.svg?fit=max\u0026auto=format\u0026n=nKiDtQFwoEC-eryS\u0026q=85\u0026s=613c52ac28bd4a2ed1f393bdc4de0e8a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.amplemarket.com#website\",\"name\":\"Amplemarket API\",\"url\":\"https://docs.amplemarket.com\",\"publisher\":{\"@id\":\"https://docs.amplemarket.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.amplemarket.com/api-reference/errors#webpage\",\"url\":\"https://docs.amplemarket.com/api-reference/errors\",\"name\":\"Errors and Compatibility\",\"description\":\"How to navigate the API responses.\",\"dateModified\":\"2025-10-20T12:58:27.762Z\",\"isPartOf\":{\"@id\":\"https://docs.amplemarket.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.amplemarket.com/api-reference/errors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.amplemarket.com/api-reference/errors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.amplemarket.com/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Errors and Compatibility\",\"item\":\"https://docs.amplemarket.com/api-reference/errors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.amplemarket.com/api-reference/errors#article\",\"headline\":\"Errors and Compatibility\",\"name\":\"Errors and Compatibility\",\"description\":\"How to navigate the API responses.\",\"url\":\"https://docs.amplemarket.com/api-reference/errors\",\"mainEntityOfPage\":{\"@id\":\"https://docs.amplemarket.com/api-reference/errors#webpage\"},\"dateModified\":\"2025-10-20T12:58:27.762Z\",\"publisher\":{\"@id\":\"https://docs.amplemarket.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.amplemarket.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Amplemarket API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Amplemarket API","nav":{"global":{"anchors":[{"anchor":"Blog","href":"https://amplemarket.com/blog","icon":"newspaper"},{"anchor":"Status Page","href":"http://status.amplemarket.com","icon":"power-off"},{"anchor":"Knowledge Base","href":"https://knowledge.amplemarket.com","icon":"book-open-cover"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/home"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Links and Pagination","description":"How to navigate the API responses.","href":"/api-reference/pagination"},{"title":"Errors and Compatibility","href":"/api-reference/errors"},{"title":"Supported industries","description":null,"href":"/api-reference/supported-industries"},{"title":"Supported departments","href":"/api-reference/supported-departments"},{"title":"Supported job functions","href":"/api-reference/supported-job-functions"}]},{"group":"Account Details","pages":[{"openapi":"get /account-info","title":"Get account details","href":"/api-reference/account-info"}]},{"group":"Accounts","pages":[{"openapi":"get /accounts","title":"List Accounts","href":"/api-reference/accounts/get-accounts"},{"openapi":"get /accounts/{id}","title":"Retrieve Account","href":"/api-reference/accounts/get-account"}]},{"group":"Users","pages":[{"openapi":"get /users","title":"List users","href":"/api-reference/users/get-users"}]},{"group":"Personas","pages":[{"openapi":"get /personas","title":"List personas","href":"/api-reference/personas/get-personas"}]},{"group":"Territories","pages":[{"openapi":"get /territories","title":"List territories","href":"/api-reference/territories/get-territories"}]},{"group":"Lead List","pages":[{"openapi":"get /lead-lists","title":"List Lead Lists","href":"/api-reference/lead-list/get-lead-lists"},{"openapi":"post /lead-lists","title":"Create Lead List","href":"/api-reference/lead-list/create-lead-list"},{"openapi":"get /lead-lists/{id}","title":"Retrieve Lead List","href":"/api-reference/lead-list/retrieve-lead-list"},{"openapi":"post /lead-lists/{id}/leads","title":"Add Leads to a List","href":"/api-reference/lead-list/add-leads"}]},{"group":"People Enrichment","pages":[{"openapi":"get /people/find","title":"Single person enrichment","href":"/api-reference/people-enrichment/single-person-enrichment"},{"openapi":"post /people/enrichment-requests","title":"Start batch of person enrichments","href":"/api-reference/people-enrichment/start-enrichment-request"},{"openapi":"get /people/enrichment-requests/{id}","title":"Retrieve person enrichment results","href":"/api-reference/people-enrichment/retrieve-enrichment-request-results"},{"openapi":"patch /people/enrichment-requests/{id}","title":"Cancel batch of person enrichments","href":"/api-reference/people-enrichment/cancel-enrichment-request"}]},{"group":"Companies Enrichment","pages":[{"openapi":"get /companies/find","title":"Single company enrichment","href":"/api-reference/companies-enrichment/single-company-enrichment"},{"openapi":"post /companies/enrichment-requests","title":"Start batch of company enrichments","href":"/api-reference/companies-enrichment/start-enrichment-request"},{"openapi":"get /companies/enrichment-requests/{id}","title":"Retrieve company enrichment results","href":"/api-reference/companies-enrichment/retrieve-enrichment-request-results"},{"openapi":"patch /companies/enrichment-requests/{id}","title":"Cancel batch of company enrichments","href":"/api-reference/companies-enrichment/cancel-enrichment-request"}]},{"group":"Searcher","pages":[{"openapi":"post /people/search","title":"Search people","href":"/api-reference/searcher/search-people"},{"openapi":"post /companies/search","title":"Search companies","href":"/api-reference/searcher/search-companies"}]},{"group":"Mailboxes","pages":[{"openapi":"get /mailboxes","title":"List mailboxes","href":"/api-reference/mailboxes/get-mailboxes"},{"openapi":"patch /mailboxes/{id}","title":"Update mailbox daily email limit","href":"/api-reference/mailboxes/update-mailbox"}]},{"group":"Email Validation","pages":[{"openapi":"post /email-validations","title":"Start batch of email validations","href":"/api-reference/email-validation/start-batch-of-email-validations"},{"openapi":"get /email-validations/{id}","title":"Retrieve email validation results","href":"/api-reference/email-validation/retrieve-email-validation-results"},{"openapi":"patch /email-validations/{id}","title":"Cancel batch of email validations","href":"/api-reference/email-validation/cancel-batch-of-email-validations"}]},{"group":"Exclusion lists","pages":[{"openapi":"post /excluded-emails","title":"Create email exclusions","href":"/api-reference/exclusion-lists/create-excluded-emails"},{"openapi":"post /excluded-domains","title":"Create domain exclusions","href":"/api-reference/exclusion-lists/create-excluded_domains"},{"openapi":"delete /excluded-emails","title":"Delete email exclusions","href":"/api-reference/exclusion-lists/delete-excluded-emails"},{"openapi":"delete /excluded-domains","title":"Delete domain exclusions","href":"/api-reference/exclusion-lists/delete-excluded_domains"},{"openapi":"get /excluded-domains","title":"List excluded domains","href":"/api-reference/exclusion-lists/get-excluded-domains"},{"openapi":"get /excluded-emails","title":"List excluded emails","href":"/api-reference/exclusion-lists/get-excluded-emails"}]},{"group":"Sequences","pages":[{"openapi":"get /sequences","title":"List Sequences","href":"/api-reference/sequences/get-sequences"},{"openapi":"post /sequences/{id}/leads","title":"Add leads","href":"/api-reference/sequences/add-leads"}]},{"group":"Calls","pages":[{"openapi":"get /calls","title":"List calls","href":"/api-reference/calls/get-calls"},{"openapi":"post /calls","title":"Log call","href":"/api-reference/calls/create-calls"},{"openapi":"get /calls/dispositions","title":"List dispositions","href":"/api-reference/calls/get-call-dispositions"},{"openapi":"get /calls/{id}/recording","title":"Get call recording","href":"/api-reference/calls/get-call-recording"}]},{"group":"Contacts","pages":[{"openapi":"get /contacts/email/{email}","title":"Retrieve contact by email","href":"/api-reference/contacts/get-contact-by-email"},{"openapi":"get /contacts/{id}","title":"Retrieve contact","href":"/api-reference/contacts/get-contact"},{"openapi":"get /contacts","title":"Retrieve contacts","href":"/api-reference/contacts/get-contacts"},{"openapi":"post /contacts","title":"Create contact","href":"/api-reference/contacts/create-contact"}]},{"group":"Tasks","pages":[{"openapi":"post /tasks/{id}/complete","title":"Complete task","href":"/api-reference/tasks/complete-task"},{"openapi":"get /tasks/statuses","title":"List task statuses","href":"/api-reference/tasks/get-tasks-statuses"},{"openapi":"get /tasks/types","title":"List task types","href":"/api-reference/tasks/get-tasks-types"},{"openapi":"get /tasks","title":"List tasks","href":"/api-reference/tasks/get-tasks"},{"openapi":"post /tasks/{id}/skip","title":"Skip task","href":"/api-reference/tasks/skip-task"}]},{"group":"Phone numbers","pages":[{"openapi":"post /phone_numbers/{id}/review","title":"Review phone number","href":"/api-reference/phone-numbers/review-phone-number"}]},{"group":"Duo","pages":[{"title":"Create Custom Signal Entry","api":"POST https://api.amplemarket.com/custom_signals/{token}/entries","href":"/api-reference/duo/create-custom-signal-entry"}]},{"group":"Job Openings","pages":[{"openapi":"get /job-openings","title":"List Job Openings","href":"/api-reference/job-openings/get-job-openings"},{"openapi":"get /job-openings/{id}","title":"Retrieve Job Opening","href":"/api-reference/job-openings/get-job-opening"}]}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/webhooks/introduction"}]}]},"basePath":"","title":"Errors and Compatibility - Amplemarket API","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":[],"chunks":[]}