Samva
DashboardAPI
ChannelsPlatformDevelopersEmail templatesIntegrationsAPI Reference
Developers

List logs

List logs. View request and response details for this Samva email API endpoint.

GET
/v1/developers/logs

Returns a paginated log of the messages this organization accepted or received, filterable by API key, source, client surface, delivery status, channel, direction, message id, and date range. Each entry carries the send's first recipient, its subject, and the campaign run behind it when there was one. Facet counts are included on the first page. Webhook delivery diagnostics are exposed by the dedicated webhook delivery-log API.

Authorization

apiKey
x-api-key<token>

In: header

Query Parameters

page?string|null
limit?string|null
apiKeyId?|null
status?string|null
channel?|null
direction?|null
source?string|null
client?|null
startDate?string|null
endDate?string|null
search?string|null

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/developers/logs"
{  "data": [    {      "messageId": "string",      "channel": "email",      "direction": "outbound",      "status": "pending",      "recipient": "string",      "recipientCount": 0,      "subject": "string",      "acceptedAt": "string",      "createdAt": "string",      "updatedAt": "string",      "apiKeyId": "string",      "apiKeyName": "string",      "campaign": {        "runId": "string",        "name": "string"      },      "client": {        "surface": "typescript-promise",        "version": "string"      }    }  ],  "meta": {    "page": 1,    "limit": 1,    "total": 0,    "hasMore": true,    "facets": {      "status": [        {          "value": "string",          "total": 0        }      ],      "channel": [        {          "value": "string",          "total": 0        }      ],      "direction": [        {          "value": "string",          "total": 0        }      ],      "source": [        {          "value": "string",          "label": "string",          "total": 0        }      ],      "apiKey": [        {          "value": "string",          "label": "string",          "total": 0        }      ],      "client": [        {          "value": "string",          "total": 0        }      ]    }  }}

Get a log entry

Returns one log entry by message id, including the message content, its status history, and the sanitized API request Samva recorded when it accepted the send.

Create the first workspace

Creates a replacement first workspace under the signed-in user's billing account when no workspace membership remains.