DocsAPI ReferenceContact/bff/contact-segment/options
getContactAdmin BFF

/bff/contact-segment/options

Returns {value,label} pairs scoped to the caller organisation. value = opaque per-organisation code (orderGroup.code / product.code / productCategory.code); internal numeric IDs are never exposed. Used by the admin segment editor to populate autocomplete pickers and to render chip labels for already-selected codes.

ContactgetBffContact-segmentOptions

Parameters

4 query

4 total
Query · 4
refTypestringRequired

One of: orderGroup, product, productCategory.

qstring

Free-text search query.

codesstring

Comma-separated list of codes to resolve to {value,label} pairs (used to render existing selections without an extra round-trip per chip).

limitstring

Request

GET /bff/contact-segment/options

get
curl -X GET "https://api.bizkithub.com/bff/contact-segment/options?refType=example_refType&q=example_q&codes=example_codes&limit=example_limit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

JSON payload

{
  "items": [
    {
      "value": "example_value",
      "label": "example_label"
    }
  ]
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key