# Request log > Request log: GET /v1/usage/log. Request log, newest first, kept for 30 days; metadata only (method, route without ids, status, duration, key), never bodies, headers or query strings. Filters: key (id or session), status (2xx, 3xx, 4xx, 5xx or a code), route (substring), method, days (1 to 30); limit Source: https://praeko.app/docs/en/api/usage-and-log/request-log `GET /v1/usage/log` · minimum scope: read Request log, newest first, kept for 30 days; metadata only (method, route without ids, status, duration, key), never bodies, headers or query strings. Filters: `key` (id or `session`), `status` (`2xx`, `3xx`, `4xx`, `5xx` or a code), `route` (substring), `method`, `days` (1 to 30); `limit` (1 to 200, default 50) and `cursor` (the `next` of the previous page). > **Headers** `Authorization: Bearer praeko_…` and `X-Praeko-Contract: en`. Always send both. ## Parameters | Name | In | Description | |---|---|---| | `key` | query | Id of a key or `session` (the dashboard). | | `status` | query | `2xx`, `3xx`, `4xx`, `5xx` or a code. | | `route` | query | Part of the route. | | `method` | query | HTTP method. | | `days` | query | How many days to look back (1 to 30). | | `limit` | query | Items per page (1 to 200). Default: 50. | | `cursor` | query | The `next` value of the previous page. | ## Example **curl** ```bash curl "https://praeko.app/v1/usage/log" \ -H "Authorization: Bearer $PRAEKO_KEY" \ -H "X-Praeko-Contract: en" ``` **JavaScript** ```js const res = await fetch("https://praeko.app/v1/usage/log", { method: "GET", headers: { "Authorization": `Bearer ${process.env.PRAEKO_KEY}`, "X-Praeko-Contract": "en", }, }); console.log(res.status, await res.json()); ``` **Node** ```js import { Praeko } from "@praeko/sdk"; const praeko = new Praeko({ url: "https://praeko.app", key: process.env.PRAEKO_KEY }); const resultado = await praeko.usage.log(); console.log(resultado); ``` **Python** ```python import os import requests resp = requests.get( "https://praeko.app/v1/usage/log", headers={ "Authorization": f"Bearer {os.environ['PRAEKO_KEY']}", "X-Praeko-Contract": "en", }, ) print(resp.status_code, resp.json()) ``` **PHP** ```php 'GET', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("PRAEKO_KEY"), 'X-Praeko-Contract: en', ], ]); $resposta = curl_exec($ch); echo curl_getinfo($ch, CURLINFO_HTTP_CODE), " ", $resposta, PHP_EOL; curl_close($ch); ``` **Go** ```go package main import ( "fmt" "io" "net/http" "os" ) func main() { req, err := http.NewRequest("GET", "https://praeko.app/v1/usage/log", nil) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer "+os.Getenv("PRAEKO_KEY")) req.Header.Set("X-Praeko-Contract", "en") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(resp.Status, string(out)) } ``` **Ruby** ```ruby require "net/http" require "uri" uri = URI("https://praeko.app/v1/usage/log") request = Net::HTTP::Get.new(uri) request["Authorization"] = "Bearer #{ENV['PRAEKO_KEY']}" request["X-Praeko-Contract"] = "en" response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) } puts response.code, response.body ``` **C#** ```csharp using System.Net.Http; using System.Net.Http.Headers; using System.Text; using var client = new HttpClient(); using var request = new HttpRequestMessage(HttpMethod.Get, "https://praeko.app/v1/usage/log"); request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PRAEKO_KEY")); request.Headers.Add("X-Praeko-Contract", "en"); using var response = await client.SendAsync(request); Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}"); ``` **Java** ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://praeko.app/v1/usage/log")) .header("Authorization", "Bearer " + System.getenv("PRAEKO_KEY")) .header("X-Praeko-Contract", "en") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode() + " " + response.body()); } } ``` **HTTPie** ```bash http GET "https://praeko.app/v1/usage/log" \ "Authorization: Bearer $PRAEKO_KEY" \ "X-Praeko-Contract: en" ``` > Official SDK for Node: Install it with `npm install @praeko/sdk` (see [SDK and CLI](https://praeko.app/docs/en/sdk)). ## Response | Success status | When | |---|---| | `200` | Success. | **Response 200** ```json { "records": [ { "id": "01KA3Z5Q8R2WJ7CX4DN9VB6T1H", "method": "POST", "route": "/v1/posts", "status": 201, "durationMs": 212, "key": "01KA3Y1B9E5MK7PR3XD0V4SN2G", "keyName": "script automation", "createdAt": "2026-11-07T14:02:11.482Z" } ], "next": "01KA3Z5Q8R2WJ7CX4DN9VB6T1H" } ``` Metadata only (method, route without ids, status, duration, key); never body, headers or IP. Kept for 30 days. Pass `next` as `cursor` to get the next page; `null` on the last page. ## Errors No errors specific to this route besides the common ones. ### Errors on any route | Status | code | When | |---|---|---| | 401 | `unauthorized` | The `Authorization: Bearer …` header is missing. | | 401 | `invalid_api_key` | The key does not exist. | | 401 | `revoked_api_key` | The key has been revoked. | | 401 | `expired_api_key` | The key has expired. | | 403 | `forbidden` | The key's scope is not enough for this route (see the scope badge). | | 429 | `rate_limited` | The per-minute request limit was exceeded. | The body of every error is `{ "error": { "code", "message", "details"? } }`. See [all error codes](https://praeko.app/docs/en/guides/errors-and-limits). ## Try it > **Try it**: the live test needs you to be signed in. It is switched off here.