---
title: "List all policy amendment intents for a policy"
method: GET
path: "/policies/{policy_id}/policy_amendment_intents"
tags: ["Policy Amendment Intents"]
---

# List all policy amendment intents for a policy

`GET /policies/{policy_id}/policy_amendment_intents`

## Request

- Base URL: `https://test.api.kota.io`
- URL: `https://test.api.kota.io/policies/{policy_id}/policy_amendment_intents`
- Auth: HTTP bearer

Returns a paginated list of policy amendment intents for the specified policy. The intents are returned sorted by creation date, with the oldest intent appearing first.

## Path parameters

- `policy_id` string, required

## Query parameters

- `status` string
- `page` integer: The page of results to return. Defaults to 1 if not provided.
- `page_size` integer: The number of results to return per page. Defaults to 10 if not provided. Maximum value is 100.

## Response `200`

OK

- PolicyAmendmentIntentResponsePagedList
  - `items` PolicyAmendmentIntentResponse[], required: A paginated array containing the response elements
    - `id` string, required: Unique identifier for the policy amendment intent. Prefixed with `pai_`.
    - `object` string: Object type identifier.
    - `policy_id` string, required: The policy ID for which the amendment is requested. Prefixed with `p_`.
    - `status` 'action_required' | 'awaiting_quote' | 'pending_confirmation' | 'processing' | 'amended' | 'processing_error' | 'not_undertaken', required
    - `amendment_reason` PolicyAmendmentReasonResponse, required
      - `type` 'initial_adjustment_period' | 'qualifying_life_event', required
      - `qualifying_life_event` PolicyAmendmentQualifyingLifeEventResponse
        - `event` 'gained_other_insurance_coverage' | 'divorce_or_legal_separation' | 'death_of_spouse_or_dependent' | 'moved_out_of_coverage_area' | 'employment_status_change_affecting_eligibility' | 'eligible_for_government_program' | 'marriage_or_civil_partnership' | 'birth_of_child' | 'adoption_of_child' | 'gained_legal_guardianship' | 'dependent_lost_other_coverage' | 'lost_legal_guardianship' | 'dependent_gained_other_coverage' | 'dependent_eligible_for_government_program' | 'dependent_aged_out' | 'dependent_student_status_change_affecting_eligibility' | 'dependent_moved_in_or_out_of_coverage_area' | 'other_change', required
        - `event_date` string, date, required: The date when the qualifying life event occurred.
        - `reason` string, nullable: Additional reason or description for the qualifying life event.
    - `requested_changes` PolicyAmendmentRequestedChangeResponse[], required: List of requested changes to the policy.
      - `change_type` 'dependents' | 'cancellation', required
    - `required_action` PolicyAmendmentRequiredActionResponse
      - `code` 'provide_dependents_information', required
      - `reason` string, required: Brief reason for the required action.
      - `reason_description` string, required: Detailed description of the required action.
      - `due_by` string, date, required: The deadline by which the action must be completed. The day is included (i.e. the action can be completed any time during this day in the user's local time).
      - `associated_persons` PolicyAmendmentAssociatedPersonsResponse, required
        - `type` 'dependents', required
        - `dependents` PolicyAmendmentDependentsResponse
          - `dependents_management_intent_id` string, nullable: Unique identifier for the dependents management intent. Prefixed with `dmi_`. Null if not yet created.
          - `status` 'action_required' | 'processing' | 'completed' | 'not_undertaken'
    - `pending_confirmation` PolicyAmendmentPendingConfirmationResponse
      - `code` 'confirm_quote' | 'confirm_opt_out' | 'confirm_qle', required
      - `reason` string, required: Brief reason for the pending confirmation.
      - `reason_description` string, required: Detailed description of the pending confirmation.
      - `due_by` string, date, required: The deadline by which the confirmation must be provided.
      - `quote` PolicyAmendmentQuoteResponse
        - `currency` string, required: Three-letter currency code (e.g., "EUR", "USD", "GBP") for all monetary amounts in this quote.
        - `monthly` PolicyAmendmentQuoteContributionsResponse, required
          - `employee_contribution` PolicyAmendmentQuoteAmountResponse, required
            - `net` number, double, required: Net amount before tax.
            - `tax` number, double, required: Tax amount.
            - `gross` number, double, required: Gross amount (net + tax).
          - `employer_contribution` PolicyAmendmentQuoteAmountResponse, required
            - `net` number, double, required: Net amount before tax.
            - `tax` number, double, required: Tax amount.
            - `gross` number, double, required: Gross amount (net + tax).
          - `total` PolicyAmendmentQuoteAmountResponse, required
            - `net` number, double, required: Net amount before tax.
            - `tax` number, double, required: Tax amount.
            - `gross` number, double, required: Gross amount (net + tax).
        - `term` PolicyAmendmentQuoteContributionsResponse, required
          - `employee_contribution` PolicyAmendmentQuoteAmountResponse, required
            - `net` number, double, required: Net amount before tax.
            - `tax` number, double, required: Tax amount.
            - `gross` number, double, required: Gross amount (net + tax).
          - `employer_contribution` PolicyAmendmentQuoteAmountResponse, required
            - `net` number, double, required: Net amount before tax.
            - `tax` number, double, required: Tax amount.
            - `gross` number, double, required: Gross amount (net + tax).
          - `total` PolicyAmendmentQuoteAmountResponse, required
            - `net` number, double, required: Net amount before tax.
            - `tax` number, double, required: Tax amount.
            - `gross` number, double, required: Gross amount (net + tax).
      - `associated_persons` PolicyAmendmentAssociatedPersonsResponse
        - `type` 'dependents', required
        - `dependents` PolicyAmendmentDependentsResponse
          - `dependents_management_intent_id` string, nullable: Unique identifier for the dependents management intent. Prefixed with `dmi_`. Null if not yet created.
          - `status` 'action_required' | 'processing' | 'completed' | 'not_undertaken'
    - `processing_error` PolicyAmendmentProcessingErrorResponse
      - `code` 'provider_rejected' | 'unable_to_quote', required
      - `reason` string, required: Brief reason for the processing error.
      - `reason_description` string, required: Detailed description of the processing error.
    - `disclosures` DisclosureResponse[], required: Disclosures associated with this intent.
      - `category` 'regulatory' | 'provider' | 'intermediary', required
      - `type` 'intermediary_role' | 'intermediary_commission' | 'underwriter_disclaimer' | 'anti_selection_notice' | 'statement_of_needs' | 'product_information' | 'pre_existing_conditions' | 'statutory_warning' | 'privacy_policy' | 'terms_of_business', required
      - `title` string, required: The title of the disclosure statement.
      - `text` string, required: The disclosure statement text. It may contain `{token}` placeholders, each of which has exactly one entry in `links` and must be rendered as an anchor to that link. A disclosure with no links contains no placeholders, so plain text stays plain text.
      - `links` DisclosureLinkResponse[], required: The documents `text` names, one per placeholder it carries. Empty for a disclosure that is text only.
        - `token` string, required: The placeholder this link fills. It appears in the disclosure's `text` wrapped in braces, as `{token}`, and matches `^[a-z][a-z0-9_]*$`. Tokens are unique within one disclosure, and every token in the text has exactly one link here.
        - `type` 'intermediary_role' | 'intermediary_commission' | 'underwriter_disclaimer' | 'anti_selection_notice' | 'statement_of_needs' | 'product_information' | 'pre_existing_conditions' | 'statutory_warning' | 'privacy_policy' | 'terms_of_business', required
        - `label` string, required: The anchor text to display in place of the token.
        - `url` string, required: Absolute HTTPS URL of the document.
        - `version` string, required: Version of the document at the URL, so a record of what was shown can name the exact document the customer could have read.
  - `page` integer, required: The current page of the results
  - `page_size` integer, required: The number of results on this page. This can be different from the requested page size if the total number of results is less than the requested page size
  - `total_count` integer, required: The total number of elements available in the response. This is the total number of elements available across all pages, not just the current page.
  - `has_next_page` boolean: Whether there are more pages available after this page
  - `has_previous_page` boolean: Whether there are more pages available before this page

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-10-26** `998f7cb004ab`: 1 warning
  - deleted the `header` request parameter `X-Platform-Id`
- **2026-10-16** `af8813bdc38e`: 1 info
  - added the required property `items/items/disclosures/items/title` to the response with the `200` status
- **2026-09-23** `8e085d2adbff`: 2 warning, 1 info
  - added the new `privacy_policy` enum value to the `items/items/disclosures/items/type/allOf[#/components/schemas/DisclosureType]/` response property for the response status `200`
  - added the new `terms_of_business` enum value to the `items/items/disclosures/items/type/allOf[#/components/schemas/DisclosureType]/` response property for the response status `200`
  - added the required property `items/items/disclosures/items/links` to the response with the `200` status
- **2026-08-07** `7b8b3ed87c96`: 1 info
  - added the new optional `header` request parameter `X-Platform-Id`

[Operation history](https://skmtc.dev/kota/apis/kota-api/changes/policies/:policy_id/policy_amendment_intents/get.md)

---

[API](https://skmtc.dev/kota/apis/kota-api.md) - [All operations](https://skmtc.dev/kota/apis/kota-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kota/apis/kota-api/revisions/998f7cb004ab?raw)