Returns the address we saw the request come from, and nothing else.Sent through one of your proxies, the address that comes back is that proxy’s
exit address. That makes this a working test rather than a claim: if the
request arrives at all, the proxy carries traffic, and the address it reports
is the one your targets will see. Sent directly, it reports your own address.Free, and it stores nothing — it does not appear in
List checks. To find out what that address is
worth to a fraud system, pass it to Check an IP address.
Response
string
The address the request arrived from. unknown in the rare case the address
cannot be read at all.
Example
Through a proxy — the useful form. -x gives cURL the proxy to route through,
and the address in the answer is the proxy’s, not yours.
from proxyjam import ProxyJamClientwith ProxyJamClient(api_key="pj_live_...") as proxyjam: result = proxyjam.proxies.check("<order-id>") print(result.ok, result.exit_ip, result.latency_ms)
The Python example uses the SDK’s own
proxy check, which reads the
credentials off the order, sends this request through the proxy and times it.
A proxy that does not answer comes back as ok=False with the reason in
error, because a dead proxy is a result rather than a failed call.Sent directly, with no -x, the same endpoint reports the address you are
calling from:
Too many calls. This endpoint is cheap but not free to serve; space out a retry loop.
Nothing here is billable and no free-check allowance is spent. The allowance
described in Get check quota applies to the paid
reputation check only.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ProxyJam API","description":"API documentation for ProxyJam, a static residential (ISP) proxy service.","colors":{"primary":"#0066FF","light":"#3385FF","dark":"#0047B3"},"logo":{"light":"https://mintcdn.com/proxyjam/kPBTrE2a37c1nnsv/images/logo-light.svg?fit=max\u0026auto=format\u0026n=kPBTrE2a37c1nnsv\u0026q=85\u0026s=de31db4ad6adcfb5d0a552eb56a9ff08","dark":"https://mintcdn.com/proxyjam/kPBTrE2a37c1nnsv/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=kPBTrE2a37c1nnsv\u0026q=85\u0026s=21e0dd5aa2cd0ab837fd9ffd1a6d04a5"},"favicon":"https://mintcdn.com/proxyjam/HIh9JWQwb4C4tepC/favicon.svg?fit=max\u0026auto=format\u0026n=HIh9JWQwb4C4tepC\u0026q=85\u0026s=cc34b466df1e0b4e9c5ed2820e2bac90","api":{"mdx":{"auth":{"method":"key","name":"X-API-Key"},"server":"https://api.proxyjam.com/public/v1"}},"appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"mailto:support@ProxyJam.com","label":"Support"}]},"footer":{"socials":{}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"proxyjam","hasAudioNarration":false,"actualSubdomain":"proxyjam","customDomains":["docs.proxyjam.com"],"gitSource":{"type":"github","owner":"getproxyjam","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b000c0a28dc5e301d81c735","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Browser extension","count":12},{"language":"default","tag":"ProxyJam Connector","count":12},{"language":"default","tag":"Overview","count":11},{"language":"default","tag":"IP reputation","count":6},{"language":"default","tag":"Mobile rotating proxies","count":6},{"language":"default","tag":"Proxy management","count":6},{"language":"default","tag":"Concepts","count":6},{"language":"default","tag":"Orders","count":5},{"language":"default","tag":"Getting started","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"site-roles","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":"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":"editor-metadata","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":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api/ip-check/echo","slug":"/api/ip-check/echo","pageMetadata":{"title":"Check a proxy works","description":"Report the address a request arrived from — send it through a proxy to read that proxy's exit address.","api":"GET /ip-check/echo","href":"/api/ip-check/echo"},"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: \"Report the address a request arrived from — send it through a proxy to read that proxy’s exit address.\"\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`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Returns the address we saw the request come from, and nothing else.`}),`\n`,_jsx(_components.p,{children:`Sent through one of your proxies, the address that comes back is that proxy’s\nexit address. That makes this a working test rather than a claim: if the\nrequest arrives at all, the proxy carries traffic, and the address it reports\nis the one your targets will see. Sent directly, it reports your own address.`}),`\n`,_jsxs(_components.p,{children:[`Free, and it stores nothing — it does not appear in\n`,_jsx(_components.a,{href:`/api/ip-check/list-checks`,children:`List checks`}),`. To find out what that address is\nworth to a fraud system, pass it to `,_jsx(_components.a,{href:`/api/ip-check/check-ip`,children:`Check an IP address`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`ip`,type:`string`,id:`param-ip`,children:_jsxs(_components.p,{children:[`The address the request arrived from. `,_jsx(_components.code,{children:`unknown`}),` in the rare case the address\ncannot be read at all.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsxs(_components.p,{children:[`Through a proxy — the useful form. `,_jsx(_components.code,{children:`-x`}),` gives cURL the proxy to route through,\nand the address in the answer is the proxy’s, not yours.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`3`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -x`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` http://`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`usernam`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`passwor`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`@`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`hos`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`t`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`por`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`t`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.proxyjam.com/public/v1/ip-check/echo`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: pj_AbCdEf...\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`5`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` proxyjam `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ProxyJamClient`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`with`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ProxyJamClient(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`api_key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pj_live_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`as`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` proxyjam:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` proxyjam.proxies.check(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003corder-id>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(result.ok, result.exit_ip, result.latency_ms)`})]}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`The Python example uses the SDK’s own\n`,_jsx(_components.a,{href:`https://github.com/getproxyjam/clients`,children:`proxy check`}),`, which reads the\ncredentials off the order, sends this request through the proxy and times it.\nA proxy that does not answer comes back as `,_jsx(_components.code,{children:`ok=False`}),` with the reason in\n`,_jsx(_components.code,{children:`error`}),`, because a dead proxy is a result rather than a failed call.`]}),`\n`,_jsxs(_components.p,{children:[`Sent directly, with no `,_jsx(_components.code,{children:`-x`}),`, the same endpoint reports the address you are\ncalling from:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.proxyjam.com/public/v1/ip-check/echo`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: pj_AbCdEf...\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`No credential, or one we do not recognise.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:`Too many calls. This endpoint is cheap but not free to serve; space out a retry loop.`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Nothing here is billable and no free-check allowance is spent. The allowance\ndescribed in `,_jsx(_components.a,{href:`/api/ip-check/get-quota`,children:`Get check quota`}),` applies to the paid\nreputation check only.`]})})]})}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":"Check a proxy works","description":"Report the address a request arrived from — send it through a proxy to read that proxy's exit address.","api":"GET /ip-check/echo","href":"/api/ip-check/echo"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Check a proxy works","path":"/ip-check/echo","servers":[{"url":"https://api.proxyjam.com/public/v1"}],"method":"get","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"X-API-Key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"ip":[{"type":"string","description":"The address the request arrived from. `unknown` in the rare case the address cannot be read at all."}]}}],"examples":{"example":{"value":{"ip":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"proxyjam","siteName":"ProxyJam API","title":"Check a proxy works - ProxyJam API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-28T04:22:48.437Z","originalFileLocation":"api/ip-check/echo.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=\"Report the address a request arrived from — send it through a proxy to read that proxy\u0026#x27;s exit address.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ProxyJam 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/proxyjam/v6IlxhSulm7dlRBE/_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/proxyjam/v6IlxhSulm7dlRBE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/proxyjam/v6IlxhSulm7dlRBE/_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/proxyjam/v6IlxhSulm7dlRBE/_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/proxyjam/v6IlxhSulm7dlRBE/_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/proxyjam/v6IlxhSulm7dlRBE/_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/proxyjam/v6IlxhSulm7dlRBE/_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/proxyjam/v6IlxhSulm7dlRBE/_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/proxyjam/v6IlxhSulm7dlRBE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Check a proxy works - ProxyJam API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Report the address a request arrived from — send it through a proxy to read that proxy\u0026#x27;s exit address.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ProxyJam API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.proxyjam.com/api/ip-check/echo\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://proxyjam.mintlify.site/_mintlify/api/og/v2?division=IP+reputation\u0026amp;title=Check+a+proxy+works\u0026amp;description=Report+the+address+a+request+arrived+from+%E2%80%94+send+it+through+a+proxy+to+read+that+proxy%27s+exit+address.\u0026amp;theme=cdf72b5050cc6fcb9115fdd8\u0026amp;signature=591bf227adcab0d6a0b07938b96ad1c7860586fc6d2c8c65d3943b6baecb67a6\">\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=\"Check a proxy works - ProxyJam API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Report the address a request arrived from — send it through a proxy to read that proxy\u0026#x27;s exit address.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://proxyjam.mintlify.site/_mintlify/api/og/v2?division=IP+reputation\u0026amp;title=Check+a+proxy+works\u0026amp;description=Report+the+address+a+request+arrived+from+%E2%80%94+send+it+through+a+proxy+to+read+that+proxy%27s+exit+address.\u0026amp;theme=cdf72b5050cc6fcb9115fdd8\u0026amp;signature=591bf227adcab0d6a0b07938b96ad1c7860586fc6d2c8c65d3943b6baecb67a6\">\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/proxyjam/v6IlxhSulm7dlRBE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ProxyJam API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.proxyjam.com/api/ip-check/echo\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/ip-check/echo.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.proxyjam.com/#organization\",\"name\":\"ProxyJam API\",\"url\":\"https://docs.proxyjam.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/proxyjam/kPBTrE2a37c1nnsv/images/logo-light.svg?fit=max\u0026auto=format\u0026n=kPBTrE2a37c1nnsv\u0026q=85\u0026s=de31db4ad6adcfb5d0a552eb56a9ff08\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.proxyjam.com#website\",\"name\":\"ProxyJam API\",\"url\":\"https://docs.proxyjam.com\",\"publisher\":{\"@id\":\"https://docs.proxyjam.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.proxyjam.com/api/ip-check/echo#webpage\",\"url\":\"https://docs.proxyjam.com/api/ip-check/echo\",\"name\":\"Check a proxy works\",\"description\":\"Report the address a request arrived from — send it through a proxy to read that proxy's exit address.\",\"dateModified\":\"2026-09-28T04:22:48.437Z\",\"isPartOf\":{\"@id\":\"https://docs.proxyjam.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.proxyjam.com/api/ip-check/echo#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.proxyjam.com/api/ip-check/echo#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"IP reputation\",\"item\":\"https://docs.proxyjam.com/api/ip-check/check-ip\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Check a proxy works\",\"item\":\"https://docs.proxyjam.com/api/ip-check/echo\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.proxyjam.com/api/ip-check/echo#apireference\",\"headline\":\"Check a proxy works\",\"name\":\"Check a proxy works\",\"description\":\"Report the address a request arrived from — send it through a proxy to read that proxy's exit address.\",\"url\":\"https://docs.proxyjam.com/api/ip-check/echo\",\"mainEntityOfPage\":{\"@id\":\"https://docs.proxyjam.com/api/ip-check/echo#webpage\"},\"dateModified\":\"2026-09-28T04:22:48.437Z\",\"publisher\":{\"@id\":\"https://docs.proxyjam.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.proxyjam.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ProxyJam API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ProxyJam API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/ip-check/echo.md","siteName":"ProxyJam API","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/overview/introduction"}]},{"tab":"API Reference","groups":[{"group":"Account","pages":[{"title":"Get current user","api":"GET /users/me","href":"/api/auth/me"},{"title":"List wallets","api":"GET /wallets","href":"/api/account/list-wallets"}]},{"group":"Catalog","pages":[{"title":"List proxy offers","api":"GET /catalog","href":"/api/catalog/list-offers"}]},{"group":"Orders","pages":[{"title":"Create order","api":"POST /orders","href":"/api/orders/create-order"},{"title":"List orders","api":"GET /orders","href":"/api/orders/list-orders"},{"title":"Get order","api":"GET /orders/{order_id}","href":"/api/orders/get-order"},{"title":"Get order traffic usage","api":"GET /orders/{order_id}/traffic-usage","href":"/api/orders/get-order-traffic-usage"},{"title":"Get traffic usage summary","api":"GET /orders/traffic-usage/summary","href":"/api/orders/get-traffic-usage-summary"}]},{"group":"Proxy management","pages":[{"title":"Set auto-renew","api":"POST /orders/{order_id}/auto-renew","href":"/api/orders/proxy-auto-renew"},{"title":"Extend proxy","api":"POST /orders/{order_id}/extend","href":"/api/orders/proxy-extend"},{"title":"Buy bandwidth","api":"POST /orders/{order_id}/bandwidth","href":"/api/orders/proxy-bandwidth"},{"title":"Update IP allowlist","api":"PUT /orders/{order_id}/whitelist","href":"/api/orders/proxy-whitelist"},{"title":"Sync proxy state","api":"POST /orders/{order_id}/sync","href":"/api/orders/proxy-sync"},{"title":"Change proxy protocol","api":"POST /orders/{order_id}/protocol","href":"/api/orders/proxy-change-protocol"}]},{"group":"Mobile rotating proxies","pages":[{"title":"Reset proxy IP","api":"POST /orders/{order_id}/reset","href":"/api/mobile/reset-proxy-ip"},{"title":"Update proxy credentials","api":"POST /orders/{order_id}/credentials","href":"/api/mobile/update-proxy-credentials"},{"title":"Change proxy signature","api":"POST /orders/{order_id}/signature","href":"/api/mobile/change-proxy-signature"},{"title":"Update proxy tags","api":"POST /orders/{order_id}/tags","href":"/api/mobile/update-proxy-tags"},{"title":"Release proxy","api":"POST /orders/{order_id}/release","href":"/api/mobile/release-proxy"},{"title":"List proxy signatures","api":"GET /orders/mobile-signatures","href":"/api/mobile/list-signatures"}]},{"group":"Wallet","pages":[{"title":"Get wallet balance","api":"GET /wallet/balance","href":"/api/wallet/balance"},{"title":"List transactions","api":"GET /wallet/transactions","href":"/api/wallet/transactions"},{"title":"Get transaction","api":"GET /wallet/transactions/{transaction_id}","href":"/api/wallet/get-transaction"}]},{"group":"IP reputation","pages":[{"title":"Check an IP address","api":"POST /ip-check","href":"/api/ip-check/check-ip"},{"title":"Compare every source","description":"What each reputation source says about one address, side by side, for free.","api":"POST /ip-check/sources","href":"/api/ip-check/sources"},{"title":"Check a proxy works","api":"GET /ip-check/echo","href":"/api/ip-check/echo"},{"title":"Get check quota","description":"How many free IP checks are left, and what a paid one costs.","api":"GET /ip-check/quota","href":"/api/ip-check/get-quota"},{"title":"List checks","api":"GET /ip-check","href":"/api/ip-check/list-checks"},{"title":"Get a check","api":"GET /ip-check/{check_id}","href":"/api/ip-check/get-check"}]}]},{"tab":"MCP server","pages":[{"title":"MCP server","href":"/mcp-server"}]},{"tab":"Browser extension","pages":[{"title":"Browser extension","href":"/extension"}]}]},"basePath":"","title":"Check a proxy works - ProxyJam API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}