RequestLogs

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.

  • Deprecated: use GET /v1/accounts/{account_id}/request-logs, whose result set is identical.

Whose traffic you see

  • 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. Requests made by other users, including other users of the same account, are never returned.
  • 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.

Browsing the history

  • 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.

Retires on 9 December 2026. See the migration guide for what moved where and what changes when you switch.

get/v1/developers/request-logs

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/developers/request-logs
  • Auth: HTTP bearer

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

Filter by a specific API key.

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

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.