---
title: "Get custom property group"
method: GET
path: "/v1/custom-properties/groups/{groupId}"
tags: ["v1 - Custom Properties"]
---

# Get custom property group

`GET /v1/custom-properties/groups/{groupId}`

## Request

- Base URL: `https://light.inc` (the document declares no server; this is the origin it was published from)
- URL: `https://light.inc/v1/custom-properties/groups/{groupId}`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

Returns a custom property group by ID

## Path parameters

- `groupId` string, uuid, required

## Response `default`

default response

- ExternalCustomPropertyGroupV1Model: List of records for the current page
  - `id` string, uuid
  - `companyId` string, uuid
  - `label` string
  - `internalName` string
  - `inputType` 'SINGLE_SELECT' | 'MULTI_SELECT' | 'NUMERIC' | 'TEXT' | 'BOOLEAN' | 'DATE': ⚠️ This enum is not exhaustive; new values may be added in the future.
  - `objectLevel` 'HEADER' | 'LINE': ⚠️ This enum is not exhaustive; new values may be added in the future.
  - `objectTypes` string[]
  - `objectTypeStatuses` object
  - `isRequired` boolean
  - `context` string
  - `values` ExternalCustomPropertyValueV1Model[]
    - `id` string, uuid: Unique identifier for the object
    - `groupId` string, uuid: ID of the custom property group
    - `groupInternalName` string: Internal name of the custom property group
    - `companyId` string, uuid: ID of the company
    - `internalName` string: Internal name of the custom property value
    - `label` string: Label of the custom property value
    - `context` string, nullable: Context/description of the custom property value
    - `createdAt` string, date-time: Timestamp when the custom property value was created
    - `updatedAt` string, date-time: Timestamp when the custom property value was last updated
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

---

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