Skip to main content
GET
/
v1
/
policies
/
{policy_id}
/
download-url
Get Policy Download Url
curl --request GET \
  --url https://api-sandbox.penelope.health/v1/policies/{policy_id}/download-url \
  --header 'x-api-key: <api-key>'
{
  "url": "https://blockstore.example/policy.pdf?X-Amz-Signature=...",
  "content_type": "application/pdf",
  "filename": "uhc_US_MP.002.28_2026-01-01.pdf"
}

Authorizations

x-api-key
string
header
required

Path Parameters

policy_id
string
required

Query Parameters

variant
enum<string>
default:display

'display' returns the original file; 'text' returns an LLM-optimized markdown version

Available options:
display,
text

Response

Successful Response

url
string
required

Short-lived presigned URL to download the policy file (expires within ~15 minutes; request it just before use).

Example:

"https://blockstore.example/policy.pdf?X-Amz-Signature=..."

content_type
enum<string>
required

MIME type of the file

Available options:
application/pdf,
text/html,
text/markdown
Example:

"application/pdf"

filename
string
required

Suggested filename for download

Example:

"uhc_US_MP.002.28_2026-01-01.pdf"