Query API

Querying Live Tail returns rows based on your query. Each request returns a pagination.next url which you can query for more logs. Note that the URL contains a cursor query that works only when you don't change any query parameters, otherwise the behavior is not defined.

GET https://logs.betterstack.com/api/v1/query

Query parameters

source_ids

string

Comma-separated list of sources you want to query.

query

string

Filter logs with your query. This follows the same rules as Live Tail;read more about Live Tail Query Language.

batch

integer

How many rows do you want to return? Accepts a range of 50-1000. Default: 100 rows.

from

string

Start of time range for the log query (ISO8601-formatted string: 2022-07-19T13:32:56+0000).

string

End of time range for the log query (ISO8601-formatted string: 2022-07-19T13:32:56+0000).

order

string

In what order do you want your logs? Possible values: newest_first, oldest_first. Default: newest_first

Headers

Authorization

required string

Bearer $TEAM_TOKEN

200

Returned rows

Response body

{
  "data": [
    {
      "app": "sample_app",
      "source_id": "123",
      "dt": "2022-07-19 12:28:14.000000",
      "event.http_request_received.port": null,
      "event.http_response_sent.status": null,
      "message": "Hello, world!",
      "level": "debug",
      "context.runtime.thread_id": "70039367973540",
      "context.system.pid": "14",
      "context.http.path": null,
      "context.http.method": null,
      "context.http.host": null,
      "context.http.remote_addr": null
    },
    {
      "app": "sample_app",
      "source_id": "123",
      "dt": "2022-07-19 12:28:14.000000",
      "event.http_request_received.port": null,
      "event.http_response_sent.status": null,
      "message": "Hello, world!",
      "level": "debug",
      "context.runtime.thread_id": "70182641597580",
      "context.system.pid": "14",
      "context.http.path": null,
      "context.http.method": null,
      "context.http.host": null,
      "context.http.remote_addr": null
    }
  ],
  "pagination": {
    "next": "https://logs.betterstack.com/api/v1/query?batch=100&cursor=MjE5PTI%3D&from=2022-07-18+12%3A29%3A14+UTC&order=newest_first&source_ids=123&to=2022-07-19+12%3A28%3A14+UTC"
  }
}

Example cURL

Looking for details of a specific parameter?

Explore list of all Sources API response parameters

Explore documentation

Example cURL

Looking for details of a specific parameter?