---
title: "List requirements for a group quote intent"
method: GET
path: "/group_quote_intents/{group_quote_intent_id}/requirements"
tags: ["Group Quote Intents"]
---

# List requirements for a group quote intent

`GET /group_quote_intents/{group_quote_intent_id}/requirements`

## Request

- Base URL: `https://test.api.kota.io`
- URL: `https://test.api.kota.io/group_quote_intents/{group_quote_intent_id}/requirements`
- Auth: HTTP bearer

Returns a paginated list of adaptive requirements for a `group_quote_intent`. Requirements must be fulfilled before a quote can be generated.

## Path parameters

- `group_quote_intent_id` string, required

## Query parameters

- `object_type` 'employee' | 'employer' | 'associated_person'
- `object_id` string: Filter by object ID (employee ID or employer ID)
- `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

- GroupQuoteIntentRequirementResponsePagedList
  - `items` GroupQuoteIntentRequirementResponse[], required: A paginated array containing the response elements
    - `id` string, required: Identifier of the requirement. Take it to the Adaptive Requirements public routes as-is: an `ar_` id is one requirement, an `ars_` id is a set of requirements composed into one form.
    - `object_type` 'employee' | 'employer' | 'associated_person', required
    - `object_id` string, required: Identifier of the object (employee ID or employer ID)
    - `is_fulfilled` boolean, required: Whether the requirement has been fulfilled
    - `requirement_type` 'group_quote_intent' | 'group_policy_intent' | 'dependent_management_intent' | 'policy_amendment_intent' | 'enrolment_intent', required
    - `object` string: Object type identifier
  - `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

- `404`: Not Found

## Changes

- **2026-10-26** `998f7cb004ab`: 1 warning
  - deleted the `header` request parameter `X-Platform-Id`
- **2026-09-11** `e3330182d67f`: 1 info
  - the `items/items/id` response's property pattern was changed from `ar_.+` to `(ar_|ars_).+` for the status `200`
- **2026-08-27** `751269b628e8`: 1 breaking, 1 warning, 7 info
  - the `query` request parameter `object_type` was restricted to a list of enum values
  - for the `query` request parameter `object_type`, the type of property `allOf[#/components/schemas/RequirementObjectTypeEnumParameter]/` changed from `object` to `string`
  - added the new enum value `associated_person` to the `query` request parameter `object_type`
  - added the new enum value `employee` to the `query` request parameter `object_type`
  - …5 more
- **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/group_quote_intents/:group_quote_intent_id/requirements/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)