Docs
V2 APIConnections

List connection logs

The connection's run history: each sync, import or webhook, whether it succeeded, and why not. Logs are kept for 14 days. A user restricted to some groups sees the logs of properties in those groups and those not tied to a property.

GET/api/v2/connections/{connection}/logs

The connection's run history: each sync, import or webhook, whether it succeeded, and why not. Logs are kept for 14 days. A user restricted to some groups sees the logs of properties in those groups and those not tied to a property.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

connection*string
Formatuuid

Query Parameters

account_id?string

Optional account to run this request against. Defaults to the account the API token is scoped to, so callers with a single account can omit it. Must be an account the authenticated user belongs to; staff may target any account. For write requests the value may be sent in the JSON body instead of the query string. The resolved account is returned on the X-Resi-Account-Id response header.

Formatuuid
per_page?integer
Range1 <= value <= 200
Default15
property_id?string
Formatuuid
event_type?string

Only logs of this event type.

status?string

Only logs with this status.

Value in

  • "Pending"
  • "Success"
  • "Warning"
  • "Skipped"
  • "Error"
created_at?string

Exact created_at, or a range with created_at[gte], created_at[lte], created_at[gt] and created_at[lt].

sort?string

Sort by any filter field; prefix with - for descending. Defaults to newest first.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/connections/497f6eca-6276-4993-bfeb-53cbbbba6f08/logs"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",      "property_id": "05003a8a-8f3c-454b-8884-a906ec46f5f5",      "event_type": "string",      "status": "Pending",      "message": "string",      "duration": 0,      "metadata": {},      "created_at": "2019-08-24T14:15:22Z"    }  ],  "links": {    "first": "string",    "last": "string",    "prev": "string",    "next": "string"  },  "meta": {    "current_page": 0,    "from": 0,    "last_page": 0,    "links": [      {        "url": "string",        "label": "string",        "page": 0,        "active": true      }    ],    "path": "string",    "per_page": 200,    "to": 0,    "total": 0  }}