List all handoff tickets across user's projects

GET

/tickets

const url = 'https://example.com/api/tickets';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/tickets \
  --header 'Authorization: Bearer <token>'

Returns all handoff tickets across all projects the user has access to, enriched with project metadata.

Authorizations

bearerApiKey
cookieAuth

Responses

200

All user’s tickets

application/json

object

tickets

required

Array

object

required

string format: uuid

project_id

required

string format: uuid

billing_account_id

string format: uuid

milestone_id

string | null format: uuid

source

string

number

required

integer

title

required

string

description

Full ticket body; omitted from list rows when slim=1

string

request_type

required

string

Allowed values: bug clarification_needed decision_needed feature_request

status

required

string

Allowed values: open closed

stage

required

string

Allowed values: backlog up_next in_progress validation live

priority

required

string

Allowed values: low medium high

blocking

required

boolean

created_at

required

string format: date-time

updated_at

string | null format: date-time

merge_sha

string | null

deployed_at

string | null format: date-time

deploy_failed_at

string | null format: date-time

resolution_type

string | null

reported_by_user_id

string | null format: uuid

suggested_resolution

string | null

implementation_notes

Requester-provided implementation guidance for the assignee

string | null

resolution_note

string | null

resolved_at

string | null format: date-time

evidence

object | null

category

Alias of request_type

string

severity

Alias of priority

string

suggested_backend_change

Alias of suggested_resolution

string | null

roles

Assigned ticket roles

Array<object>

Row from handoff_request_roles embedded on ticket list/detail responses.

object

required

string format: uuid

handoff_request_id

required

string format: uuid

role

required

string

Allowed values: frontend backend test design devops qa other

status

required

string

Allowed values: pending in_progress done skipped

assignee_user_id

string | null format: uuid

assignee_note

string | null

blocking_reason

string | null

work_started_note

string | null

agent_origin

string | null

started_at

string | null format: date-time

completed_at

string | null format: date-time

created_at

required

string format: date-time

updated_at

required

string format: date-time

summary

Present on list responses

string

ticket_ref

Present on list responses (HO-{number}-{project-slug})

string

project_name

string

backend_repo

string | null

frontend_repo

string | null

can_triage

boolean

github_issue_number

integer | null

github_issue_url

string | null format: uri

401

Not authenticated

application/json

object

error

required

Human-readable error message

string

code

Stable machine-readable error code for client branching

string

fieldErrors

First validation message per field path

object

key

additional properties

string

issues

Structured validation issues (Zod)

Array<object>

object

path

required

string

message

required

string

retryAfter

Seconds until rate limit resets (429 responses)

number

reconnect

True if re-linking GitHub may fix the issue

boolean