List Connections

GET

https://api.catenatelematics.com/v2/integrations/connections

GET

/v2/integrations/connections

curl https://api.catenatelematics.com/v2/integrations/connections \
     -H "Authorization: Bearer <token>"

{
  "items": [
    {
      "id": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "fleet_id": "string",
      "tsp_id": "string",
      "source_name": "ada",
      "credentials": {
        "access_token": "string",
        "account_id": "string",
        "expires_in": 1,
        "host": "string",
        "refresh_token": "string",
        "scope": "string",
        "token_type": "string",
        "user_id": "string"
      },
      "status": "active",
      "description": "string",
      "fleet_ref": "string"
    }
  ],
  "total": 1,
  "current_page": "string",
  "current_page_backwards": "string",
  "previous_page": "string",
  "next_page": "string"
}

Get a paginated list of all connections accessible to your organization.

Authentication

AuthorizationBearer

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

Query parameters

tsp_idstring or nullOptionalformat: "uuid"

fleet_idslist of strings or nullOptional

Limit results to specific fleets. Maximum: 100 IDs. To specify multiple values, repeat the parameter for each value (e.g., ?fleet_ids=id1&fleet_ids=id2).

fleet_refslist of strings or nullOptional

Limit results to specific fleet references. Maximum: 100 references. To specify multiple values, repeat the parameter for each value (e.g., ?fleet_refs=ref1&fleet_refs=ref2).

cursorstring or nullOptional

Cursor for the next page

sizeintegerOptional1-1000Defaults to 300

Page size

Response

Successful Response

itemslist of objects

totalinteger>=0

current_pagestring or nullOptional

Cursor to refetch the current page

current_page_backwardsstring or nullOptional

Cursor to refetch the current page starting from the last item

previous_pagestring or nullOptional

Cursor for the previous page

next_pagestring or nullOptional

Cursor for the next page

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

405

Method Not Allowed Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

504

Gateway Timeout Error