Contradiction findings (documented values that fail a criterion) followed by outstanding clinical questions (missing documentation), based on policy criteria. Contradictions always come first.
ClinicalQuestionPublic
ClinicalContradictionPublic
Show child attributes
Example:
[
{
"note_citation": "baseline serum uric acid prior to initiation 5.4 mg/dL",
"policy_reference": {
"citation": "Documentation is provided that individual has a baseline serum uric acid of 6 mg/dL or greater.",
"policy_id": "anthem/clinical_criteria/CC-0057/2025-07-23"
},
"rationale": "Anthem CC-0057 requires a documented baseline serum uric acid of 6 mg/dL or greater prior to initiating pegloticase; the note records 5.4 mg/dL.",
"type": "contradiction"
},
{
"note_citation": "Patient scheduled for excision next week.",
"policy_reference": {
"citation": "Patient must be evaluated for bleeding disorders prior to procedure.",
"policy_id": "uhc/MP.002/2026-01-01"
},
"question": "Any bleeding disorders?",
"rationale": "UHC MP.002 requires documentation of bleeding-disorder screening before approving surgical intervention.",
"type": "question"
}
]
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Penelope","colors":{"primary":"#3D7C7B","light":"#5A9998","dark":"#2A5958"},"logo":{"light":"https://mintcdn.com/penelopehealth/dzPBKKrahfn4Jj5z/logo/penelope-logo.png?fit=max\u0026auto=format\u0026n=dzPBKKrahfn4Jj5z\u0026q=85\u0026s=07a5a4b170bb57380759d59319a277a4","dark":"https://mintcdn.com/penelopehealth/dzPBKKrahfn4Jj5z/logo/penelope-logo.png?fit=max\u0026auto=format\u0026n=dzPBKKrahfn4Jj5z\u0026q=85\u0026s=07a5a4b170bb57380759d59319a277a4","href":"https://penelope.health"},"favicon":"https://mintcdn.com/penelopehealth/NERVlXmIW6CgY1ug/logo/favicon.ico?fit=max\u0026auto=format\u0026n=NERVlXmIW6CgY1ug\u0026q=85\u0026s=5bbef43e542ae34302acc7d9055ccbc2","appearance":{"default":"light","strict":true},"background":{"color":{"light":"#F8F3EB","dark":"#6B5D56"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}]},"footer":{"links":[{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://penelope.health/privacy"},{"label":"Terms of Service","href":"https://penelope.health/terms"},{"label":"Cookie Policy","href":"https://penelope.health/cookies"}]}]},"integrations":{"telemetry":{"enabled":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"penelopehealth","hasAudioNarration":false,"actualSubdomain":"penelopehealth","customDomains":["docs.penelope.health"],"gitSource":{"type":"github","owner":"penelope-health","repo":"undeniable","deployBranch":"release","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4633939bc6f1b8c4f7d74","collectionId":"3dbed026-a049-4bc7-8352-be2a3167dc9d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4633939bc6f1b8c4f7d74"},"entitlements":{},"buildId":"6ae4633939bc6f1b8c4f7d74","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":30},{"language":"default","tag":"Documentation","count":6},{"language":"default","tag":"Penelope API","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/get-provider-guidance","slug":"/api-reference/get-provider-guidance","pageMetadata":{"title":"Get Provider Guidance","description":"Analyze a clinical encounter transcript against insurance policy criteria.","deprecated":null,"version":null,"tag":"Beta","openapi":"/api-reference/openapi.json post /v1/provider-guidance","href":"/api-reference/get-provider-guidance","autogeneratedByOpenApi":true},"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: \"Analyze a clinical encounter transcript against insurance policy criteria.\"\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":"Get Provider Guidance","description":"Analyze a clinical encounter transcript against insurance policy criteria.","deprecated":null,"version":null,"tag":"Beta","openapi":"/api-reference/openapi.json post /v1/provider-guidance","href":"/api-reference/get-provider-guidance","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get Provider Guidance","description":"Analyze a clinical encounter transcript against insurance policy criteria.","operationId":"get_provider_guidance_v1_provider_guidance_post","requestBody":"d4b70edd-d89d-4e07-8850-00f4215d1f58","responses":{"200":"beedd2ed-115f-4740-8207-ebfbb9542542","422":"075bdc50-230d-4877-b353-837057265663"},"security":["0f600856-fbf2-4f7b-b433-f33b77e74e77"],"x-mint":{"metadata":{"tag":"Beta"}},"method":"post","type":"path","servers":["6ba7c7c8-5d7d-4fb1-8a07-40b4d5285264","308c8b28-f7af-49c6-96ff-e2491d67be78"],"path":"/v1/provider-guidance","baseUrlOptions":["https://api-sandbox.penelope.health","https://api.penelope.health"],"title":"Get Provider Guidance","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"note":{"type":"string","maxLength":100000,"title":"Note","description":"Clinical encounter note","examples":["Patient presents with bilateral upper eyelid ptosis causing visual field obstruction..."],"isRequired":true,"uniqueKey":"note","typeLabel":"string"},"payer_id":{"type":"string","title":"Payer Id","description":"Unique Stedi payer ID (see https://www.stedi.com/healthcare/network)","examples":["KMQTZ","HPQRS"],"isRequired":true,"uniqueKey":"payer_id","typeLabel":"string"},"lob":{"type":"string","enum":["commercial","medicare_part_a","medicare_part_b","medicare_advantage","medicare_part_d","medicaid","individual_aca"],"title":"LobCategory","description":"Line-of-business category","examples":["commercial"],"isRequired":true,"uniqueKey":"lob","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","PR","VI","CNMI","NF","SF","DN","QN","UN","EM","WM"],"title":"USState","description":"Member state or jurisdiction code","examples":["TX"],"isRequired":true,"uniqueKey":"state","typeLabel":"enum\u003cstring>"}},"type":"object","required":["note","payer_id","lob","state"],"title":"ProviderGuidanceRequest","uniqueKey":"","typeLabel":"ProviderGuidanceRequest · object"},"examples":{"functional_blepharoplasty":{"title":"functional_blepharoplasty","value":{"note":"Patient presents with bilateral upper eyelid ptosis causing visual field obstruction. MRD-1 measured at 1.5 mm bilaterally. Taped visual field testing shows 30% superior field improvement. Plan: functional blepharoplasty evaluation.","payer_id":"KMQTZ","lob":"commercial","state":"TX"}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"beedd2ed-115f-4740-8207-ebfbb9542542":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"status":{"type":"string","enum":["medical_necessity_not_met","documentation_gaps","medical_necessity_not_met_and_documentation_gaps","no_documentation_gaps","no_applicable_policy","no_procedure_planned"],"title":"ProviderGuidanceStatus","description":"Outcome of the analysis.\n\nWith a non-empty `output`:\n- `medical_necessity_not_met` — contradictions only\n- `documentation_gaps` — questions only\n- `medical_necessity_not_met_and_documentation_gaps` — both\n\nWith an empty `output` (disambiguated):\n- `no_documentation_gaps` — a relevant policy was found and every applicable criterion is already satisfied\n- `no_applicable_policy` — a procedure is planned but no policy directly authorizes it\n- `no_procedure_planned` — nothing is affirmatively planned in this encounter","examples":["medical_necessity_not_met_and_documentation_gaps"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"output":{"items":{"oneOf":[{"type":"object","title":"ClinicalQuestionPublic","required":["question","rationale","policy_reference","note_citation"],"properties":{"question":{"type":"string","title":"Question","description":"A short clinical question in plain language.","examples":["Any bleeding disorders?","6 months+ of conservative treatment?","Size changes?","Pain at lesion?"],"isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.0.question","typeLabel":"string"},"rationale":{"type":"string","title":"Rationale","description":"Why this information is needed, citing the policy","examples":["UHC MP.002 requires documentation of failed conservative treatment before approving surgical intervention."],"isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.0.rationale","typeLabel":"string"},"policy_reference":{"properties":{"policy_id":{"type":"string","title":"Policy Id","description":"Unique policy identifier","examples":["uhc/MP.002/2026-01-01"],"isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.0.policy_reference.policy_id","typeLabel":"string"},"citation":{"type":"string","title":"Citation","description":"Verbatim text extract from the policy document.","isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.0.policy_reference.citation","typeLabel":"string"}},"type":"object","required":["policy_id","citation"],"title":"PolicyReferencePublic","description":"Policy id and verbatim citation from the policy document","isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.0.policy_reference","typeLabel":"PolicyReferencePublic · object"},"note_citation":{"type":"string","title":"Note Citation","description":"Verbatim text extract from the clinical note that motivates this question.","isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.0.note_citation","typeLabel":"string"},"type":{"type":"string","const":"question","title":"Type","default":"question","uniqueKey":"output.items.[INDEX].oneOf.0.type","typeLabel":"string"}},"uniqueKey":"output.items.[INDEX].oneOf.0","typeLabel":"ClinicalQuestionPublic · object"},{"type":"object","title":"ClinicalContradictionPublic","description":"A criterion the note explicitly fails — a judgement, not a question.\n\nEmitted only when the note documents a concrete value/finding that\nconflicts with a policy criterion (e.g. uric acid 5.4 mg/dL where the\npolicy requires ≥ 6 mg/dL). Merely-missing documentation is a\nClinicalQuestion, not a contradiction.","required":["rationale","policy_reference","note_citation"],"properties":{"rationale":{"type":"string","title":"Rationale","description":"Why this criterion is failed, naming the documented value and the required threshold.","examples":["Anthem CC-0057 requires a documented baseline serum uric acid of 6 mg/dL or greater prior to initiating pegloticase; the note records 5.4 mg/dL."],"isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.1.rationale","typeLabel":"string"},"policy_reference":{"properties":{"policy_id":{"type":"string","title":"Policy Id","description":"Unique policy identifier","examples":["uhc/MP.002/2026-01-01"],"isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.1.policy_reference.policy_id","typeLabel":"string"},"citation":{"type":"string","title":"Citation","description":"Verbatim text extract from the policy document.","isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.1.policy_reference.citation","typeLabel":"string"}},"type":"object","required":["policy_id","citation"],"title":"PolicyReferencePublic","description":"Policy id and verbatim citation from the policy document","isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.1.policy_reference","typeLabel":"PolicyReferencePublic · object"},"note_citation":{"type":"string","title":"Note Citation","description":"Verbatim text extract from the clinical note that conflicts with the criterion.","isRequired":true,"uniqueKey":"output.items.[INDEX].oneOf.1.note_citation","typeLabel":"string"},"type":{"type":"string","const":"contradiction","title":"Type","default":"contradiction","uniqueKey":"output.items.[INDEX].oneOf.1.type","typeLabel":"string"}},"uniqueKey":"output.items.[INDEX].oneOf.1","typeLabel":"ClinicalContradictionPublic · object"}],"uniqueKey":"output.items.[INDEX]","typeLabel":"ClinicalQuestionPublic · object | ClinicalContradictionPublic · object"},"type":"array","title":"Output","description":"Contradiction findings (documented values that fail a criterion) followed by outstanding clinical questions (missing documentation), based on policy criteria. Contradictions always come first.","examples":[[{"note_citation":"baseline serum uric acid prior to initiation 5.4 mg/dL","policy_reference":{"citation":"Documentation is provided that individual has a baseline serum uric acid of 6 mg/dL or greater.","policy_id":"anthem/clinical_criteria/CC-0057/2025-07-23"},"rationale":"Anthem CC-0057 requires a documented baseline serum uric acid of 6 mg/dL or greater prior to initiating pegloticase; the note records 5.4 mg/dL.","type":"contradiction"},{"note_citation":"Patient scheduled for excision next week.","policy_reference":{"citation":"Patient must be evaluated for bleeding disorders prior to procedure.","policy_id":"uhc/MP.002/2026-01-01"},"question":"Any bleeding disorders?","rationale":"UHC MP.002 requires documentation of bleeding-disorder screening before approving surgical intervention.","type":"question"}]],"isRequired":true,"uniqueKey":"output","typeLabel":"(ClinicalQuestionPublic · object | ClinicalContradictionPublic · object)[]"}},"type":"object","required":["status","output"],"title":"ProviderGuidancePublic","uniqueKey":"","typeLabel":"ProviderGuidancePublic · object"},"example":{"questions":[{"question":"Any bleeding disorders?","rationale":"UHC MP.002 requires documentation of bleeding-disorder screening before approving surgical intervention.","policy_reference":{"policy_id":"uhc/MP.002/2026-01-01","citation":"Patient must be evaluated for bleeding disorders prior to procedure."},"note_citation":"Patient scheduled for excision next week."}]},"examples":{"Example":{"title":"Example","value":{"questions":[{"question":"Any bleeding disorders?","rationale":"UHC MP.002 requires documentation of bleeding-disorder screening before approving surgical intervention.","policy_reference":{"policy_id":"uhc/MP.002/2026-01-01","citation":"Patient must be evaluated for bleeding disorders prior to procedure."},"note_citation":"Patient scheduled for excision next week."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"075bdc50-230d-4877-b353-837057265663":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0f600856-fbf2-4f7b-b433-f33b77e74e77":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"APIKeyHeader"}}},"servers":{"6ba7c7c8-5d7d-4fb1-8a07-40b4d5285264":{"url":"https://api-sandbox.penelope.health","description":"Sandbox"},"308c8b28-f7af-49c6-96ff-e2491d67be78":{"url":"https://api.penelope.health","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"x-api-key"}],"title":"APIKeyHeader"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"penelopehealth","siteName":"Penelope","title":"Get Provider Guidance - Penelope","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T09:28:30.942Z","originalFileLocation":"api-reference/get-provider-guidance.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Analyze a clinical encounter transcript against insurance policy criteria.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Penelope\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/penelopehealth/GvZlJt05MIicjlm-/_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/penelopehealth/GvZlJt05MIicjlm-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/penelopehealth/GvZlJt05MIicjlm-/_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/penelopehealth/GvZlJt05MIicjlm-/_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/penelopehealth/GvZlJt05MIicjlm-/_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/penelopehealth/GvZlJt05MIicjlm-/_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/penelopehealth/GvZlJt05MIicjlm-/_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/penelopehealth/GvZlJt05MIicjlm-/_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/penelopehealth/GvZlJt05MIicjlm-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Provider Guidance - Penelope\">\u003cmeta data-mint-head property=\"og:description\" content=\"Analyze a clinical encounter transcript against insurance policy criteria.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Penelope\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.penelope.health/api-reference/get-provider-guidance\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://penelopehealth.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+Provider+Guidance\u0026amp;description=Analyze+a+clinical+encounter+transcript+against+insurance+policy+criteria.\u0026amp;theme=1fd68c9bf2a9a0afd6dbd1e7\u0026amp;signature=d4cf847b4bae4f1de130b76ea631609781ae0923da3a851390acb5dc58271665\">\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=\"Get Provider Guidance - Penelope\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Analyze a clinical encounter transcript against insurance policy criteria.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://penelopehealth.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+Provider+Guidance\u0026amp;description=Analyze+a+clinical+encounter+transcript+against+insurance+policy+criteria.\u0026amp;theme=1fd68c9bf2a9a0afd6dbd1e7\u0026amp;signature=d4cf847b4bae4f1de130b76ea631609781ae0923da3a851390acb5dc58271665\">\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/penelopehealth/GvZlJt05MIicjlm-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Penelope\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3D7C7B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.penelope.health/api-reference/get-provider-guidance\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-provider-guidance.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.penelope.health/#organization\",\"name\":\"Penelope\",\"url\":\"https://docs.penelope.health\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/penelopehealth/dzPBKKrahfn4Jj5z/logo/penelope-logo.png?fit=max\u0026auto=format\u0026n=dzPBKKrahfn4Jj5z\u0026q=85\u0026s=07a5a4b170bb57380759d59319a277a4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.penelope.health#website\",\"name\":\"Penelope\",\"url\":\"https://docs.penelope.health\",\"publisher\":{\"@id\":\"https://docs.penelope.health/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.penelope.health/api-reference/get-provider-guidance#webpage\",\"url\":\"https://docs.penelope.health/api-reference/get-provider-guidance\",\"name\":\"Get Provider Guidance\",\"description\":\"Analyze a clinical encounter transcript against insurance policy criteria.\",\"dateModified\":\"2026-10-30T09:28:30.942Z\",\"isPartOf\":{\"@id\":\"https://docs.penelope.health#website\"},\"breadcrumb\":{\"@id\":\"https://docs.penelope.health/api-reference/get-provider-guidance#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.penelope.health/api-reference/get-provider-guidance#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.penelope.health/api-reference/authorization\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.penelope.health/api-reference/list-payers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Provider Guidance\",\"item\":\"https://docs.penelope.health/api-reference/get-provider-guidance\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.penelope.health/api-reference/get-provider-guidance#apireference\",\"headline\":\"Get Provider Guidance\",\"name\":\"Get Provider Guidance\",\"description\":\"Analyze a clinical encounter transcript against insurance policy criteria.\",\"url\":\"https://docs.penelope.health/api-reference/get-provider-guidance\",\"mainEntityOfPage\":{\"@id\":\"https://docs.penelope.health/api-reference/get-provider-guidance#webpage\"},\"dateModified\":\"2026-10-30T09:28:30.942Z\",\"publisher\":{\"@id\":\"https://docs.penelope.health/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.penelope.health#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Penelope\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Penelope","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Authentication","href":"/api-reference/authorization"},{"title":"Technical Notes","href":"/api-reference/technical_notes"},{"title":"Notable Input Types","href":"/api-reference/notable_input_types"},{"group":"API Reference","pages":[{"title":"List Payers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payers","href":"/api-reference/list-payers"},{"title":"List LOBs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/lobs","href":"/api-reference/list-lobs"},{"title":"List Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/policies/filter","href":"/api-reference/list-policies"},{"title":"Get Policy Download Url","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/policies/{policy_id}/download-url","href":"/api-reference/get-policy-download-url"},{"title":"Get Policy","description":"Get a single policy by policy_id with its applicability, code groups, criteria text, and the id of the version it superseded.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/policies/{policy_id}","href":"/api-reference/get-policy"},{"title":"Get Provider Guidance","deprecated":null,"version":null,"tag":"Beta","openapi":"/api-reference/openapi.json post /v1/provider-guidance","href":"/api-reference/get-provider-guidance"},{"title":"Health Check","description":"Health check endpoint.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /health","href":"/api-reference/health-check"},{"title":"Ready Check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ready","href":"/api-reference/ready-check"}]}]}]}]},"basePath":"","title":"Get Provider Guidance - Penelope","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}