Skip to content

List the company's support tickets, newest first

GET
/tickets
curl --request GET \
--url 'https://api.fleet.co/platform/v1/tickets?limit=50&offset=0&status=OPENED&category=ORDER__UPDATE&reference=48213' \
--header 'Authorization: Bearer <token>'
limit

Page size (max 100)

integer
default: 50 >= 1 <= 100

Example

50
offset

Number of items to skip

integer
0

Example

0
status

Support ticket status; WAITING_CLIENT means Fleet waits for the company’s answer

string
Allowed values: OPENED WAITING_CLIENT WAITING_FLEET WAITING_SUPPLIER WAITING_DEVICE_RETURN IN_REPAIR SHIPPING CLOSING SOLVED CLOSED DELETED
requester_id
integer
category

What the request is about, as in Cockpit’s support form

string
Allowed values: ORDER__UPDATE ORDER__SHIPPING CONTRACT__INFORMATION CONTRACT__RENEWAL CONTRACT__INVOICE INSURANCE__LOST INSURANCE__BROKEN TECHNICAL_PROBLEM MDM COCKPIT EDR INSURANCE_OXIDATION PASSWORD_MANAGER VPN SOFTWARE_PROBLEM HARDWARE_PROBLEM STORAGE TRANSFER RETURN MDM_INSTALL MDM_ACTIONS ORDER_ISSUE INVOICE

Example

HARDWARE_PROBLEM
reference

The reference Fleet support quotes

string
/^(hub-\d{1,9}|\d{1,18})$/

Example

48213

Paginated tickets

Media typeapplication/json
object
data
required
Array<object>
object
id
required
integer
reference
required

Reference Fleet support quotes in its replies

string
subject
required
string
nullable
category
required

What the request is about, as in Cockpit’s support form

string
nullable
Allowed values: ORDER__UPDATE ORDER__SHIPPING CONTRACT__INFORMATION CONTRACT__RENEWAL CONTRACT__INVOICE INSURANCE__LOST INSURANCE__BROKEN TECHNICAL_PROBLEM MDM COCKPIT EDR INSURANCE_OXIDATION PASSWORD_MANAGER VPN SOFTWARE_PROBLEM HARDWARE_PROBLEM STORAGE TRANSFER RETURN MDM_INSTALL MDM_ACTIONS ORDER_ISSUE INVOICE
status
required

Support ticket status; WAITING_CLIENT means Fleet waits for the company’s answer

string
Allowed values: OPENED WAITING_CLIENT WAITING_FLEET WAITING_SUPPLIER WAITING_DEVICE_RETURN IN_REPAIR SHIPPING CLOSING SOLVED CLOSED DELETED
content
required

The request as the requester wrote it

string
nullable
requester_id
required
integer
order_id
required
integer
nullable
device_ids
required
Array<integer>
opened_at
required

ISO 8601

string
nullable
closed_at
required

ISO 8601

string
nullable
meta
required
object
total
required

Total items matching filters (before paging)

integer
limit
required

Page size used for this response

integer
offset
required

Offset used for this response

integer

Example

{
"data": [
{
"reference": "48213",
"category": "ORDER__UPDATE",
"status": "OPENED"
}
],
"meta": {
"total": 42,
"limit": 50,
"offset": 0
}
}

Validation error

Media typeapplication/json
object
message
required

Every validation failure, comma-separated

string
type
required
string
Allowed values: validation_error
error
required
string
Allowed values: validation_error

Example

{
"message": "Required, must be an ISO 3166-1 alpha-2 country code",
"type": "validation_error",
"error": "validation_error"
}

Missing, invalid, or revoked API key

Media typetext/plain
string

Example

Unauthorized

Rate limit exceeded. The RateLimit-* headers give the limit and the reset time.

Media typetext/plain
string

Example

Too many requests, please try again later.

Unexpected server error

Media typeapplication/json
object
error
required
string
Allowed values: INTERNAL_ERROR

Example

{
"error": "INTERNAL_ERROR"
}

Rate limiting is temporarily unavailable; retry with backoff

Media typeapplication/json
object
message
required
string

Example generated

{
"message": "example"
}