List channels

get /api/channels

Retrieves the collection of Channel resources.

Returns a paginated collection of channels in the current organization. Set Flowkiwi-Locale to read the translatable name in a given locale.

Headers

Name	Type	Required	Description
`Flowkiwi-Locale`	`string`	-	Specifies the locale for properties that support localization. If not provided, the default locale will be used.

Name	Type	Required	Description
`page`	`integer`	-	The collection page number
`itemsPerPage`	`integer`	-	The number of items per page
`properties[]`	`string[]`	-	Allows you to reduce the response to contain only the properties you need. If your desired property is nested, you can address it using nested arrays. Example: properties[]={propertyName}&properties[]={anotherPropertyName}&properties[{nestedPropertyParent}][]={nestedProperty}
`id[]`	`string[]`	-	Only the items with one of these ids, each a UUID or the item IRI.
`status`	`string`	-	Channel status
`status[]`	`string[]`	-	Channel status
`name`	`string`	-	Filter on the translated "name" field (case-insensitive partial match, uses the Flowkiwi-Locale header).
`order[name]`	`string`	-	Order by translated field "name" (uses the Flowkiwi-Locale header)
`productsCount`	`integer`	-	Filter by the exact number of related "products".
`productsCount[gte]`	`integer`	-	Filter by the number of related "products" (gte).
`productsCount[gt]`	`integer`	-	Filter by the number of related "products" (gt).
`productsCount[lte]`	`integer`	-	Filter by the number of related "products" (lte).
`productsCount[lt]`	`integer`	-	Filter by the number of related "products" (lt).
`order[createdAt]`	`string`	-	Channel order[createdAt]
`order[updatedAt]`	`string`	-	Channel order[updatedAt]

200 - Channel collection

Format

Property Type Required Description

search object -

Show search fields

Property Type Required Description

@type string -

mapping object[] -

Show mapping fields

Property	Type	Required
`@type`	`string`	-
`property`	`string \| null`	-
`required`	`boolean`	-
`variable`	`string`	-

template string -

variableRepresentation string -

totalItems integer -

view object -

Show view fields

Property	Type	Required
`@id`	`string`	-
`@type`	`string`	-
`first`	`string \| null`	-
`last`	`string \| null`	-
`next`	`string \| null`	-
`previous`	`string \| null`	-

member Channel[] required

Show member fields

Property	Type	Required	Description
`@context`	`string \| object`	-
`@id`	`string`	required
`@type`	`string`	required
`createdAt`	`string`	-	The date and time when the resource was created (ISO 8601 format).
`id`	`string`	-	The resource's unique identifier (UUID).
`name`	`string \| null`	-	This property supports translations. The display name of the channel.
`products`	`string[]`	-	A list of `Product` IRIs published to the channel. Requires the `products:read` scope. Returned empty when the scope is missing.
`status`	`"/api/statuses/DRAFT" \| "/api/statuses/ACTIVE" \| "/api/statuses/ARCHIVED"`	-	The status of the channel.
`updatedAt`	`string`	-	The date and time when the resource was last modified (ISO 8601 format).

403 - Access denied. The caller is missing one or more permissions required for this operation.

Content-Type: application/problem+json

Property	Type	Required	Description
`@context`	`string \| object`	-
`@id`	`string`	required
`@type`	`string`	required
`detail`	`string`	-
`missingPermissions`	`string[]`	-	Permissions that the caller is missing for this operation. Present only when the 403 is caused by a denied permission.
`status`	`integer`	-
`title`	`string`	-
`type`	`string`	-