Returns the discovery’s current state, and once it has finished either the coverages found or the reason the payer network could not answer. The two shapes never mix.
A finished discovery with coverages_found: 0 is a normal answer — the patient may have no coverage to find.
Wait retry_after_ms between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused.
Each entry in coverages is a coverage in the same shape a verification’s result publishes, so one parser reads both answers.
Not yet enabled on the production edge. This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it.
Service (M2M) access token issued by POST /auth/token using the client_credentials grant. Required scopes, where known, are listed on each operation below.
Scopes
eligibility:read
Path Parameters
id
string<uuid>
required
The id returned when the check was submitted. Distinct from request_id, which identifies a single HTTP call.
Response
The discovery's current state.
data
object
required
A discovery and, once it has finished, either the coverages found or the reason the payer network could not answer. The two shapes never mix: an answered discovery carries coverages and no failure, a refused one carries failure_status and nothing about coverage.
Quote id, or the envelope's request_id, when you ask us about a check.
Show child attributes
request_id
string
required
Example:
"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Partners API Documentation","colors":{"primary":"#e34376","light":"#e55484","dark":"#e3235f"},"logo":{"light":"https://mintcdn.com/openloop/uFqnU7STc2L-iY-j/logo/openloop_light.png?fit=max\u0026auto=format\u0026n=uFqnU7STc2L-iY-j\u0026q=85\u0026s=36c08284ca501fdefe4311339c563474","dark":"https://mintcdn.com/openloop/uFqnU7STc2L-iY-j/logo/openloop_dark.png?fit=max\u0026auto=format\u0026n=uFqnU7STc2L-iY-j\u0026q=85\u0026s=81c334cb0ffc5f63a9595a1d611595ce"},"favicon":"https://mintcdn.com/openloop/uFqnU7STc2L-iY-j/favicon.ico?fit=max\u0026auto=format\u0026n=uFqnU7STc2L-iY-j\u0026q=85\u0026s=7be86b4f76e18b47229f3b8646ba3fa2","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"https://openloophealth.com","label":"OpenLoop Health"}],"primary":{"type":"button","label":"Get Started","href":"https://openloophealth.com/contact"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/openloophealth"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"OpenLoop Health","icon":"globe","href":"https://openloophealth.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openloop","hasAudioNarration":false,"actualSubdomain":"openloop","customDomains":[],"gitSource":{"type":"github","owner":"openloophealth","repo":"patient-zero-openloop-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aff28baca43cd0248039897","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":130},{"language":"default","tag":"Partner Cookbook","count":24},{"language":"default","tag":"Scheduling","count":9},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Subscriptions","count":8},{"language":"default","tag":"Auth","count":7},{"language":"default","tag":"Billing Customers","count":7},{"language":"default","tag":"Eligibility","count":7},{"language":"default","tag":"When things go wrong","count":6},{"language":"default","tag":"Users","count":6}]},"assistantConfig":{},"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":"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-reference/eligibility/retrieve-an-insurance-discovery","slug":"/api-reference/eligibility/retrieve-an-insurance-discovery","pageMetadata":{"title":"Retrieve an insurance discovery","description":"Returns the discovery's current state, and once it has finished either the coverages found or the reason the payer network could not answer. **The two shapes never mix.**\n\nA finished discovery with `coverages_found: 0` is a normal answer — the patient may have no coverage to find.\n\nWait `retry_after_ms` between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused.\n\nEach entry in `coverages` is a coverage in the same shape a verification's `result` publishes, so one parser reads both answers.\n\n**Not yet enabled on the production edge.** This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it.\n\n**Permissions:** `eligibility:read`","deprecated":null,"version":null,"openapi":"/openapi.json get /insurance-discoveries/{id}","href":"/api-reference/eligibility/retrieve-an-insurance-discovery","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Returns the discovery’s current state, and once it has finished either the coverages found or the reason the payer network could not answer. \", _jsx(_components.strong, {\n children: \"The two shapes never mix.\"\n })]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A finished discovery with \", _jsx(_components.code, {\n children: \"coverages_found: 0\"\n }), \" is a normal answer — the patient may have no coverage to find.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Wait \", _jsx(_components.code, {\n children: \"retry_after_ms\"\n }), \" between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Each entry in \", _jsx(_components.code, {\n children: \"coverages\"\n }), \" is a coverage in the same shape a verification’s \", _jsx(_components.code, {\n children: \"result\"\n }), \" publishes, so one parser reads both answers.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Not yet enabled on the production edge.\"\n }), \" This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Permissions:\"\n }), \" \", _jsx(_components.code, {\n children: \"eligibility:read\"\n })]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retrieve an insurance discovery","description":"Returns the discovery's current state, and once it has finished either the coverages found or the reason the payer network could not answer. **The two shapes never mix.**\n\nA finished discovery with `coverages_found: 0` is a normal answer — the patient may have no coverage to find.\n\nWait `retry_after_ms` between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused.\n\nEach entry in `coverages` is a coverage in the same shape a verification's `result` publishes, so one parser reads both answers.\n\n**Not yet enabled on the production edge.** This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it.\n\n**Permissions:** `eligibility:read`","deprecated":null,"version":null,"openapi":"/openapi.json get /insurance-discoveries/{id}","href":"/api-reference/eligibility/retrieve-an-insurance-discovery","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Retrieve an insurance discovery","description":"Returns the discovery's current state, and once it has finished either the coverages found or the reason the payer network could not answer. **The two shapes never mix.**\n\nA finished discovery with `coverages_found: 0` is a normal answer — the patient may have no coverage to find.\n\nWait `retry_after_ms` between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused.\n\nEach entry in `coverages` is a coverage in the same shape a verification's `result` publishes, so one parser reads both answers.\n\n**Not yet enabled on the production edge.** This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it.\n\n**Permissions:** `eligibility:read`","tags":["Eligibility"],"security":["d601df54-ffbf-4635-bd65-a2bfd4d2b082"],"parameters":["c278a8dd-5472-41e6-9d88-2b0a65b6649f"],"responses":{"200":"a2be6045-1a59-4923-8231-8b6e081cf349","400":"d4a1c5d5-037b-4005-8e92-3db0e1dc7549","401":"4478897a-0f9b-465d-8890-c2761089fb02","403":"f902b292-f166-43b0-b0b2-e4d79bcc0295","404":"35197671-6393-4818-8e93-0a9da5d32d62","429":"4100a757-531a-49de-893a-1a8f78cee79d","500":"60d49c99-89b8-45e4-ba03-2a1e5ca6f617"},"method":"get","type":"path","servers":["c242b877-71eb-4138-9d4e-930ddd911326","538c36be-4e83-42ab-98cd-fcf6de7f10e5"],"path":"/insurance-discoveries/{id}","baseUrlOptions":["https://api.openloophealth.com/v0.1","https://api-staging.openloophealth.com/v0.1"],"title":"Retrieve an insurance discovery","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c278a8dd-5472-41e6-9d88-2b0a65b6649f":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The id returned when the check was submitted. Distinct from `request_id`, which identifies a single HTTP call.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"The id returned when the check was submitted. Distinct from `request_id`, which identifies a single HTTP call."}},"responses":{"a2be6045-1a59-4923-8231-8b6e081cf349":{"description":"The discovery's current state.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["id","status"],"description":"A discovery and, once it has finished, either the coverages found or the reason the payer network could not answer. **The two shapes never mix**: an answered discovery carries `coverages` and no failure, a refused one carries `failure_status` and nothing about coverage.\n\nQuote `id`, or the envelope's `request_id`, when you ask us about a check.","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["PENDING","COMPLETE","TIMEOUT","FAILED"],"description":"The same four states the verification endpoint reports, with the same meanings. `FAILED` means resubmitting the same check cannot help; `TIMEOUT` means it may.","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"retry_after_ms":{"type":"integer","description":"Milliseconds to wait before polling again, present only while the check can still change. It backs off 500, 1000, 2000, 4000 then 5000, and it is enforced rather than advised: a poll inside the interval is a 429. It appears on no submit response, because the first poll is never refused.","example":500,"uniqueKey":"data.retry_after_ms","typeLabel":"integer"},"coverages_found":{"type":"integer","description":"How many coverages the payer network returned. `0` is a normal answer — the patient may have none to find.","example":1,"uniqueKey":"data.coverages_found","typeLabel":"integer"},"coverages":{"type":"array","description":"Each entry is a coverage in the same shape a verification's `result` publishes, so one parser reads both.","items":{"type":"object","required":["benefits"],"description":"One coverage. An insurance discovery returns an array of these, and a verification's `result` carries the same `payer` / `plan` / `group` / `benefits` fields with the same meanings, so one parser reads both answers.","properties":{"benefits":{"type":"array","items":{"type":"object","required":["network_status","copay","coinsurance","deductible","out_of_pocket"],"description":"The cost shares for one network. One entry per network; a network the payer quoted nothing for has no entry at all.","properties":{"network_status":{"type":"string","enum":["IN NETWORK","OUT OF NETWORK"],"description":"Whether the cost shares below apply in or out of network.","isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].network_status","typeLabel":"enum\u003cstring>"},"copay":{"oneOf":[{"type":"number","description":"Dollar amount per visit.","example":25,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].copay.oneOf.0","typeLabel":"number"},{"type":"null","description":"Dollar amount per visit.","example":25,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].copay.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].copay","typeLabel":"number | null"},"coinsurance":{"oneOf":[{"type":"number","description":"**A fraction, not a percentage** — `0.1` is 10%.","example":0.1,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].coinsurance.oneOf.0","typeLabel":"number"},{"type":"null","description":"**A fraction, not a percentage** — `0.1` is 10%.","example":0.1,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].coinsurance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].coinsurance","typeLabel":"number | null"},"deductible":{"type":"object","required":["individual","family"],"description":"The same accumulator at both scopes the payer quotes it at. Both keys are always present and either may be all `null`, so you never read a coverage-level code to work out which of the two a number belongs to.","properties":{"individual":{"type":"object","required":["total","remaining"],"description":"A running total the payer quoted. `null` means the payer did not report it, which is not the same as zero.","properties":{"total":{"oneOf":[{"type":"number","example":1500,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.individual.total.oneOf.0","typeLabel":"number"},{"type":"null","example":1500,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.individual.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.individual.total","typeLabel":"number | null"},"remaining":{"oneOf":[{"type":"number","example":400,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.individual.remaining.oneOf.0","typeLabel":"number"},{"type":"null","example":400,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.individual.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.individual.remaining","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.individual","typeLabel":"object"},"family":{"type":"object","required":["total","remaining"],"description":"A running total the payer quoted. `null` means the payer did not report it, which is not the same as zero.","properties":{"total":{"oneOf":[{"type":"number","example":1500,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.family.total.oneOf.0","typeLabel":"number"},{"type":"null","example":1500,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.family.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.family.total","typeLabel":"number | null"},"remaining":{"oneOf":[{"type":"number","example":400,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.family.remaining.oneOf.0","typeLabel":"number"},{"type":"null","example":400,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.family.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.family.remaining","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible.family","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].deductible","typeLabel":"object"},"out_of_pocket":{"type":"object","required":["individual","family"],"description":"The same accumulator at both scopes the payer quotes it at. Both keys are always present and either may be all `null`, so you never read a coverage-level code to work out which of the two a number belongs to.","properties":{"individual":{"type":"object","required":["total","remaining"],"description":"A running total the payer quoted. `null` means the payer did not report it, which is not the same as zero.","properties":{"total":{"oneOf":[{"type":"number","example":1500,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.individual.total.oneOf.0","typeLabel":"number"},{"type":"null","example":1500,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.individual.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.individual.total","typeLabel":"number | null"},"remaining":{"oneOf":[{"type":"number","example":400,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.individual.remaining.oneOf.0","typeLabel":"number"},{"type":"null","example":400,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.individual.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.individual.remaining","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.individual","typeLabel":"object"},"family":{"type":"object","required":["total","remaining"],"description":"A running total the payer quoted. `null` means the payer did not report it, which is not the same as zero.","properties":{"total":{"oneOf":[{"type":"number","example":1500,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.family.total.oneOf.0","typeLabel":"number"},{"type":"null","example":1500,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.family.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.family.total","typeLabel":"number | null"},"remaining":{"oneOf":[{"type":"number","example":400,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.family.remaining.oneOf.0","typeLabel":"number"},{"type":"null","example":400,"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.family.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.family.remaining","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket.family","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX].out_of_pocket","typeLabel":"object"}},"uniqueKey":"data.coverages.items.[INDEX].benefits.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].benefits","typeLabel":"object[]"},"payer":{"type":"object","properties":{"name":{"type":"string","example":"Aetna","uniqueKey":"data.coverages.items.[INDEX].payer.name","typeLabel":"string"}},"uniqueKey":"data.coverages.items.[INDEX].payer","typeLabel":"object"},"plan":{"type":"object","description":"A plan and its coverage window. `active` is reported only where the operation establishes it — on a verification the verdict is `status`, not a field of the plan.","properties":{"active":{"type":"boolean","uniqueKey":"data.coverages.items.[INDEX].plan.active","typeLabel":"boolean"},"name":{"type":"string","example":"PPO Gold","uniqueKey":"data.coverages.items.[INDEX].plan.name","typeLabel":"string"},"number":{"type":"string","uniqueKey":"data.coverages.items.[INDEX].plan.number","typeLabel":"string"},"insurance_type_code":{"type":"string","description":"X12 insurance type, such as `HM`, `PR` or `MA`.","uniqueKey":"data.coverages.items.[INDEX].plan.insurance_type_code","typeLabel":"string"},"start_date":{"type":"string","description":"Start of the coverage window. Normally `YYYY-MM-DD`. A value the payer reports in some other form — `ONGOING`, say — is passed through as received rather than dropped, so this is a plain string rather than a date: check it before parsing it.","example":"2026-01-01","uniqueKey":"data.coverages.items.[INDEX].plan.start_date","typeLabel":"string"},"end_date":{"type":"string","description":"End of the coverage window. See `start_date`.","example":"2026-12-31","uniqueKey":"data.coverages.items.[INDEX].plan.end_date","typeLabel":"string"},"network_id":{"type":"string","uniqueKey":"data.coverages.items.[INDEX].plan.network_id","typeLabel":"string"}},"uniqueKey":"data.coverages.items.[INDEX].plan","typeLabel":"object"},"group":{"type":"object","properties":{"number":{"type":"string","uniqueKey":"data.coverages.items.[INDEX].group.number","typeLabel":"string"},"name":{"type":"string","uniqueKey":"data.coverages.items.[INDEX].group.name","typeLabel":"string"}},"uniqueKey":"data.coverages.items.[INDEX].group","typeLabel":"object"},"subscriber":{"type":"object","description":"The policyholder on the coverage that was found, who is not always the patient: a discovery turns up policies held by a spouse or a parent. `member_id` sits on whoever holds the policy.","properties":{"first_name":{"type":"string","example":"Erica","uniqueKey":"data.coverages.items.[INDEX].subscriber.first_name","typeLabel":"string"},"middle_name":{"type":"string","uniqueKey":"data.coverages.items.[INDEX].subscriber.middle_name","typeLabel":"string"},"last_name":{"type":"string","example":"McDaniel","uniqueKey":"data.coverages.items.[INDEX].subscriber.last_name","typeLabel":"string"},"date_of_birth":{"type":"string","example":"1991-04-27","uniqueKey":"data.coverages.items.[INDEX].subscriber.date_of_birth","typeLabel":"string"},"gender":{"type":"string","example":"F","uniqueKey":"data.coverages.items.[INDEX].subscriber.gender","typeLabel":"string"},"member_id":{"type":"string","example":"W123456789","uniqueKey":"data.coverages.items.[INDEX].subscriber.member_id","typeLabel":"string"},"relation_to_subscriber":{"type":"string","example":"Spouse","uniqueKey":"data.coverages.items.[INDEX].subscriber.relation_to_subscriber","typeLabel":"string"},"relation_to_subscriber_code":{"type":"string","example":"01","uniqueKey":"data.coverages.items.[INDEX].subscriber.relation_to_subscriber_code","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.coverages.items.[INDEX].subscriber","typeLabel":"object"},"dependent":{"type":"object","description":"Present when the payer matched the patient as a dependent on the policy above. Its absence means the patient is the subscriber — the difference between billing under their own member id and someone else's.","properties":{"first_name":{"type":"string","example":"Erica","uniqueKey":"data.coverages.items.[INDEX].dependent.first_name","typeLabel":"string"},"middle_name":{"type":"string","uniqueKey":"data.coverages.items.[INDEX].dependent.middle_name","typeLabel":"string"},"last_name":{"type":"string","example":"McDaniel","uniqueKey":"data.coverages.items.[INDEX].dependent.last_name","typeLabel":"string"},"date_of_birth":{"type":"string","example":"1991-04-27","uniqueKey":"data.coverages.items.[INDEX].dependent.date_of_birth","typeLabel":"string"},"gender":{"type":"string","example":"F","uniqueKey":"data.coverages.items.[INDEX].dependent.gender","typeLabel":"string"},"member_id":{"type":"string","example":"W123456789","uniqueKey":"data.coverages.items.[INDEX].dependent.member_id","typeLabel":"string"},"relation_to_subscriber":{"type":"string","example":"Spouse","uniqueKey":"data.coverages.items.[INDEX].dependent.relation_to_subscriber","typeLabel":"string"},"relation_to_subscriber_code":{"type":"string","example":"01","uniqueKey":"data.coverages.items.[INDEX].dependent.relation_to_subscriber_code","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.coverages.items.[INDEX].dependent","typeLabel":"object"},"confidence":{"type":"object","required":["level"],"description":"An assessment of how well the patient matched this coverage.","properties":{"level":{"type":"string","example":"HIGH","isRequired":true,"uniqueKey":"data.coverages.items.[INDEX].confidence.level","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"data.coverages.items.[INDEX].confidence.reason","typeLabel":"string"}},"uniqueKey":"data.coverages.items.[INDEX].confidence","typeLabel":"object"}},"uniqueKey":"data.coverages.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.coverages","typeLabel":"object[]"},"failure_status":{"type":"string","description":"Present only when the payer network could not answer. Same vocabulary as a verification's `result.status`, so branch on the family before the first `.`.","example":"error.member.name","uniqueKey":"data.failure_status","typeLabel":"string"},"failure_reason":{"type":"string","description":"Finer than `failure_status`, and drawn from the same closed set a verification's `status_reason` uses.","example":"error.member.not_found","uniqueKey":"data.failure_reason","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"request_id":{"type":"string","example":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["data","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"PENDING","retry_after_ms":500,"coverages_found":1,"coverages":[{"benefits":[{"network_status":"IN NETWORK","copay":25,"coinsurance":0.1,"deductible":{"individual":{"total":1500,"remaining":400},"family":{"total":1500,"remaining":400}},"out_of_pocket":{"individual":{"total":1500,"remaining":400},"family":{"total":1500,"remaining":400}}}],"payer":{"name":"Aetna"},"plan":{"active":true,"name":"PPO Gold","number":"\u003cstring>","insurance_type_code":"\u003cstring>","start_date":"2026-01-01","end_date":"2026-12-31","network_id":"\u003cstring>"},"group":{"number":"\u003cstring>","name":"\u003cstring>"},"subscriber":{"first_name":"Erica","middle_name":"\u003cstring>","last_name":"McDaniel","date_of_birth":"1991-04-27","gender":"F","member_id":"W123456789","relation_to_subscriber":"Spouse","relation_to_subscriber_code":"01"},"dependent":{"first_name":"Erica","middle_name":"\u003cstring>","last_name":"McDaniel","date_of_birth":"1991-04-27","gender":"F","member_id":"W123456789","relation_to_subscriber":"Spouse","relation_to_subscriber_code":"01"},"confidence":{"level":"HIGH","reason":"\u003cstring>"}}],"failure_status":"error.member.name","failure_reason":"error.member.not_found"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"}}},"exampleType":"generated"}},"exampleType":"generated"},"d4a1c5d5-037b-4005-8e92-3db0e1dc7549":{"description":"The path carried no id.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"error_code":{"type":"string","isRequired":true,"uniqueKey":"error.error_code","typeLabel":"string"}},"required":["message","error_code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Missing id","error_code":"BAD_REQUEST"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Missing id","error_code":"BAD_REQUEST"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"}}},"exampleType":"examples"}},"exampleType":"examples"},"4478897a-0f9b-465d-8890-c2761089fb02":{"description":"Missing or invalid access token.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"error_code":{"type":"string","isRequired":true,"uniqueKey":"error.error_code","typeLabel":"string"}},"required":["message","error_code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","error_code":"\u003cstring>"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f902b292-f166-43b0-b0b2-e4d79bcc0295":{"description":"Missing the `eligibility:read` permission, or insurance discovery is disabled. Read `error.message` to tell the two apart.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"error_code":{"type":"string","isRequired":true,"uniqueKey":"error.error_code","typeLabel":"string"}},"required":["message","error_code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"insufficient_permissions","error_code":"FORBIDDEN"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"insufficient_permissions","error_code":"FORBIDDEN"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"}}},"exampleType":"examples"}},"exampleType":"examples"},"35197671-6393-4818-8e93-0a9da5d32d62":{"description":"Unknown check id.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"error_code":{"type":"string","isRequired":true,"uniqueKey":"error.error_code","typeLabel":"string"}},"required":["message","error_code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Discovery not found: 1a9f0b7c-8e4d-4f6a-9d3b-2c5e7a8f1b04","error_code":"NOT_FOUND"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Discovery not found: 1a9f0b7c-8e4d-4f6a-9d3b-2c5e7a8f1b04","error_code":"NOT_FOUND"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"}}},"exampleType":"examples"}},"exampleType":"examples"},"4100a757-531a-49de-893a-1a8f78cee79d":{"description":"Too many requests: a poll inside the interval the previous read reported, a throttled request, or exhausted shared real-time capacity. The message is the same on every eligibility endpoint and names no duration, because the window behind each of those differs. Back off and retry.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"error_code":{"type":"string","isRequired":true,"uniqueKey":"error.error_code","typeLabel":"string"}},"required":["message","error_code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Too many requests. Retry later.","error_code":"TOO_MANY_REQUESTS"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Too many requests. Retry later.","error_code":"TOO_MANY_REQUESTS"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"}}},"exampleType":"examples"}},"exampleType":"examples"},"60d49c99-89b8-45e4-ba03-2a1e5ca6f617":{"description":"Something failed that names no cause. `error_code` is always `UNHANDLED_EXCEPTION` and the message is fixed prose — quote `request_id` to support.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"error_code":{"type":"string","isRequired":true,"uniqueKey":"error.error_code","typeLabel":"string"}},"required":["message","error_code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Internal server error","error_code":"UNHANDLED_EXCEPTION"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Internal server error","error_code":"UNHANDLED_EXCEPTION"},"request_id":"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d601df54-ffbf-4635-bd65-a2bfd4d2b082":{"serviceToken":{"type":"oauth2","description":"Service (M2M) access token issued by POST /auth/token using the client_credentials grant. Required scopes, where known, are listed on each operation below.","flows":{"clientCredentials":{"tokenUrl":"https://api.openloophealth.com/v0.1/auth/token","scopes":{}}},"scopes":["eligibility:read"],"schemeName":"serviceToken"}}},"servers":{"c242b877-71eb-4138-9d4e-930ddd911326":{"url":"https://api.openloophealth.com/v0.1","description":"Production partner edge"},"538c36be-4e83-42ab-98cd-fcf6de7f10e5":{"url":"https://api-staging.openloophealth.com/v0.1","description":"Staging partner edge (sandbox credentials)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"Service (M2M) access token issued by POST /auth/token using the client_credentials grant. Required scopes, where known, are listed on each operation below.","flows":{"clientCredentials":{"tokenUrl":"https://api.openloophealth.com/v0.1/auth/token","scopes":{}}},"scopes":["eligibility:read"],"schemeName":"serviceToken"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Service (M2M) access token issued by POST /auth/token using the client_credentials grant. Required scopes, where known, are listed on each operation below.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"serviceToken","name":"Authorization"}],"title":"serviceToken"}]},"originalFileLocation":"openapi.json"},"subdomain":"openloop","siteName":"Partners API Documentation","title":"Retrieve an insurance discovery - Partners API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T16:50:11.608Z","originalFileLocation":"api-reference/eligibility/retrieve-an-insurance-discovery.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=\"Returns the discovery\u0026#x27;s current state, and once it has finished either the coverages found or the reason the payer network could not answer. The two shapes never mix. A finished discovery with coverages_found: 0 is a normal answer — the patient may have no coverage to find. Wait retry_after_ms between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused. Each entry in coverages is a coverage in the same shape a verification\u0026#x27;s result publishes, so one parser reads both answers. Not yet enabled on the production edge. This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it. Permissions: eligibility:read\">\u003cmeta data-mint-head name=\"application-name\" content=\"Partners 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/openloop/LIC2QTmC6gcwcygU/_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/openloop/LIC2QTmC6gcwcygU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openloop/LIC2QTmC6gcwcygU/_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/openloop/LIC2QTmC6gcwcygU/_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/openloop/LIC2QTmC6gcwcygU/_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/openloop/LIC2QTmC6gcwcygU/_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/openloop/LIC2QTmC6gcwcygU/_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/openloop/LIC2QTmC6gcwcygU/_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/openloop/LIC2QTmC6gcwcygU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve an insurance discovery - Partners API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the discovery\u0026#x27;s current state, and once it has finished either the coverages found or the reason the payer network could not answer. The two shapes never mix. A finished discovery with coverages_found: 0 is a normal answer — the patient may have no coverage to find. Wait retry_after_ms between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused. Each entry in coverages is a coverage in the same shape a verification\u0026#x27;s result publishes, so one parser reads both answers. Not yet enabled on the production edge. This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it. Permissions: eligibility:read\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Partners API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openloop.mintlify.site/_mintlify/api/og/v2?division=Eligibility\u0026amp;title=Retrieve+an+insurance+discovery\u0026amp;description=Returns+the+discovery%27s+current+state%2C+and+once+it+has+finished+either+the+coverages+found+or+the+reason+the+payer+network+could+not+answer.+**The+two+shapes+ne\u0026amp;theme=c3eb8a84b98e9b697f555ff9\u0026amp;signature=f024e729518cddfc157f097974a45aa194d9d94448e693b72060ef793add6092\">\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=\"Retrieve an insurance discovery - Partners API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the discovery\u0026#x27;s current state, and once it has finished either the coverages found or the reason the payer network could not answer. The two shapes never mix. A finished discovery with coverages_found: 0 is a normal answer — the patient may have no coverage to find. Wait retry_after_ms between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused. Each entry in coverages is a coverage in the same shape a verification\u0026#x27;s result publishes, so one parser reads both answers. Not yet enabled on the production edge. This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it. Permissions: eligibility:read\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openloop.mintlify.site/_mintlify/api/og/v2?division=Eligibility\u0026amp;title=Retrieve+an+insurance+discovery\u0026amp;description=Returns+the+discovery%27s+current+state%2C+and+once+it+has+finished+either+the+coverages+found+or+the+reason+the+payer+network+could+not+answer.+**The+two+shapes+ne\u0026amp;theme=c3eb8a84b98e9b697f555ff9\u0026amp;signature=f024e729518cddfc157f097974a45aa194d9d94448e693b72060ef793add6092\">\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/openloop/LIC2QTmC6gcwcygU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Partners API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#e34376\">\u003clink data-mint-head rel=\"canonical\" href=\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/eligibility/retrieve-an-insurance-discovery.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://openloop.mintlify.app/#organization\",\"name\":\"Partners API Documentation\",\"url\":\"https://openloop.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openloop/uFqnU7STc2L-iY-j/logo/openloop_light.png?fit=max\u0026auto=format\u0026n=uFqnU7STc2L-iY-j\u0026q=85\u0026s=36c08284ca501fdefe4311339c563474\"}},{\"@type\":\"WebSite\",\"@id\":\"https://openloop.mintlify.app#website\",\"name\":\"Partners API Documentation\",\"url\":\"https://openloop.mintlify.app\",\"publisher\":{\"@id\":\"https://openloop.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery#webpage\",\"url\":\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery\",\"name\":\"Retrieve an insurance discovery\",\"description\":\"Returns the discovery's current state, and once it has finished either the coverages found or the reason the payer network could not answer. The two shapes never mix. A finished discovery with coverages_found: 0 is a normal answer — the patient may have no coverage to find. Wait retry_after_ms between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused. Each entry in coverages is a coverage in the same shape a verification's result publishes, so one parser reads both answers. Not yet enabled on the production edge. This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it. Permissions: eligibility:read\",\"dateModified\":\"2026-11-19T16:50:11.608Z\",\"isPartOf\":{\"@id\":\"https://openloop.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Eligibility\",\"item\":\"https://openloop.mintlify.app/api-reference/eligibility/submit-an-eligibility-verification\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve an insurance discovery\",\"item\":\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery#apireference\",\"headline\":\"Retrieve an insurance discovery\",\"name\":\"Retrieve an insurance discovery\",\"description\":\"Returns the discovery's current state, and once it has finished either the coverages found or the reason the payer network could not answer. The two shapes never mix. A finished discovery with coverages_found: 0 is a normal answer — the patient may have no coverage to find. Wait retry_after_ms between polls. Polling sooner while the check can still change answers 429; a check that has since finished returns 200 with its answer instead. The first poll is never refused. Each entry in coverages is a coverage in the same shape a verification's result publishes, so one parser reads both answers. Not yet enabled on the production edge. This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it. Permissions: eligibility:read\",\"url\":\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery\",\"mainEntityOfPage\":{\"@id\":\"https://openloop.mintlify.app/api-reference/eligibility/retrieve-an-insurance-discovery#webpage\"},\"dateModified\":\"2026-11-19T16:50:11.608Z\",\"publisher\":{\"@id\":\"https://openloop.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://openloop.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Partners API Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Partners API Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/eligibility/retrieve-an-insurance-discovery.md","siteName":"Partners API Documentation","nav":{"global":{"anchors":[{"anchor":"OpenLoop Health","icon":"globe","href":"https://openloophealth.com"}]},"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":""}]},{"tab":"Partner Cookbook","pages":[{"title":"Partner Cookbook","href":"/cookbook"}]},{"tab":"API Reference","groups":[{"group":"Guides","pages":[{"title":"API Overview","href":"/api-reference/introduction"},{"title":"Data Standards","mode":"wide","href":"/api-reference/data-standards"},{"title":"Best Practices","href":"/best-practices"},{"title":"Product \u0026 Price IDs","href":"/api-reference/product-and-price-ids"},{"title":"Scheduling","href":"/api-reference/scheduling-guide"},{"title":"Eligibility","href":"/api-reference/eligibility-guide"},{"title":"User Registration","href":"/api-reference/user-registration-guide"},{"title":"How orders are created","href":"/orders/order-model"}]},{"group":"Events","pages":[{"title":"Events","href":"/events"}]},{"group":"Auth","pages":[{"title":"Obtain a service token","openapi":"POST /auth/token","href":"/auth/obtain-token"},{"title":"Register a user","openapi":"post /auth/register","href":"/auth/register"},{"title":"Send a one-time code","openapi":"post /auth/send-otp","href":"/auth/send-otp"},{"title":"Verify a one-time code","openapi":"post /auth/verify-otp","href":"/auth/verify-otp"},{"title":"Exchange a verification code","openapi":"POST /auth/token","href":"/auth/exchange-verification-code"},{"title":"Refresh a token","openapi":"POST /auth/token","href":"/auth/refresh-token"},{"title":"Revoke a session","openapi":"post /auth/revoke","href":"/auth/revoke"}]},{"group":"Users","pages":[{"openapi":"get /iam/users/find","title":"Find a user by email","href":"/users/find-user"},{"title":"Read a user's patient link","openapi":"get /iam/users/links","href":"/users/get-user-link"},{"title":"Delete the current user","openapi":"delete /iam/users/me","href":"/users/delete-user"}]},{"group":"Allergy Intolerances","pages":[{"title":"List allergy intolerances","deprecated":null,"version":null,"openapi":"/openapi.json get /allergy-intolerances","href":"/api-reference/allergy-intolerances/list-allergy-intolerances"},{"title":"Create allergy intolerance","deprecated":null,"version":null,"openapi":"/openapi.json post /allergy-intolerances","href":"/api-reference/allergy-intolerances/create-allergy-intolerance"},{"title":"Get allergy intolerance","deprecated":null,"version":null,"openapi":"/openapi.json get /allergy-intolerances/{id}","href":"/api-reference/allergy-intolerances/get-allergy-intolerance"},{"title":"Update allergy intolerance","deprecated":null,"version":null,"openapi":"/openapi.json put /allergy-intolerances/{id}","href":"/api-reference/allergy-intolerances/update-allergy-intolerance"}]},{"group":"Consents","pages":[{"title":"List consents","deprecated":null,"version":null,"openapi":"/openapi.json get /consents","href":"/api-reference/consents/list-consents"},{"title":"Create consent","deprecated":null,"version":null,"openapi":"/openapi.json post /consents","href":"/api-reference/consents/create-consent"},{"title":"Get consent","deprecated":null,"version":null,"openapi":"/openapi.json get /consents/{id}","href":"/api-reference/consents/get-consent"},{"title":"Update consent","deprecated":null,"version":null,"openapi":"/openapi.json put /consents/{id}","href":"/api-reference/consents/update-consent"}]},{"group":"Document References","pages":[{"title":"List document references","deprecated":null,"version":null,"openapi":"/openapi.json get /document-references","href":"/api-reference/document-references/list-document-references"},{"title":"Create document reference","deprecated":null,"version":null,"openapi":"/openapi.json post /document-references","href":"/api-reference/document-references/create-document-reference"},{"title":"Upload document content","deprecated":null,"version":null,"openapi":"/openapi.json post /document-references/content","href":"/api-reference/document-references/upload-document-content"},{"title":"Get document reference","deprecated":null,"version":null,"openapi":"/openapi.json get /document-references/{id}","href":"/api-reference/document-references/get-document-reference"},{"title":"Update document reference","deprecated":null,"version":null,"openapi":"/openapi.json put /document-references/{id}","href":"/api-reference/document-references/update-document-reference"},{"title":"Get document reference content","deprecated":null,"version":null,"openapi":"/openapi.json get /document-references/{id}/content","href":"/api-reference/document-references/get-document-reference-content"}]},{"group":"Laboratories","pages":[{"title":"Create lab requisition","deprecated":null,"version":null,"openapi":"/openapi.json post /laboratories","href":"/api-reference/laboratories/create-lab-requisition"}]},{"group":"Medication Statements","pages":[{"title":"List medication statements","deprecated":null,"version":null,"openapi":"/openapi.json get /medication-statements","href":"/api-reference/medication-statements/list-medication-statements"},{"title":"Create medication statement","deprecated":null,"version":null,"openapi":"/openapi.json post /medication-statements","href":"/api-reference/medication-statements/create-medication-statement"},{"title":"Get medication statement","deprecated":null,"version":null,"openapi":"/openapi.json get /medication-statements/{id}","href":"/api-reference/medication-statements/get-medication-statement"}]},{"group":"Observations","pages":[{"title":"List observations","deprecated":null,"version":null,"openapi":"/openapi.json get /observations","href":"/api-reference/observations/list-observations"},{"title":"Create observation","deprecated":null,"version":null,"openapi":"/openapi.json post /observations","href":"/api-reference/observations/create-observation"},{"title":"Get observation","deprecated":null,"version":null,"openapi":"/openapi.json get /observations/{id}","href":"/api-reference/observations/get-observation"}]},{"group":"Organizations","pages":[{"title":"Get organization","deprecated":null,"version":null,"openapi":"/openapi.json get /organizations/{id}","href":"/api-reference/organizations/get-organization"}]},{"group":"Patients","pages":[{"title":"List patients","deprecated":null,"version":null,"openapi":"/openapi.json get /patients","href":"/api-reference/patients/list-patients"},{"title":"Create patient","deprecated":null,"version":null,"openapi":"/openapi.json post /patients","href":"/api-reference/patients/create-patient"},{"title":"Get patient","deprecated":null,"version":null,"openapi":"/openapi.json get /patients/{id}","href":"/api-reference/patients/get-patient"},{"title":"Update patient","deprecated":null,"version":null,"openapi":"/openapi.json put /patients/{id}","href":"/api-reference/patients/update-patient"}]},{"group":"Users","pages":[{"title":"Delete your account","deprecated":null,"version":null,"openapi":"/openapi.json delete /iam/users/me","href":"/api-reference/users/delete-your-account"},{"title":"Get a user's linked record","deprecated":null,"version":null,"openapi":"/openapi.json get /iam/users/links","href":"/api-reference/users/get-a-users-linked-record"},{"title":"Find a user by email","deprecated":null,"version":null,"openapi":"/openapi.json get /iam/users/find","href":"/api-reference/users/find-a-user-by-email"}]},{"group":"Questionnaire Responses","pages":[{"title":"List questionnaire responses","deprecated":null,"version":null,"openapi":"/openapi.json get /questionnaire-responses","href":"/api-reference/questionnaire-responses/list-questionnaire-responses"},{"title":"Create questionnaire response","deprecated":null,"version":null,"openapi":"/openapi.json post /questionnaire-responses","href":"/api-reference/questionnaire-responses/create-questionnaire-response"},{"title":"Get questionnaire response","deprecated":null,"version":null,"openapi":"/openapi.json get /questionnaire-responses/{id}","href":"/api-reference/questionnaire-responses/get-questionnaire-response"},{"title":"Update questionnaire response","deprecated":null,"version":null,"openapi":"/openapi.json put /questionnaire-responses/{id}","href":"/api-reference/questionnaire-responses/update-questionnaire-response"}]},{"group":"Questionnaires","pages":[{"title":"List questionnaires","deprecated":null,"version":null,"openapi":"/openapi.json get /questionnaires","href":"/api-reference/questionnaires/list-questionnaires"},{"title":"Get questionnaire","deprecated":null,"version":null,"openapi":"/openapi.json get /questionnaires/{id}","href":"/api-reference/questionnaires/get-questionnaire"}]},{"group":"Related Persons","pages":[{"title":"List related persons","deprecated":null,"version":null,"openapi":"/openapi.json get /related-persons","href":"/api-reference/related-persons/list-related-persons"},{"title":"Create related person","deprecated":null,"version":null,"openapi":"/openapi.json post /related-persons","href":"/api-reference/related-persons/create-related-person"},{"title":"Get related person","deprecated":null,"version":null,"openapi":"/openapi.json get /related-persons/{id}","href":"/api-reference/related-persons/get-related-person"},{"title":"Update related person","deprecated":null,"version":null,"openapi":"/openapi.json put /related-persons/{id}","href":"/api-reference/related-persons/update-related-person"}]},{"group":"Sites","pages":[{"title":"List sites","deprecated":null,"version":null,"openapi":"/openapi.json get /sites","href":"/api-reference/sites/list-sites"},{"title":"Create site","deprecated":null,"version":null,"openapi":"/openapi.json post /sites","href":"/api-reference/sites/create-site"},{"title":"Get site","deprecated":null,"version":null,"openapi":"/openapi.json get /sites/{key}","href":"/api-reference/sites/get-site"},{"title":"Delete site","deprecated":null,"version":null,"openapi":"/openapi.json delete /sites/{key}","href":"/api-reference/sites/delete-site"},{"title":"Update site","deprecated":null,"version":null,"openapi":"/openapi.json patch /sites/{key}","href":"/api-reference/sites/update-site"}]},{"group":"Tasks","pages":[{"title":"List tasks","deprecated":null,"version":null,"openapi":"/openapi.json get /tasks","href":"/api-reference/tasks/list-tasks"},{"title":"Create task","deprecated":null,"version":null,"openapi":"/openapi.json post /tasks","href":"/api-reference/tasks/create-task"},{"title":"Get task","deprecated":null,"version":null,"openapi":"/openapi.json get /tasks/{id}","href":"/api-reference/tasks/get-task"},{"title":"Update task","deprecated":null,"version":null,"openapi":"/openapi.json put /tasks/{id}","href":"/api-reference/tasks/update-task"},{"title":"Delete task","deprecated":null,"version":null,"openapi":"/openapi.json delete /tasks/{id}","href":"/api-reference/tasks/delete-task"}]},{"group":"Scheduling","pages":[{"title":"List bookable appointment types","deprecated":null,"version":null,"openapi":"/openapi.json get /appointment-types","href":"/api-reference/scheduling/list-bookable-appointment-types"},{"title":"Retrieve an appointment type","deprecated":null,"version":null,"openapi":"/openapi.json get /appointment-types/{id}","href":"/api-reference/scheduling/retrieve-an-appointment-type"},{"title":"Search available slots","deprecated":null,"version":null,"openapi":"/openapi.json get /slots","href":"/api-reference/scheduling/search-available-slots"},{"title":"Reserve a slot","deprecated":null,"version":null,"openapi":"/openapi.json post /reservations","href":"/api-reference/scheduling/reserve-a-slot"},{"title":"Release a slot reservation","deprecated":null,"version":null,"openapi":"/openapi.json delete /reservations/{id}","href":"/api-reference/scheduling/release-a-slot-reservation"},{"title":"List appointments","deprecated":null,"version":null,"openapi":"/openapi.json get /appointments","href":"/api-reference/scheduling/list-appointments"},{"title":"Book an appointment","deprecated":null,"version":null,"openapi":"/openapi.json post /appointments","href":"/api-reference/scheduling/book-an-appointment"},{"title":"Retrieve an appointment","deprecated":null,"version":null,"openapi":"/openapi.json get /appointments/{id}","href":"/api-reference/scheduling/retrieve-an-appointment"},{"title":"Update an appointment","deprecated":null,"version":null,"openapi":"/openapi.json patch /appointments/{id}","href":"/api-reference/scheduling/update-an-appointment"}]},{"group":"Prices","pages":[{"title":"Get Price","deprecated":null,"version":null,"openapi":"/openapi.json get /prices/{price_id}","href":"/api-reference/prices/get-price"}]},{"group":"Products","pages":[{"title":"List Products","deprecated":null,"version":null,"openapi":"/openapi.json get /products","href":"/api-reference/products/list-products"},{"title":"Get Product By Id","deprecated":null,"version":null,"openapi":"/openapi.json get /products/{product_id}","href":"/api-reference/products/get-product-by-id"},{"title":"List Product Prices","deprecated":null,"version":null,"openapi":"/openapi.json get /products/{product_id}/prices","href":"/api-reference/products/list-product-prices"}]},{"group":"Checkout","pages":[{"title":"Create Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /checkouts/sessions","href":"/api-reference/checkout/create-checkout-session"}]},{"group":"Coupons","pages":[{"title":"List Coupons","deprecated":null,"version":null,"openapi":"/openapi.json get /coupons","href":"/api-reference/coupons/list-coupons"},{"title":"Create Coupons","deprecated":null,"version":null,"openapi":"/openapi.json post /coupons","href":"/api-reference/coupons/create-coupons"},{"title":"Get Coupon","deprecated":null,"version":null,"openapi":"/openapi.json get /coupons/{provider_coupon_id}","href":"/api-reference/coupons/get-coupon"},{"title":"Delete Coupon","deprecated":null,"version":null,"openapi":"/openapi.json delete /coupons/{provider_coupon_id}","href":"/api-reference/coupons/delete-coupon"}]},{"group":"Intents","pages":[{"title":"Get Payment Intent","deprecated":null,"version":null,"openapi":"/openapi.json get /intents/payments/{provider_payment_intent_id}","href":"/api-reference/intents/get-payment-intent"},{"title":"Get Setup Intent","deprecated":null,"version":null,"openapi":"/openapi.json get /intents/setups/{provider_setup_intent_id}","href":"/api-reference/intents/get-setup-intent"},{"title":"Create Setup Intent","deprecated":null,"version":null,"openapi":"/openapi.json post /intents/setups","href":"/api-reference/intents/create-setup-intent"}]},{"group":"Invoices","pages":[{"title":"Get Invoices","deprecated":null,"version":null,"openapi":"/openapi.json get /invoices","href":"/api-reference/invoices/get-invoices"},{"title":"Create Invoice Preview","deprecated":null,"version":null,"openapi":"/openapi.json post /invoices/previews","href":"/api-reference/invoices/create-invoice-preview"},{"title":"Pay Invoice","deprecated":null,"version":null,"openapi":"/openapi.json post /invoices/{provider_invoice_id}/payments","href":"/api-reference/invoices/pay-invoice"},{"title":"Create Refund","deprecated":null,"version":null,"openapi":"/openapi.json post /invoices/{provider_invoice_id}/refunds","href":"/api-reference/invoices/create-refund"}]},{"group":"Payment Methods","pages":[{"title":"Get Payment Methods","deprecated":null,"version":null,"openapi":"/openapi.json get /payment-methods","href":"/api-reference/payment-methods/get-payment-methods"}]},{"group":"Promotion Codes","pages":[{"title":"List Promotion Codes","deprecated":null,"version":null,"openapi":"/openapi.json get /promotion-codes","href":"/api-reference/promotion-codes/list-promotion-codes"},{"title":"Create Promotion Code","deprecated":null,"version":null,"openapi":"/openapi.json post /promotion-codes","href":"/api-reference/promotion-codes/create-promotion-code"},{"title":"Deactivate Promotion Code","deprecated":null,"version":null,"openapi":"/openapi.json delete /promotion-codes/{provider_promotion_code_id}","href":"/api-reference/promotion-codes/deactivate-promotion-code"}]},{"group":"Subscriptions","pages":[{"title":"Get Subscriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /subscriptions","href":"/api-reference/subscriptions/get-subscriptions"},{"title":"Create Subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /subscriptions","href":"/api-reference/subscriptions/create-subscription"},{"title":"Get Subscription","deprecated":null,"version":null,"openapi":"/openapi.json get /subscriptions/{provider_subscription_id}","href":"/api-reference/subscriptions/get-subscription"},{"title":"Update Subscription","deprecated":null,"version":null,"openapi":"/openapi.json put /subscriptions/{provider_subscription_id}","href":"/api-reference/subscriptions/update-subscription"},{"title":"Cancel Subscription","deprecated":null,"version":null,"openapi":"/openapi.json delete /subscriptions/{provider_subscription_id}","href":"/api-reference/subscriptions/cancel-subscription"},{"title":"List Subscription Invoices","deprecated":null,"version":null,"openapi":"/openapi.json get /subscriptions/{provider_subscription_id}/invoices","href":"/api-reference/subscriptions/list-subscription-invoices"},{"title":"Pause Subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /subscriptions/{provider_subscription_id}/pauses","href":"/api-reference/subscriptions/pause-subscription"},{"title":"Resume Subscription","deprecated":null,"version":null,"openapi":"/openapi.json delete /subscriptions/{provider_subscription_id}/pauses","href":"/api-reference/subscriptions/resume-subscription"}]},{"group":"Configs","pages":[{"title":"Get Config","deprecated":null,"version":null,"openapi":"/openapi.json get /configs","href":"/api-reference/configs/get-config"}]},{"group":"Billing Portals","pages":[{"title":"List Billing Portals","deprecated":null,"version":null,"openapi":"/openapi.json get /billing-portals","href":"/api-reference/billing-portals/list-billing-portals"},{"title":"Create Retention Portal Session","deprecated":null,"version":null,"openapi":"/openapi.json post /billing-portals/retention-sessions","href":"/api-reference/billing-portals/create-retention-portal-session"},{"title":"Create Portal Session","deprecated":null,"version":null,"openapi":"/openapi.json post /billing-portals/{provider_billing_portal_id}/sessions","href":"/api-reference/billing-portals/create-portal-session"}]},{"group":"Auth","pages":[]},{"group":"Billing Customers","pages":[{"title":"Get Customers","deprecated":null,"version":null,"openapi":"/openapi.json get /billing-customers","href":"/api-reference/billing-customers/get-customers"},{"title":"Create Customer","deprecated":null,"version":null,"openapi":"/openapi.json post /billing-customers","href":"/api-reference/billing-customers/create-customer"},{"title":"Get Customer","deprecated":null,"version":null,"openapi":"/openapi.json get /billing-customers/{provider_customer_id}","href":"/api-reference/billing-customers/get-customer"},{"title":"Update Customer","deprecated":null,"version":null,"openapi":"/openapi.json put /billing-customers/{provider_customer_id}","href":"/api-reference/billing-customers/update-customer"},{"title":"List Billing Customer Subscriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /billing-customers/{provider_customer_id}/subscriptions","href":"/api-reference/billing-customers/list-billing-customer-subscriptions"},{"title":"List Balance Transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /billing-customers/{provider_customer_id}/balance-transactions","href":"/api-reference/billing-customers/list-balance-transactions"},{"title":"Create Balance Transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /billing-customers/{provider_customer_id}/balance-transactions","href":"/api-reference/billing-customers/create-balance-transaction"}]},{"group":"Eligibility","pages":[{"title":"Submit an eligibility verification","deprecated":null,"version":null,"openapi":"/openapi.json post /eligibility-verifications","href":"/api-reference/eligibility/submit-an-eligibility-verification"},{"title":"Retrieve an eligibility verification","deprecated":null,"version":null,"openapi":"/openapi.json get /eligibility-verifications/{id}","href":"/api-reference/eligibility/retrieve-an-eligibility-verification"},{"title":"Submit an insurance discovery","description":"Finds coverage a patient may have when you do not know their payer or member id, from demographics alone. Queued rather than answered inline: this call answers 202 with an `id` and `status: PENDING`, and the result arrives on `GET /insurance-discoveries/{id}`.\n\nThe organization comes from your access token's organization claim; there is no body field or query parameter for it. A token carrying no claim is a 401.\n\n`subscriber.address.state` is required, and is the state of care rather than a mailing address: it narrows the search and selects the OpenLoop entity the inquiry is submitted under. The rest of the address is optional and improves matching, as does `subscriber.ssn`, which is never echoed back.\n\n**Repeat submissions are absorbed for five minutes.** An identical submission inside that window answers 200 instead of 202, carrying the original `id` and `deduplicated: true`, and queues nothing new. The window matches the whole question, so a corrected submission is a new search.\n\n**Not yet enabled on the production edge.** This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it.\n\n**Permissions:** `eligibility:write`","deprecated":null,"version":null,"openapi":"/openapi.json post /insurance-discoveries","href":"/api-reference/eligibility/submit-an-insurance-discovery"},{"title":"Retrieve an insurance discovery","deprecated":null,"version":null,"openapi":"/openapi.json get /insurance-discoveries/{id}","href":"/api-reference/eligibility/retrieve-an-insurance-discovery"},{"title":"Coordinate benefits across payers","description":"Asks a payer you already know the patient has what other coverage they have, and which coverage pays first. **Answered inline** — there is nothing to poll.\n\nThe organization comes from your access token's organization claim; there is no body field or query parameter for it. A token carrying no claim is a 401.\n\nThe response carries the payer's own verdict. There is no verdict field of ours, no `coverages` array and no recommendation: read `coordination_of_benefits.classification` and `coordination_details`.\n\n**A payer rejection is a 200.** The patient could not be matched, and the rejection is reported as `status` and `status_reason` — a completed check, not a failed request.\n\n**A payer that does not answer coordination checks is a 400**, refused before any payer is contacted. Original Medicare and the Part B MACs are in that group. Nothing is stored for a refused check, so you may ask again as soon as the payer becomes supported.\n\n**Repeat submissions are absorbed for five minutes.** An identical check inside that window returns the stored answer with `deduplicated: true` and makes no payer call. Two identical requests sent at the same moment are two checks.\n\nThis endpoint takes no state.\n\n**Not yet enabled on the production edge.** This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it.\n\n**Permissions:** `eligibility:write`","deprecated":null,"version":null,"openapi":"/openapi.json post /benefit-coordinations","href":"/api-reference/eligibility/coordinate-benefits-across-payers"},{"title":"Resolve a Medicare Beneficiary Identifier","deprecated":null,"version":null,"openapi":"/openapi.json post /medicare-id-lookups","href":"/api-reference/eligibility/resolve-a-medicare-beneficiary-identifier"},{"title":"Check network status for a payer in a state","deprecated":null,"version":null,"openapi":"/openapi.json post /network-status","href":"/api-reference/eligibility/check-network-status-for-a-payer-in-a-state"}]},{"group":"Payer Directory","pages":[{"title":"List or search payers","deprecated":null,"version":null,"openapi":"/openapi.json get /payers","href":"/api-reference/payer-directory/list-or-search-payers"},{"title":"Retrieve a payer","deprecated":null,"version":null,"openapi":"/openapi.json get /payers/{payer_id}","href":"/api-reference/payer-directory/retrieve-a-payer"}]},{"group":"Patient Passport","pages":[{"title":"Get a patient's Passport profile","deprecated":null,"version":null,"openapi":"/openapi.json get /passport/profile","href":"/api-reference/patient-passport/get-a-patients-passport-profile"},{"title":"List a patient's Passport appointments","deprecated":null,"version":null,"openapi":"/openapi.json get /passport/appointments","href":"/api-reference/patient-passport/list-a-patients-passport-appointments"},{"title":"List a patient's Passport orders","deprecated":null,"version":null,"openapi":"/openapi.json get /passport/orders","href":"/api-reference/patient-passport/list-a-patients-passport-orders"},{"title":"List a patient's Passport subscriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /passport/subscriptions","href":"/api-reference/patient-passport/list-a-patients-passport-subscriptions"},{"title":"Get a patient's Passport journey","deprecated":null,"version":null,"openapi":"/openapi.json get /passport/journey","href":"/api-reference/patient-passport/get-a-patients-passport-journey"}]}]}]},"basePath":"","title":"Retrieve an insurance discovery - Partners API Documentation","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}