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

# Find person by MDN

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

## Path parameters

- `company_key` string, required

## Query parameters

- `mdn` 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

- `400` — Invalid MDN format. If you are using E.164 format, be sure to include %2B in place of +.
- `404` — MDN not found. This can be returned if you don’t specify an MDN, or if there are no person records associated with that MDN.

---

[API](https://skmtc.net/vibes/apis/vibes-platform-api.md) · [All operations](https://skmtc.net/vibes/apis/vibes-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vibes/vibes-platform-api/revisions/2d5797ce1b84/schema)