API Reference

List Logs

GET /logs — list the API request logs for your account.

GET/logs

List the API request logs for your account. Each entry records a request made with one of your API keys — the endpoint, method, response_status, and originating user_agent. Use a log's id to fetch the full request and response bodies with GET /logs/:id.

This endpoint is always paginated. See Pagination for navigating with limit, after, and before.

Query parameters

limitnumberoptional

Number of logs to retrieve per page. Default 20, maximum 100, minimum 1.

afterstringoptional

The log id after which more logs are retrieved. The passed id is not included. Cannot be combined with before.

beforestringoptional

The log id before which more logs are retrieved. The passed id is not included. Cannot be combined with after.

Response fields

Each item in data is a log reference:

idstringoptional

The log id.

created_atstringoptional

When the request was made.

endpointstringoptional

The request path (e.g. /emails).

methodstringoptional

The HTTP method (e.g. POST).

response_statusnumberoptional

The HTTP status code returned.

user_agentstringoptional

The User-Agent of the caller.

Request

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.logs.list();
console.log({ data, error });

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "37e4414c-5e25-4dbc-a071-43552a4bd53b",
      "created_at": "2026-06-23T13:43:54.622Z",
      "endpoint": "/emails",
      "method": "POST",
      "response_status": 200,
      "user_agent": "curl/8.7.1"
    },
    {
      "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "created_at": "2026-06-23T12:15:00.123Z",
      "endpoint": "/emails/4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
      "method": "GET",
      "response_status": 200,
      "user_agent": "python-requests/2.31.0"
    }
  ]
}

Errors

Returns validation_error if limit is outside 1–100, if a cursor is malformed, or if both before and after are supplied. See the error reference.