---
title: "Get policy by its ID"
method: GET
path: "/api/v2/policies/{id}"
---

# Get policy by its ID

`GET /api/v2/policies/{id}`

## Path parameters

- `id` integer, required

## Response `200`

Success

- object
  - `data` Policy
    - `date_of_birth` string, date — ISO8601 date format
    - `documents` object[]
      - `type` 'policy' | 'policy_application'
      - `url` string
    - `effective_date` string, date — When the customer's coverage starts - i.e. they can request a claim if something happens
    - `email` string, email
    - `expiration_date` string, date — When the customer's coverage ends - i.e. they can no longer use the insurance
    - `first_last_name` string — Usually the paternal name
    - `first_name` string — Given name
    - `id` integer — Unique identifier that can be used to get a policy via `GET /api/v2/policies/{id}`
    - `master_policy_id` string — The ID of the master policy in the insurance carrier's system. Customers will need this information to request a claim
    - `policy_id` string — This individual policy's ID in the insurance carrier's system. Customers will need this information to request a claim
    - `premium` number
    - `product` 'group_life'
    - `rfc` string — Mexican tax id for individuals, has 4 letters followed by 6 digits and another 3 chars
    - `second_last_name` string — Usually the maternal name
    - `status` 'pending' | 'issued' | 'in_force' | 'cancelled' | 'rescinded' | 'expired' | 'declined' | 'voided'

## Other responses

- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/super/apis/super-seguros.md) · [All operations](https://skmtc.net/super/apis/super-seguros/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/super/super-seguros/revisions/17ba5cf3a3c1/schema)