AccountRequestLogs

List API request logs

Returns the history of public API requests made by you, with any of your API keys in this environment — not only the key you are authenticating with. Only auth_type=API_KEY traffic is recorded.

  • The axis is the person, not the individual credential: a second key of yours sees the same history, and narrowing it to one key is a filter (api_key_id), not the default.
  • It is still not the account's traffic: requests made by other users of the same account, or by their API keys, are never returned. The {account_id} in the path authorizes the call; it does not widen what you can see.
  • Environment is not a filter: results are always scoped to the environment of the credential you authenticate with — a beel_sk_test_* key sees the test traffic of all your test keys, a beel_sk_live_* key the live traffic of all your live ones. To see the other environment, use a key from that environment.
  • Cursor pagination: navigate with the opaque cursor returned in next_cursor / prev_cursor; there is no jump to an arbitrary page N.
  • Time window: defaults to the last 30 days; narrow or move it with from/to.
get/v1/accounts/{account_id}/request-logs

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/accounts/{account_id}/request-logs
  • Auth: HTTP bearer

Path parameters

account_idstring uuid required

Account the call is authorized against. It does not widen the result set.

Query parameters

only_errorsboolean

If true, only requests with status >= 400.

methodstring
Example:POST

Filter by HTTP method.

http_statusinteger

Filter by an exact HTTP status code.

path_containsstring
Example:/invoices

Case-insensitive substring of the actual request path, IDs included (for example /v1/companies/3f1c9a2e-5b7d-4e8f-9a1b-2c3d4e5f6a7b/invoices/8a2b4c6d-1e3f-4a5b-8c7d-9e0f1a2b3c4d/send), so a path template with {placeholders} never matches, and a full path only matches requests made to that exact route shape. Prefer a resource segment such as /invoices, which matches that resource on every route that serves it.

api_key_idstring uuid

Narrow the result to one of your API keys. Any key of yours in this environment is accepted, not just the one you authenticate with; a key belonging to someone else simply yields no results.

fromstring date-time

Lower bound of the time range (inclusive). Defaults to 30 days ago.

tostring date-time

Upper bound of the time range (inclusive). Defaults to now.

cursorstring

Opaque cursor returned by a previous response (next_cursor / prev_cursor).

limitinteger

Maximum number of log entries in the page, from 1 to 100. Defaults to 25.

Response

Logs retrieved successfully.

successboolean required

Example response

{
  "success": true,
  "data": {
    "request_logs": [
      {
        "request_id": "6f9619ff-8b86-d011-b42d-00cf4fc964ff",
        "http_method": "POST",
        "http_path": "/v1/invoices",
        "http_status": 422,
        "environment": "PROD",
        "error_code": "VALIDATION_ERROR"
      }
    ]
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.