Skip to main content
GET
List tags
GET /v1/tag requires Tags: Read (tags.view). Optional query parameters are search, page_size (1100), starting_after, and ending_before. The response contains complete tags plus cursor pagination; cursors use biq_tag_... IDs. Each tag’s color is a supported lowercase color name, while null represents the default gray style. Unknown filters and both cursor directions together return 422 validation_error.

Shared API behavior

Authentication is workspace-scoped; see Authentication. Errors use the standard envelope and request IDs described in Errors, and requests are subject to Rate limits. This endpoint uses cursor pagination; see Pagination.

Authorizations

Authorization
string
header
required

A workspace API key beginning with biqli_.

Query Parameters

Required string length: 1 - 255
page_size
integer
default:50
Required range: 1 <= x <= 100
starting_after
string

Next-page public ID cursor; mutually exclusive with ending_before.

ending_before
string

Previous-page public ID cursor; mutually exclusive with starting_after.

Response

Tag list.

tags
object[]
required
pagination
object
required
status
string
required
Allowed value: "success"