Skip to main content
GET
/
issues
List Issues
curl --request GET \
  --url https://api.withterminal.com/tsp/v1/issues \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "isu_01D8ZQFGHVJ858NBF2Q7DV9MNC",
      "connection": "conn_01GV12VR4DJP70GD1ZBK0SDWFH",
      "status": "ongoing",
      "error": {
        "code": "missing_permissions",
        "message": "Failed to ingest HOS Logs, missing permissions to access Duty Status Logs"
      },
      "firstReportedAt": "2021-01-06T03:24:53.000Z",
      "lastReportedAt": "2021-01-06T03:24:53.000Z"
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"
}
Issues are generated when we observe something that may impact the completeness or accuracy of the data we provide but do not justify a full error. For example, if we lack permissions for a specific resource or need to skip an item due to invalid data.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
limit
integer

The maximum number of results to return in a page.

​
cursor
string<cursor>

Pagination cursor to start requests from

Example:

"cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"

​
lastReportedAfter
string<date>

Timestamp to start when the issue was last observed ISO 8601 date

Example:

"2021-01-06T03:24:53.000Z"

​
lastReportedBefore
string<date>

Timestamp to end when the issue was last observed ISO 8601 date

Example:

"2021-01-06T03:24:53.000Z"

​
expand
enum<string>

Expand related resources to see all details

Available options:
connection
​
connectionId
string<ulid>

Filter issues to a specific connection

Example:

"conn_01GV12VR4DJP70GD1ZBK0SDWFH"

​
errorCode
enum<string>

Filter issues to a specific error code

Available options:
missing_permissions,
exceeded_retention_window,
invalid_source_id,
unknown_device_type,
missing_safety_configuration,
inaccessible_data
​
status
enum<string>

Filter issues to a specific status

Available options:
ongoing,
resolved

Response

OK

​
results
Issue · object[]
required
​
next
string<cursor>

Cursor used for pagination.

Example:

"cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"