Developers
Requests

List requests

GET/requests

Lists the authenticated API requests made on the current account, most recent first by default.

Results are paginated with a cursor. The collection can be filtered by outcome, action code, affected resource (resource_type and resource_id), and time range (occurred_after and occurred_before).

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Query Parameters

limit?integer
Range1 <= value <= 200
cursor?string
sort?string

Value in

  • "occurred_at"
  • "-occurred_at"
outcome[]?array<string>
action_code?string
resource_type?string
resource_id?string
occurred_after?string
Formatdate-time
occurred_before?string
Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/requests"
{  "data": [    {      "action": "string",      "actor": {        "admin_id": "string"      },      "client_request_id": "string",      "credential": {        "id": "string"      },      "diff": {},      "event_id": "string",      "http_status": 0,      "id": "string",      "item_key": "string",      "kind": "request",      "method": "string",      "object": "request_log",      "occurred_at": "2019-08-24T14:15:22Z",      "operation_id": "string",      "origin": {        "client": {          "install_id": "string",          "name": "string",          "version": "string"        },        "ip": "string",        "ip_source": "trusted_proxy",        "user_agent": "string"      },      "outcome": "succeeded",      "path": "string",      "recorded_at": "2019-08-24T14:15:22Z",      "request_id": "string",      "resource": {        "id": "string",        "object": "string"      }    }  ],  "page": {    "limit": 1,    "next_cursor": "string",    "prev_cursor": "string"  }}

Requests

Requests in API v3: list requests, retrieve a request.

Retrieve a request GET

Retrieves a logged API request together with the audit entries it produced. `data.request` describes the request itself, and `data.effects` lists the resulting audit entries in ascending order of `occurred_at`. Requests that do not exist or are not accessible with the current credentials return `404 Not Found` with the `not_found` error code.