Tickets

List tickets

Returns a list of tickets in your organization using cursor-based pagination.

GET

/v2/tickets

List tickets

curl --request GET \
  --url 'https://do.featurebase.app/v2/tickets?limit=10&cursor=eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9&ticketCategoryIds=%3Cstring%3E&statusIds=%3Cstring%3E&q=%3Cstring%3E&assigneeId=%3Cstring%3E&categoryType=customer&sortBy=date&sortOrder=desc' \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit'

{
  "data": [],
  "nextCursor": "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9",
  "object": "list"
}

Query Parameters

Parameter	Type	Description
`limit`	number	Number of tickets to return (1-100, default 10)
`cursor`	string	Cursor from previous response for pagination
`ticketCategoryIds`	string[]	Filter by ticket category IDs
`statusIds`	string[]	Filter by status IDs
`q`	string	Search query
`assigneeId`	string	Filter by assignee ID
`categoryType`	string	Filter by category type: "customer", "tracker", or "back-office"
`sortBy`	string	Sort field: "date" (default), "recent", or "ticketNumber"
`sortOrder`	string	Sort direction: "asc" or "desc" (default)

Response

Returns a list object with data (array of ticket objects) and nextCursor.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Query Parameters

limitintegerquerydefault:10

Required range: 1 <= x <= 100

cursorstringquery

An opaque cursor for pagination. Use the nextCursor value from a previous response to fetch the next page of results.

Maximum string length: 512

Example: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9

ticketCategoryIdsstring[]query

statusIdsstring[]query

qstringquery

assigneeIdstringquery

categoryTypeenum<string>query

Available options: customer, tracker, back-office

sortByenum<string>querydefault:date

Available options: date, recent, ticketNumber

sortOrderenum<string>querydefault:desc

Available options: asc, desc

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-08-19.orbit

Response

Success

dataobject[]required

Array of tickets

Show child attributes

nextCursorstring | nullrequired

Cursor for fetching the next page

Maximum string length: 512

Example: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9

objectenum<string>required

Object type identifier

Available options: list

Example: list

Still need help? Ask the team