---
title: "Retrieve a policy import intent"
method: GET
path: "/policy_import_intents/{policy_import_intent_id}"
tags: ["Policy Import Intents"]
---

# Retrieve a policy import intent

`GET /policy_import_intents/{policy_import_intent_id}`

## Request

- Base URL: `https://test.api.kota.io`
- URL: `https://test.api.kota.io/policy_import_intents/{policy_import_intent_id}`
- Auth: HTTP bearer

Retrieves a `policy_import_intent` object.

## Path parameters

- `policy_import_intent_id` string, required

## Response `200`

OK

- PolicyImportIntentResponse
  - `id` string, required: Unique identifier for the policy import intent. Prefixed with `pii_`.
  - `object` string: Object type identifier.
  - `status` 'processing' | 'failed' | 'success', required
  - `employee_id` string, required: The employee ID for the policy import. Prefixed with `ee_`.
  - `group_id` string, required: The group ID for the policy import. Prefixed with `g_`.
  - `group_policy_id` string, nullable: The group policy the policy is imported onto. Prefixed with `gp_`. Null if none was given.
  - `provider_policy_number` string, required: The provider's policy number.
  - `member_number` string, required: The member number assigned by the provider.
  - `policy_start_date` string, date, required: The start date of the policy.
  - `policy_end_date` string, date, nullable: The end date of the policy. Null if the policy has no end date, or end date is not known.
  - `associated_persons` PolicyImportIntentAssociatedPersonResponse[], required: List of associated persons linked to this policy import.
    - `id` string, uuid, required: Unique identifier for the associated person import.
    - `associated_person_id` string, required: The associated person ID. Prefixed with `ap_`.
    - `member_number` string, nullable: The member number assigned by the provider for this associated person.
    - `start_date` string, date, nullable: The start date for this associated person's coverage.
    - `end_date` string, date, nullable: The end date for this associated person's coverage.

## Other responses

- `404`: Not Found

## Changes

- **2026-10-26** `998f7cb004ab`: 1 warning
  - deleted the `header` request parameter `X-Platform-Id`
- **2026-10-12** `88593225ec11`: 1 info
  - added the optional property `group_policy_id` 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/policy_import_intents/:policy_import_intent_id/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)