List events

GET/v1/events

Every event in your account, a page at a time: the same events your webhooks get. Use it to poll when you can't receive webhooks, or to catch up after an outage.

Query parameters

limitinteger

Default 25
cursorstring
typestring

One of delivery.created delivery.rejected delivery.notified delivery.opened delivery.email_opened delivery.auth_failed delivery.confirmed delivery.downloaded delivery.delivered delivery.reminded delivery.bounced delivery.expired delivery.revoked delivery.consignment_failed delivery.evidence_sealed delivery.evidence_timestamp_deferred delivery.evidence_timestamp_recovered delivery.paper_pending_approval delivery.paper_dispatched delivery.paper_failed document.previewed batch.finalized batch.completed lookup.completed consent.granted consent.withdrawn invitation.sent link.opened otp.sent otp.verified otp.locked secret.attached secret.available secret.revealed secret.copied secret.expired secret.exhausted secret.revoked request.sent request.opened request.fulfilled request.expired request.closed request.reopened deletion.scheduled recipient_domain.verified recipient_domain.degraded recipient_domain.failed member.suspended member.restored member.removed batch.cancelled batch.policy_changed delivery.policy_changed email_sender.verified email_sender.degraded email_sender.failed email_sender.restored
created_afterstring · date-time
created_beforestring · date-time

Only events created strictly before this time. With created_after, a date range (as GET /deliveries).
resource_idstring

Only events about this resource (dlv_…, bat_…, req_…, …). Exact match.
orderstring

asc, the default, is the order for polling: oldest first, walking forward with the cursor. desc lists the newest first. A cursor works only with the order it came from.
One of asc desc
Default "asc"

Returns

200 application/json. Paginated events.

Errors have one shape; see Errors for every code.

Code language

Request

curl "https://api.parasend.com/v1/events?limit=3" \
  -H "Authorization: Bearer $PARASEND_KEY"

const res = await fetch('https://api.parasend.com/v1/events?limit=3', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.parasend.com/v1/events?limit=3",
    headers={
        "Authorization": f"Bearer {os.environ['PARASEND_KEY']}",
    },
)
data = res.json()

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.parasend.com/v1/events?limit=3");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PARASEND_KEY"));
var response = await http.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

var request = HttpRequest.newBuilder(URI.create("https://api.parasend.com/v1/events?limit=3"))
    .header("Authorization", "Bearer " + System.getenv("PARASEND_KEY"))
    .GET()
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.parasend.com/v1/events?limit=3', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'),
    ],
]);
$data = json_decode($response->getBody(), true);

Response · 200

{
  "data": [
    {
      "id": "evt_01M6R27T08JTMBJ4B6GQP90838",
      "object": "event",
      "type": "delivery.created",
      "created": "2026-11-06T09:15:05.604Z",
      "resource": {
        "type": "delivery",
        "id": "dlv_01M6R27T05512SCV3852TPM2XY"
      },
      "batch_id": null,
      "reason": null,
      "data": null
    },
    {
      "id": "evt_01M6R27T153J4657RB03NQNXW2",
      "object": "event",
      "type": "delivery.created",
      "created": "2026-11-06T09:15:05.634Z",
      "resource": {
        "type": "delivery",
        "id": "dlv_01M6R27T13NKWVJRJBTHZDP6Y1"
      },
      "batch_id": null,
      "reason": null,
      "data": null
    },
    {
      "id": "evt_01M6R27T1NHEY707SDDNNJTAZK",
      "object": "event",
      "type": "delivery.created",
      "created": "2026-11-06T09:15:05.651Z",
      "resource": {
        "type": "delivery",
        "id": "dlv_01M6R27T1MRPH7P4ZSR0WKTBQD"
      },
      "batch_id": null,
      "reason": null,
      "data": null
    }
  ],
  "has_more": true,
  "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wNlQwOToxNTowNS42NTE1NDVaIiwiaWQiOiJldnRfMDFNNlIyN1QxTkhFWTcwN1NERE5OSlRBWksifQ"
}