---
title: "Get a specific contact"
method: GET
path: "/contacts/{contactId}"
tags: ["contacts"]
---

# Get a specific contact

`GET /contacts/{contactId}`

Retrieves all data and phone numbers for a specific contact by their identifier.

**Permission:** `Contacts Read` required.

**Monitoring:** No impact.

## Path parameters

- `contactId` integer, required

## Response `200`

Successful operation — the contact details are returned.

- ContactFull
  - `contact_id` integer
  - `is_shared` boolean
  - `im_owner` boolean
  - `social_service` string, nullable
  - `social_service_id` string, nullable
  - `social_profile_url` string, nullable
  - `social_data` string, nullable
  - `firstname` string
  - `lastname` string
  - `company` string
  - `concat_name` string
  - `color` string
  - `initial` string
  - `profile_picture` string
  - `creation_date` string, date-time
  - `numbers` NumberLightWithFormat[]
    - `number` integer
    - `type` string
    - `format` FormatNumber
      - `raw` integer
      - `country_code` string
      - `country` string
      - `e164` string
      - `international` string
      - `international_alt` string
      - `national` string
      - `national_alt` string
      - `rfc3966` string
      - `is_short_code` boolean

## Other responses

- `304` — Contact has not changed since the last request.
- `400` — Invalid contact ID format.
- `401` — Unauthorized — missing or invalid API token, or missing `Contacts Read` permission.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)