> ## Documentation Index > Fetch the complete documentation index at: https://docs.penelope.health/llms.txt > Use this file to discover all available pages before exploring further. # Get Policy Updates > Recent policy updates. Returns new and updated policies, grouped by effective date and payer. Multi-payer policies appear under each payer. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/policies/updates openapi: 3.1.0 info: title: Penelope Health API description: REST API for querying the Penelope Health knowledge graph. version: 1.0.0 servers: - url: https://api-sandbox.penelope.health description: Sandbox - url: https://api.penelope.health description: Production security: [] paths: /v1/policies/updates: get: summary: Get Policy Updates description: |- Recent policy updates. Returns new and updated policies, grouped by effective date and payer. Multi-payer policies appear under each payer. operationId: get_policy_updates_v1_policies_updates_get parameters: - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Maximum number of results to return examples: - 10 default: 100 title: Limit description: Maximum number of results to return - name: offset in: query required: false schema: type: integer minimum: 0 title: Offset description: Number of results to skip for pagination default: 0 examples: - 0 description: Number of results to skip for pagination - name: days in: query required: false schema: type: integer maximum: 365 minimum: 1 description: Number of days to look back default: 90 title: Days description: Number of days to look back responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_PolicyUpdate_' example: data: - policy_id: uhc/MP.002/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/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 '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: PaginatedResponse_PolicyUpdate_: properties: data: items: $ref: '#/components/schemas/PolicyUpdate' type: array title: Data description: Array of result objects limit: type: integer title: Limit description: Maximum number of results requested examples: - 20 offset: type: integer title: Offset description: Number of results skipped for pagination examples: - 0 has_more: type: boolean title: Has More description: True if more results exist beyond this page examples: - false type: object required: - data - limit - offset - has_more title: PaginatedResponse[PolicyUpdate] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PolicyUpdate: properties: policy_id: type: string title: Policy Id description: Unique policy identifier examples: - uhc/MP.002/2026-01-01 policy_number: type: string title: Policy Number description: Policy number assigned by the payer examples: - MP.002.28 title: type: string title: Title description: Policy title examples: - Brow Ptosis and Eyelid Repair effective_from_date: type: string format: date title: Effective From Date description: First day this version is in effect (inclusive) examples: - '2026-01-01' change_type: type: string enum: - new - updated title: Change Type description: Whether this is a new policy or an update examples: - new payer_id: type: string title: Payer Id description: Stedi payer ID examples: - KMQTZ payer_display_name: type: string title: Payer Display Name description: Human-readable payer name examples: - UnitedHealthcare file_url: type: string title: File Url description: Original URL of the policy file on payer's website examples: - https://... download_url: anyOf: - type: string - type: 'null' title: Download Url description: >- Short-lived presigned URL for PDF policies (expires within ~15 minutes; re-fetch via the download-url endpoint if stale). Null for HTML policies. examples: - null previous_versions: anyOf: - items: $ref: '#/components/schemas/PolicyUpdatePriorVersion' type: array - type: 'null' title: Previous Versions description: Previous versions (only for 'updated' entries) examples: - null type: object required: - policy_id - policy_number - title - effective_from_date - change_type - payer_id - payer_display_name - file_url title: PolicyUpdate description: A single policy update entry. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError PolicyUpdatePriorVersion: properties: policy_id: type: string title: Policy Id description: Unique policy identifier examples: - uhc/MP.002/2026-01-01 title: type: string title: Title description: Policy title of this version examples: - Brow Ptosis and Eyelid Repair effective_from_date: type: string format: date title: Effective From Date description: First day this version is in effect (inclusive) examples: - '2025-06-01' effective_to_date: anyOf: - type: string format: date - type: 'null' title: Effective To Date description: >- First date this version is no longer in effect (exclusive end) — typically the successor version's effective date examples: - '2026-01-01' type: object required: - policy_id - title - effective_from_date - effective_to_date title: PolicyUpdatePriorVersion description: A previous version of a policy that was superseded. securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````