---
title: "Find by person ID"
method: GET
path: "/group-profile/v1/profiles/persons/{personId}"
tags: ["ProfilePerson"]
---

# Find by person ID

`GET /group-profile/v1/profiles/persons/{personId}`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/group-profile/v1/profiles/persons/{personId}`
- Auth: HTTP bearer

Get all profile where person is the target (reverse lookup)

## Path parameters

- `personId` integer, required

## Query parameters

- `personType` 'CONTACT' | 'GUEST', required: Type of persons
- `pageToken` string
- `limit` integer

## Headers

- `x-property-id` integer
- `x-organization-id` integer, required

## Response `200`

Person found successfully

- ProfilePersonListResponse: Cursor-based pagination metadata for list responses
  - `data` ProfilePersonResponse[]: Array of profile person relationship data
    - `profileId` string: ID of the profile entity (source)
    - `personId` string: ID of the person/guest (target)
    - `personType` 'CONTACT' | 'GUEST': Type of persons
    - `relationshipType` 'EMPLOYEE' | 'BOOKED_BY' | 'PART_OF_GROUP' | 'CONTACT' | 'GUEST' | 'DECISION_MAKER' | 'TRAVELER' | 'PRIMARY' | 'SECONDARY' | 'BILLING_CONTACT' | 'EMERGENCY_CONTACT': Type of relationship between person and profile
    - `isMainContact` boolean: Whether this person is the main contact (applicable for CONTACT person type)
    - `startDate` string, date: Start date of the relationship
    - `endDate` string, date: End date of the relationship (null for active)
    - `role` 'BOOKING_COORDINATOR' | 'ONSITE_COORDINATOR' | 'ROOMING_LIST_CONTACT' | 'ACCOUNTS_PAYABLE' | 'BILLING' | 'INVOICING' | 'ACCOUNT_MANAGER' | 'SALES_LEAD' | 'TRAVEL_AGENT_ACCOUNT_MANAGER' | 'CORPORATE_CONTACT' | 'AUTHORIZED_SIGNER' | 'EXECUTIVE_APPROVER' | 'MARKETING' | 'MAIN_POINT_OF_CONTACT' | 'ADMINISTRATIVE' | 'OTHER': Role of person in the profile relationship
    - `metadata` object: Additional relationship metadata
  - `nextPageToken` string, nullable: Token to fetch the next page of results. Pass this value as the `pageToken` query parameter in the next request. When null, there are no more pages available.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/cloudbeds/apis/group-profile-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/group-profile-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/group-profile-api/revisions/a1801dfbb09e?raw)