List custom fields
The band’s own fields on core tables. Each row is one real column, named with the x_ prefix, on the table it belongs to. Retiring a field hides it everywhere and keeps its data.
Query Parameters
- Type: integerlimitmin:0max:200
Page size, 50 by default, 200 at most.
- Type: integeroffsetmin:0
Records to skip.
- Type: stringsort
Comma-separated fields; prefix with
-for descending. Sortable: label, entity, key, field_type, options, relation, required, description, order, status, created_time, last_edited_time, id. Default: entity,order,label. - Type: stringfields
Comma-separated subset of fields to return.
idis always included. - filter[label]
Shorthand
filter[label]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.- Type: string
Shorthand
filter[label]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
- filter[entity]
Shorthand
filter[entity]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.- Type: string
Shorthand
filter[entity]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
- filter[key]
Shorthand
filter[key]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.- Type: string
Shorthand
filter[key]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
- filter[field
_type] Shorthand
filter[field_type]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.- Type: stringenum
Shorthand
filter[field_type]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.valuesrich_textnumbercurrencydatetimecheckboxselectmulti_selecturlemailphone_numberrelation
- filter[options]
Shorthand
filter[options]=valuemeans equals. Operators: contains, does_not_contain, is_empty, is_not_empty.- Type: string
Shorthand
filter[options]=valuemeans equals. Operators: contains, does_not_contain, is_empty, is_not_empty.
- filter[relation]
Shorthand
filter[relation]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.- Type: string
Shorthand
filter[relation]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
- filter[required]
Shorthand
filter[required]=valuemeans equals. Operators: equals, does_not_equal.- Type: boolean
Shorthand
filter[required]=valuemeans equals. Operators: equals, does_not_equal.
- filter[description]
Shorthand
filter[description]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.- Type: string
Shorthand
filter[description]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
- filter[order]
Shorthand
filter[order]=valuemeans equals. Operators: equals, does_not_equal, greater_than, less_than, greater_than_or_equal_to, less_than_or_equal_to, is_empty, is_not_empty.- Type: number
Shorthand
filter[order]=valuemeans equals. Operators: equals, does_not_equal, greater_than, less_than, greater_than_or_equal_to, less_than_or_equal_to, is_empty, is_not_empty.
- filter[status]
Shorthand
filter[status]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.- Type: "active" or "retired"enum
Shorthand
filter[status]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
- filter[created
_time] Shorthand
filter[created_time]=valuemeans equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.- Type: stringFormat: date-time
Shorthand
filter[created_time]=valuemeans equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.
- filter[last
_edited _time] Shorthand
filter[last_edited_time]=valuemeans equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.- Type: stringFormat: date-time
Shorthand
filter[last_edited_time]=valuemeans equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.
Responses
- application/json
- application/json
- application/json
- application/json
curl 'https://api.weddingoperatingsystems.com/api/v1/custom-fields?limit=50&offset=0&sort=entity%2Corder%2Clabel' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"label": null,
"entity": null,
"key": null,
"field_type": "rich_text",
"options": [
"string"
],
"relation": null,
"required": true,
"description": null,
"order": null,
"status": "active",
"created_time": "2026-10-05T17:38:27.329Z",
"last_edited_time": "2026-10-05T17:38:27.329Z"
}
],
"meta": {
"total": 1,
"limit": 1,
"offset": 1
}
}