Skip to main content
GET
/
v1
/
policies
/
{node_id}
Get Policy
curl --request GET \
  --url https://api-sandbox.penelope.health/v1/policies/{node_id} \
  --header 'x-api-key: <api-key>'
{
  "node_id": "uhc/US/MP.002.28/2026-01-01",
  "policy_number": "MP.002.28",
  "title": "Brow Ptosis and Eyelid Repair",
  "effective_from_date": "2026-01-01",
  "file_url": "https://www.uhcprovider.com/content/dam/provider/docs/public/policies/comm-medical-drug/brow-ptosis-and-eyelid-repair.pdf",
  "listing_url": "https://www.uhcprovider.com/en/policies-protocols/comm-medical-drug-policies/comm-medical-drug-policies.html",
  "summary": "This policy covers blepharoplasty and brow lift procedures when medically necessary for functional impairment...",
  "score": 4.26
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
node_id
string
required

Response

Successful Response

Single fixed type -- nullable fields are null when not requested/relevant.

​
node_id
string
required

Unique policy identifier

Example:

"uhc/US/MP.002.28/2026-01-01"

​
policy_number
string
required

Policy number assigned by the payer

Example:

"MP.002.28"

​
title
string
required

Policy title

Example:

"Brow Ptosis and Eyelid Repair"

​
effective_from_date
string<date>
required

Date the policy became effective

Example:

"2026-01-01"

​
effective_to_date
string<date> | null
required

Date the policy was superseded (null if currently active)

Example:

null

​
file_url
string
required

Original URL from which the policy file was downloaded

Example:

"https://www.uhcprovider.com/content/dam/provider/docs/public/policies/comm-medical-drug/brow-ptosis-and-eyelid-repair.pdf"

​
listing_url
string
required

URL of the listing page where the policy was found

Example:

"https://www.uhcprovider.com/en/policies-protocols/comm-medical-drug-policies/comm-medical-drug-policies.html"

​
summary
string | null
required

AI-generated policy summary

Example:

"This policy covers blepharoplasty and brow lift procedures when medically necessary for functional impairment..."

​
score
number | null

Full-text search relevance score (only present when using q filter)

Example:

4.26

​
applicability
PlanApplicability · object[] | null

Payer/plan/geography applicability. Only included when include_applicability=true.

Example:

null

​
code_groups
PolicyCodeGroup · object[] | null

Codes referenced by this policy, grouped by system and relationship. Only included when include_code_groups=true.

Example:

null