List all API logs

List all api logs

curl --request GET \
  --url https://api.getlago.com/api/v1/api_logs \
  --header 'Authorization: Bearer <token>'

{
  "api_logs": [
    {
      "api_version": "v1",
      "client": "Lago Ruby v1.26.0",
      "http_method": "post",
      "http_status": 200,
      "logged_at": "2025-03-31T12:31:44Z",
      "request_body": "{ \"billable_metric\": { \"name\": \"Storage\", \"code\": \"storage\" } }",
      "request_origin": "https://app.lago.dev/",
      "request_path": "/billable_metrics",
      "created_at": "2022-04-29T08:59:51Z",
      "request_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "request_response": "{ \"lago_id\": \"b9155544-e261-4e92-b54e-f65d7609294c\", ... }"
    }
  ],
  "meta": {
    "current_page": 2,
    "total_pages": 4,
    "total_count": 70,
    "next_page": 3,
    "prev_page": 1
  }
}

GET

api_logs

List all api logs

curl --request GET \
  --url https://api.getlago.com/api/v1/api_logs \
  --header 'Authorization: Bearer <token>'

{
  "api_logs": [
    {
      "api_version": "v1",
      "client": "Lago Ruby v1.26.0",
      "http_method": "post",
      "http_status": 200,
      "logged_at": "2025-03-31T12:31:44Z",
      "request_body": "{ \"billable_metric\": { \"name\": \"Storage\", \"code\": \"storage\" } }",
      "request_origin": "https://app.lago.dev/",
      "request_path": "/billable_metrics",
      "created_at": "2022-04-29T08:59:51Z",
      "request_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "request_response": "{ \"lago_id\": \"b9155544-e261-4e92-b54e-f65d7609294c\", ... }"
    }
  ],
  "meta": {
    "current_page": 2,
    "total_pages": 4,
    "total_count": 70,
    "next_page": 3,
    "prev_page": 1
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

page

integer

Page number.

Example:

1

per_page

integer

Number of records per page.

Example:

20

from_date

string<date>

Filter api logs from a specific date.

Example:

"2022-08-09"

to_date

string<date>

Filter api logs up to a specific date.

Example:

"2022-08-09"

http_methods[]

enum<string>[]

Filter results by HTTP methods

Available options:

post,

put,

delete

Example:

["post", "put"]

http_statuses[]

(enum<string> | integer)[]

Filter results by HTTP status or by generic request status

Available options:

succeeded,

failed

Example:

["failed", "succeeded", 404]

api_version

string

Filter results by API version

Example:

"v1"

request_paths

string

Filter results by the path of the request

Example:

"/billable_metrics/"

Response

List of api logs

api_logs

object[]

required

Show child attributes

api_logs.api_version

string

required

Lago API version used in the request.

Example:

"v1"

api_logs.client

string

required

The client used to make the request to the API.

Example:

"Lago Ruby v1.26.0"

api_logs.http_method

enum<string>

required

This field represents the HTTP method of the request.

Available options:

post,

put,

delete

Example:

"post"

api_logs.http_status

integer

required

This field represents the HTTP status of the requests.

Example:

200

api_logs.logged_at

string<date-time>

required

The logged date of the api log, presented in the ISO 8601 datetime format, specifically in Coordinated Universal Time (UTC). It provides the precise timestamp of when the event's record was created within the Lago application

Example:

"2025-03-31T12:31:44Z"

api_logs.request_body

string<object>

required

Example:

"{ \"billable_metric\": { \"name\": \"Storage\", \"code\": \"storage\" } }"

api_logs.request_origin

string

required

This field represents the API origin of the requested URL

Example:

"https://app.lago.dev/"

api_logs.request_path

string

required

This field represents the API path of the requested URL

Example:

"/billable_metrics"

api_logs.created_at

string<date-time>

required

The creation date of the api log record in the Lago application, presented in the ISO 8601 datetime format, specifically in Coordinated Universal Time (UTC). It provides the precise timestamp of when the event's record was created within the Lago application

Example:

"2022-04-29T08:59:51Z"

api_logs.request_id

string<uuid>

required

Unique identifier for the api log.

Example:

"1a901a90-1a90-1a90-1a90-1a901a901a90"

api_logs.request_response

string<object>

Example:

"{ \"lago_id\": \"b9155544-e261-4e92-b54e-f65d7609294c\", ... }"

API Reference

Authorizations

Query Parameters

Response