---
title: "List Logs"
full: true
_openapi:
  method: GET
  toc: []
  structuredData:
    headings: []
    contents:
      - content: "Returns log entries with optional filtering."
_apiData:
  document: "https://reloop.sh/api/logs/openapi/json"
  operationData: [{"path":"/api/logs/v1/list","method":"get"}]
  parameterList: [{"name":"level","type":"\"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\"","required":false,"description":"","location":"query","enumValues":["debug","info","warn","error","fatal"]},{"name":"event","type":"string","required":false,"description":"Filter by event name (partial match)","location":"query"},{"name":"status_code","type":"string","required":false,"description":"Filter by status code (number or 'success', 'error')","location":"query"},{"name":"search","type":"string","required":false,"description":"Search across event name and metadata","location":"query"},{"name":"organization_id","type":"string","required":false,"description":"","location":"query"},{"name":"start_date","type":"string","required":false,"description":"Filter logs from this date (ISO 8601)","location":"query"},{"name":"end_date","type":"string","required":false,"description":"Filter logs until this date (ISO 8601)","location":"query"},{"name":"limit","type":"string | number","required":false,"description":"Maximum number of log entries to return","location":"query","minimum":1,"maximum":100},{"name":"page","type":"string | number","required":false,"description":"Page number for pagination","location":"query","minimum":1},{"name":"service","type":"string","required":false,"description":"Filter by source service (api_key, domain, mailing…)","location":"query"},{"name":"action","type":"string","required":false,"description":"Filter by action verb (created, deleted, sent…)","location":"query"},{"name":"resource_type","type":"string","required":false,"description":"Filter by resource type (api_key, domain, email…)","location":"query"},{"name":"resource_id","type":"string","required":false,"description":"Filter by specific resource ID","location":"query"},{"name":"actor_type","type":"\"user\" | \"api_key\" | \"system\"","required":false,"description":"","location":"query","enumValues":["user","api_key","system"]},{"name":"actor_id","type":"string","required":false,"description":"Filter by actor ID (user_id or api_key_id)","location":"query"},{"name":"environment","type":"\"production\" | \"development\" | \"test\"","required":false,"description":"","location":"query","enumValues":["production","development","test"]}]
  responseMap: {"200":{"description":"Response for status 200","schema":{"logs":[{"uuid":"example_uuid","event":"evt_123456789","level":"example_level","trace_id":"example_trace_id","metadata":null,"status_code":0,"created_at":"2026-03-23T10:00:00.000Z","requestDetails":null,"request_body":null,"actor_type":"example_actor_type","actor_id":"example_actor_id","resource_type":"example_resource_type","resource_id":"example_resource_id","service":"example_service","action":"example_action","ip_address":"example_ip_address","user_agent":"example_user_agent","environment":"example_environment"}],"count":0,"stats":{"debug":0,"info":0,"warn":0,"error":0,"fatal":0}}},"401":{"description":"Response for status 401","schema":{"message":"Unauthorized access"}},"403":{"description":"Response for status 403","schema":{"message":"Access forbidden"}},"500":{"description":"Response for status 500","schema":{"message":"Internal server error"}}}
  codeSamples: [{"id":"node","lang":"js","label":"Node.js","source":"const response = await fetch(\"https://api.reloop.sh/api/logs/v1/?page=1&limit=10\", {\n  method: \"GET\",\n  headers: {\n    \"x-api-key\": \"rl_123456789\"\n  }\n});\n\nconst logs = await response.json();"},{"id":"curl","lang":"bash","label":"cURL","source":"curl -X GET \"https://api.reloop.sh/api/logs/v1/?page=1&limit=10\" \\\n  -H \"x-api-key: rl_123456789\""},{"id":"python","lang":"python","label":"Python","source":"import requests\n\nresponse = requests.get(\n    \"https://api.reloop.sh/api/logs/v1/\",\n    headers={\n        \"x-api-key\": \"rl_123456789\"\n    },\n    params={\n        \"page\": 1,\n        \"limit\": 10\n    }\n)\n\nlogs = response.json()"},{"id":"php","lang":"php","label":"PHP","source":"<?php\n$client = new \\GuzzleHttp\\Client();\n\n$response = $client->get('https://api.reloop.sh/api/logs/v1/', [\n    'headers' => [\n        'x-api-key' => 'rl_123456789'\n    ],\n    'query' => [\n        'page' => 1,\n        'limit' => 10\n    ]\n]);\n\n$logs = json_decode($response->getBody(), true);"},{"id":"java","lang":"java","label":"Java","source":"import java.net.URI;\nimport java.net.http.*;\n\nHttpClient client = HttpClient.newHttpClient();\n\nHttpRequest request = HttpRequest.newBuilder()\n    .uri(URI.create(\"https://api.reloop.sh/api/logs/v1/?page=1&limit=10\"))\n    .header(\"x-api-key\", \"rl_123456789\")\n    .GET()\n    .build();\n\nHttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());"},{"id":"dotnet","lang":"csharp","label":".NET","source":"using System.Net.Http;\n\nvar client = new HttpClient();\nclient.DefaultRequestHeaders.Add(\"x-api-key\", \"rl_123456789\");\n\nvar response = await client.GetAsync(\n    \"https://api.reloop.sh/api/logs/v1/?page=1&limit=10\"\n);"}]
---
> For the complete documentation index, see [llms-docs.txt](/llms-docs.txt) or the site index [llms.txt](/llms.txt). Full docs corpus: [llms-full-docs.txt](/llms-full-docs.txt). Prefer markdown URLs (append `.md`) for agent consumption. Product skill: [skill.md](/skill.md).


{/* This file was generated by the OpenAPI doc generator. Do not edit this file directly. Run `bun run generate:api-docs` to regenerate. */}

<APIPage />