API reference
Logs
Every authenticated API request your account has made, searchable by status, endpoint and time, for debugging an integration.
Updated
These endpoints need a full-access key
Useful for debugging an integration - you can see exactly what your code sent and what came back.
List logs
GET /v1/logs
Newest first.
curl "https://api.sendpository.com/v1/logs?limit=25&status=4xx" \
-H "Authorization: Bearer $SENDPOSITORY_ADMIN_KEY"| Parameter | Notes |
|---|---|
limit | 1–100. Default 25. |
offset | For paging. |
status | 2xx, 4xx or 5xx. |
endpoint | Substring match, e.g. emails. |
{
"data": [
{
"id": "d6f62052-35ad-4dfa-b82f-d0857a54dd22",
"method": "POST",
"endpoint": "/emails",
"status_code": 422,
"error_code": "validation_error",
"duration_ms": 12,
"source": "api",
"created_at": "2026-08-30T09:12:41.203Z"
}
],
"limit": 25,
"offset": 0
}Retrieve a log
GET /v1/logs/{id}
Adds client details.
{
"id": "d6f62052-...",
"method": "POST",
"endpoint": "/emails",
"status_code": 422,
"error_code": "validation_error",
"duration_ms": 12,
"source": "api",
"ip": "203.0.113.4",
"user_agent": "sendpository-node/1.0",
"api_key_id": "6aec350b-...",
"created_at": "2026-08-30T09:12:41.203Z"
}Retention
Logs are kept for 30 days. Export from the dashboard if you need them longer.