---
title: "List Identity Contact Permissions"
method: GET
path: "/api/v1/identities/{agent_handle}/contact-permissions"
tags: ["Identities"]
---

# List Identity Contact Permissions

`GET /api/v1/identities/{agent_handle}/contact-permissions`

## Path parameters

- `agent_handle` string, required

## Query parameters

- `q` string, nullable
- `limit` integer
- `offset` integer
- `order` 'name' | 'recent'
- `review_status` ContactReviewStatus[], nullable

## Response `200`

Successful Response

- ContactPermissionPage
  - `notices` ResponseNotice[], nullable
    - `code` string, required
    - `level` string, required
    - `message` string, required
  - `items` ContactPermissionEntry[], required
    - `contact` ContactPermissionSummary, required
      - `id` string, uuid, required
      - `preferred_name` string, nullable, required
      - `given_name` string, nullable, required
      - `family_name` string, nullable, required
      - `company_name` string, nullable, required
      - `review_status` 'unreviewed' | 'confirmed', required
      - `emails` ContactEmailItem[], required
        - `value` string, email, required
        - `label` string, nullable
        - `is_primary` boolean
      - `phones` ContactPhoneItemResponse[], required
        - `value_e164` string, required
        - `label` string, nullable
        - `is_primary` boolean
    - `revision` integer, required
    - `visibility` ContactPermissionVisibility, required
      - `defaults` ContactVisibilityDecisions, required
        - `profile` 'inherit' | 'allow' | 'block', required
        - `memories` 'inherit' | 'allow' | 'block', required
      - `identity_override` ContactVisibilityDecisions, required
        - `profile` 'inherit' | 'allow' | 'block', required
        - `memories` 'inherit' | 'allow' | 'block', required
    - `effective` ContactPermissionEffective, required
      - `profile` boolean, required
      - `memories` boolean, required
      - `email` 'all' | 'some' | 'none' | 'no_identifiers', required
      - `phone` 'all' | 'some' | 'none' | 'no_identifiers', required
      - `inbound_email` 'all' | 'some' | 'none' | 'no_identifiers'
      - `outbound_email` 'all' | 'some' | 'none' | 'no_identifiers'
      - `inbound_phone` 'all' | 'some' | 'none' | 'no_identifiers'
      - `outbound_phone` 'all' | 'some' | 'none' | 'no_identifiers'
    - `access` ContactAccessSettingsResponse
      - `notices` ResponseNotice[], nullable
        - `code` string, required
        - `level` string, required
        - `message` string, required
      - `email` ContactChannelAccessResponse, required
        - `visible` boolean, required
        - `contactable` string[], required
        - `inbound_contactable` string[]
        - `outbound_contactable` string[]
      - `phone` ContactChannelAccessResponse, required
        - `visible` boolean, required
        - `contactable` string[], required
        - `inbound_contactable` string[]
        - `outbound_contactable` string[]
      - `profile` boolean, required
      - `memories` boolean, required
  - `limit` integer, required
  - `offset` integer, required
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

## Changes

- **2026-09-22** `f3dcdb50fbaa` — 10 info
  - added the optional property `items/items/access/anyOf[subschema #1: ContactAccessSettingsResponse]/email/inbound_contactable` to the response with the `200` status
  - added the optional property `items/items/access/anyOf[subschema #1: ContactAccessSettingsResponse]/email/outbound_contactable` to the response with the `200` status
  - added the optional property `items/items/access/anyOf[subschema #1: ContactAccessSettingsResponse]/notices` to the response with the `200` status
  - added the optional property `items/items/access/anyOf[subschema #1: ContactAccessSettingsResponse]/phone/inbound_contactable` to the response with the `200` status
  - …6 more
- **2026-09-15** `1393694554cc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/inkbox/apis/inkbox-api/changes/api/v1/identities/:agent_handle/contact-permissions/get.md)

---

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