---
title: "Get person by person_key"
method: GET
path: "/companies/{company_key}/mobiledb/persons/{person_key}"
tags: ["Person API"]
---

# Get person by person_key

`GET /companies/{company_key}/mobiledb/persons/{person_key}`

## Request

- Base URL: `https://public-api.vibescm.com`
- URL: `https://public-api.vibescm.com/companies/{company_key}/mobiledb/persons/{person_key}`
- Auth: HTTP basic

## Path parameters

- `company_key` string, required
- `person_key` string, required

## Headers

- `X-API-Version` string

## Response `200`

Successful response.

- PersonResponse
  - `person_key` string: A unique Vibes-asigned alphanumeric identifier for each person record.
  - `external_person_id` string: A unique person identifier assigned by the brand, which can be used to link non-Vibes-assigned identifiers to Vibes person records. Max 128 characters.
  - `mobile_phone` object: Object representation of a person's mobile phone. A person can have only one active mobile phone at a time.
    - `mdn` string: Mobile Directory Number. The dialable phone number associated with the phone.
    - `carrier_code` string: The cellular carrier associated with this mobile number.
  - `custom_fields` object: list of custom field key/value pairs.
  - `created_at` string: The date this person was created, in the ISO-8601 format.
  - `updated_at` string: The date this person was last updated, in the ISO-8601 format.
  - `url` string

## Other responses

- `404`: The person record cannot be found using this `person_key`.
- `422`: The server understands the content type of the request entity, and the syntax of the request entity is correct, but it was unable to process the contained instructions.

---

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