Skip to main content
GET
/
api
/
v1
/
beam
/
{config_id}
/
transforms
/
{transform_uid}
/
filter-values
List Filter Values Handler
curl --request GET \
  --url https://api.allium.so/api/v1/beam/{config_id}/transforms/{transform_uid}/filter-values \
  --header 'X-API-KEY: <api-key>'
{
  "values": [
    "<string>"
  ],
  "total_count": 123,
  "cursor": 123
}
Returns a paginated list of values in the filter. Changes to filter values take effect immediately — no redeploy needed.
Required permission: read — owners, editors, readers, and members of teams shared via viewer_team.
Path parameters:
ParameterDescription
config_idPipeline configuration ID
transform_uidUID of the set filter transform
Query parameters:
ParameterDefaultDescription
cursornullPagination cursor from a previous response
count100Number of values per page (1-10,000)
curl -X GET "https://api.allium.so/api/v1/beam/${CONFIG_ID}/transforms/${TRANSFORM_UID}/filter-values?count=100" \
  -H "X-API-Key: ${ALLIUM_API_KEY}"
Response: 
{
  "values": ["0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "0xc2132d05d31c914a87c6611c10748aeb04b58e8f"],
  "cursor": 42,
  "total_count": 1500
}
FieldDescription
valuesArray of values in the current page
cursorCursor for the next page, null if no more pages
total_countTotal number of values in the filter

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
config_id
string
required
​
transform_uid
string
required

Query Parameters

​
cursor
integer
​
count
integer
default:100
Required range: 1 <= x <= 1000000

Response

Successful Response

​
values
string[]
required
​
total_count
integer
required
​
cursor
integer | null