Get a property definition

GET

/v1/property_definitions/:id

curl "https://api.summerbase.com/v1/property_definitions/:id" \
  -H "Authorization: Bearer sb_..."

Fetch one property definition.

Parameters

Path Parameters

id

required

string format: uuid

The definition’s Summerbase id.

Example

0198f1a5-7a8b-7c9d-8e0f-1a2b3c4d5e6f

Query Parameters

expand[]

Array<string>

<= 10 items

Allowed values: source

Relationships to include in the response instead of fetching separately. A dotted path expands what an expanded record can expand in turn — at most 4 deep, 10 paths a request, and never back to a record already on the path.

Response

Returns the property definition object.

Media typeapplication/json

Example

{
  "archived": false,
  "created_at": "2026-02-11T09:20:13Z",
  "id": "0198f1a5-7a8b-7c9d-8e0f-1a2b3c4d5e6f",
  "key": "seats",
  "label": "Seats",
  "object": "property_definition",
  "source_id": "0198f1a3-0c18-7d93-a6e2-1b4f9d7c3a58",
  "subject_type": "customer",
  "value_type": "number"
}