CLcloudbeds
Profile

List all profiles across all types

get/group-profile/v1/profiles

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/group-profile/v1/profiles
  • Auth
    HTTP bearer

Query parameters

profileIdsinteger[]

Filter profiles by specific IDs (comma-separated list)

statusProfileStatus[]

Filter by profile status

[
  "ACTIVE"
]
profileTypeProfileType[]

Filter by profile types (supports multiple selections)

namestring

Filter profiles by name containing this text (case-insensitive partial match)

codestring

Filter profiles by code containing this text (case-insensitive partial match)

sortstring

Sort profiles by field and direction in format: field:direction Examples: name:asc, createdAt:desc, code:asc Valid fields: code, name, createdAt, updatedAt, profileType, status Valid directions: asc, desc Default: name:asc

pageTokenstring

Cursor token for pagination. Use the nextPageToken from the previous response to fetch the next page.

Usage:

  • Omit or pass empty string for the first page
  • Pass the nextPageToken from previous response for subsequent pages
  • When nextPageToken is null in the response, you've reached the last page

Benefits over offset-based pagination:

  • Consistent results even when data changes between requests
  • Better performance for large datasets (no row skipping)
  • No maximum page limit
limitinteger

Page size. Specifies the maximum number of items to return in a single response.

Limits:

  • Minimum: 1
  • Maximum: 500
  • Default: 100

Headers

x-property-idinteger

Property ID

x-organization-idinteger required

Organization ID

Response

List all profiles successfully

nextPageTokenstring 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.

Example response

{
  "data": [
    {
      "id": "19074818619469856",
      "status": "ACTIVE",
      "billingDetails": {
        "billingCurrency": "USD",
        "paymentMethod": "CREDIT_CARD",
        "billingFrequency": "MONTHLY"
      },
      "attributes": {
        "companyProfile": {
          "companyType": "CORPORATE"
        },
        "travelAgentProfile": {
          "agencyType": "RETAIL"
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.