Skip to main content
GET
List defects
Requires read:defects. Returns defects for the authenticated builder with project, location, assigner, assignee, and signed attachment data. Defect IDs use the defect_ prefix, and project location IDs use the loc_ prefix. Assignees are exposed as USER (wkr_ or user_ IDs), COMPANY (sub_ IDs), or TAG (tag_ IDs); assigner IDs use the user_ prefix. Supply the prefixed project location ID when filtering with locationId.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

builderId
string
required
Example:

"buil_clgbsb90b001qjy0f0eo1hspp"

Query Parameters

projectId
string

Filter by a proj_-prefixed project ID

Example:

"proj_clgbsb90b001qjy0f0eo1hscp"

status
enum<string>[]

Filter by defect status. Repeat the parameter for multiple values.

Available options:
TO_DO,
IN_PROGRESS,
WAITING_REVIEW,
BLOCKED,
RESOLVED,
CANCELLED
priority
enum<string>[]

Filter by defect priority. Repeat the parameter for multiple values.

Available options:
LOW,
MEDIUM,
HIGH,
CRITICAL
locationId
string

Filter by a loc_-prefixed project location ID

Example:

"loc_extapiprojectlocation01"

offset
integer
default:0

The number of items to skip before starting to collect the result set

Example:

0

limit
integer
default:25

The number of items to return.

Required range: x <= 25
Example:

25

Response

A list of defects

data
object[]
meta
object