List support tickets
List all the support tickets created under a Moov account.
To access this endpoint using an access token
you'll need to specify the /accounts/{accountID}/tickets.read
scope.
If you're listing another account's tickets, then you'll need to
specify the /accounts/{partnerAccountID}/tickets.read
and /accounts/{accountID}/profile.read
scopes.
GET
/accounts/{accountID}/tickets
|
|
|
|
|
|
|
|
|
|
|
|
The request completed successfully.
A paginated list of items. The
nextPage
field is omitted if there are no more pages available.{
"items": [
{
"ticketID": "string",
"number": 0,
"title": "string",
"contact": {
"email": "string",
"name": "string"
},
"status": "new",
"createdOn": "2019-08-24T14:15:22Z",
"updatedOn": "2019-08-24T14:15:22Z",
"latestMessageOn": "2019-08-24T14:15:22Z",
"closedOn": "2019-08-24T14:15:22Z"
}
],
"nextPage": {
"cursor": "string"
}
}
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
The request contained missing or expired authentication.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
The user is not authorized to make the request.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
Request was refused due to rate limiting.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
The request failed due to an unexpected error.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
The request failed because a downstream service failed to respond.
Response headers
x-request-id
string
<uuid>
required
A unique identifier used to trace requests.
Headers
x-moov-version
string
API version
Specify an API version.
API versioning follows the format vYYYY.QQ.BB
, where
YYYY
is the yearQQ
is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10)BB
is the build number, starting at.01
, for subsequent builds in the same quarter.- For example,
v2024.01.00
is the initial release of the first quarter of 2024.
- For example,
The latest
version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
Default:
v2024.01.00
Path parameters
accountID
string
<uuid>
required
Query parameters
cursor
string
count
integer
<int64>
Default:
200
status
string
Possible values:
new
,
in-progress
,
on-hold
,
closed
Response
nextPage
field is omitted if there are no more pages available.
items
array
required
Show child attributes
closedOn
string<date-time>
contact
object
Show child attributes
string
required
name
string
createdOn
string<date-time>
latestMessageOn
string<date-time>
number
integer
status
string<enum>
Possible values:
new
,
in-progress
,
on-hold
,
closed
ticketID
string
title
string
updatedOn
string<date-time>
nextPage
object
Show child attributes
cursor
string
required
The cursor value to use for the next page of items.