List logs
List logs
Overview
List logs
Returns paginated logs for the organization. The type query parameter selects which log stream to read: api_request, api_error, webhook_delivery, or activity.
When to use this
Use when debugging API errors, auditing webhook deliveries, or building support dashboards.
See also
Retrieve log entry · Webhook delivery logs
Authentication
Merchant routes require an API key in the X-API-KEY header (see Integration overview). Use a test key against https://sandbox.api.lomi.africa and a live key against https://api.lomi.africa.
Endpoint
GET /logs
Base URLs:
https://sandbox.api.lomi.africahttps://api.lomi.africa
Request
Path parameters
No path parameters beyond the URL pattern.
Query parameters
| Name | In | Required | Schema | Description |
|---|---|---|---|---|
event | query | No | - | Filter activity logs by event type |
failed | query | No | - | Only failed webhook deliveries |
success | query | No | - | Only successful webhook deliveries |
webhook_id | query | No | - | Filter webhook_delivery logs by webhook ID |
severity | query | No | - | |
status | query | No | - | Comma-separated HTTP status codes (api_request, api_error). Example: 400,500 |
end_date | query | No | - | ISO 8601 end timestamp (inclusive) |
start_date | query | No | - | ISO 8601 start timestamp (inclusive) |
offset | query | No | - | |
limit | query | No | - | |
type | query | Yes | - | Log stream to query |
Responses
| Status | Description |
|---|---|
200 | Paginated log list |
400 | Invalid query parameters |
401 | Invalid or missing API key |
Errors
Errors follow the standard JSON error format (status code and machine-readable message). Validate inputs before calling; 401 indicates a missing/invalid key, 404 a missing resource for this organization, 429 rate limiting. For safe retries on create-style calls, send an idempotency key when your flow supports it.
Example
curl -sS -X GET "https://sandbox.api.lomi.africa/logs?event=value&failed=true" \
-H "X-API-KEY: $LOMI_SECRET_KEY"OpenAPI
- operationId:
LogsController_findAll - Operation:
GET /logs
Full schemas and Try it: API reference. Machine-readable contract: repo apps/docs/openapi.json.