Skip to main content
GET
/
v1
/
policies
/
updates
Get Policy Updates
curl --request GET \
  --url https://api-sandbox.penelope.health/v1/policies/updates \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "policy_id": "uhc/MP.002.28/2026-01-01",
      "policy_number": "MP.002.28",
      "title": "Brow Ptosis and Eyelid Repair",
      "effective_from_date": "2026-01-01",
      "change_type": "new",
      "payer_id": "KMQTZ",
      "payer_display_name": "UnitedHealthcare",
      "file_url": "https://..."
    },
    {
      "policy_id": "uhc/MP.002.28/2026-01-01",
      "policy_number": "MP.002.28",
      "title": "Brow Ptosis and Eyelid Repair",
      "effective_from_date": "2026-01-01",
      "change_type": "new",
      "payer_id": "KMQTZ",
      "payer_display_name": "UnitedHealthcare",
      "file_url": "https://..."
    }
  ],
  "limit": 20,
  "offset": 0,
  "has_more": false
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
limit
integer
default:100

Maximum number of results to return

Required range: 1 <= x <= 100
Example:

20

​
offset
integer
default:0

Number of results to skip for pagination

Required range: x >= 0
Example:

0

​
days
integer
default:90

Number of days to look back

Required range: 1 <= x <= 365

Response

Successful Response

​
data
PolicyUpdate · object[]
required

Array of result objects

​
limit
integer
required

Maximum number of results requested

Example:

20

​
offset
integer
required

Number of results skipped for pagination

Example:

0

​
has_more
boolean
required

True if more results exist beyond this page

Example:

false