Webhooks

Get a delivery

One delivery with the exact body that was posted.

GET/v1/webhooks/{uid}/deliveries/{id}

Authorization

Authorizationstringheaderrequired

Bearer followed by your API key: Bearer sgk_…. The key also works in an X-Api-Key header. See Authentication.

Path parameters

uidstringpathrequired

The webhook's 8-character id. Not case-sensitive.

idstringpathrequired

The delivery's uid (16 characters, as in X-Sigil-Delivery).

Response

200 OKThe delivery, with payload.

uidstring

The delivery's id, also sent as X-Sigil-Delivery. A retry repeats it.

event_idstring

The event's id, the body's id: the same for this event's delivery to each of your endpoints.

typestring

The event type.

One of pact.sent pact.viewed pact.signed pact.declined pact.voided pact.sealed pact.lapsed ping

pact_uidstring | null

The pact the event is about. null for a ping.

statusstring

pending is queued or waiting for its next attempt; sent got a 2xx; failed was given up on.

One of pending sent failed

attemptsinteger

Attempts made so far (7 at most).

last_codeinteger | null

The HTTP status of the last attempt, or null when it got no response.

last_errorstring | null

Why the last attempt did not count as delivered: the status and the start of your response body, a timeout, or a connection error.

next_attemptstring (date-time) | null

When it will next be tried, while pending.

date_createdstring (date-time)

When the event was queued.

date_sentstring (date-time) | null

When it was delivered.

payloadobject

The event body exactly as it was posted.

Only from Get a delivery.

Errors

Status	When
401 Unauthorized	The API key is missing, wrong or revoked.
403 Forbidden	The account's plan does not include API access (Pro and Business do).
404 Not Found	No webhook with that id belongs to your account.
404 Not Found	No delivery with that id for this endpoint (it may be older than 30 days).

Every error body is { "error": "message" }. See Errors.

Request

curl https://api.signwithsigil.com/v1/webhooks/W8NQ3KTE/deliveries/HD7KQ4WEPZ9TXM3C \
  -H "Authorization: Bearer $SIGIL_API_KEY"

const res = await fetch('https://api.signwithsigil.com/v1/webhooks/W8NQ3KTE/deliveries/HD7KQ4WEPZ9TXM3C', {
  headers: { Authorization: `Bearer ${process.env.SIGIL_API_KEY}` },
});
const webhook = await res.json();

import os
import requests

res = requests.get(
    "https://api.signwithsigil.com/v1/webhooks/W8NQ3KTE/deliveries/HD7KQ4WEPZ9TXM3C",
    headers={"Authorization": f"Bearer {os.environ['SIGIL_API_KEY']}"},
)
webhook = res.json()

Response

200

{
  "uid": "HD7KQ4WEPZ9TXM3C",
  "event_id": "EV3QK9WT7PZMXDH4",
  "type": "pact.sealed",
  "pact_uid": "K4TQ7MZE",
  "status": "sent",
  "attempts": 1,
  "last_code": 200,
  "last_error": null,
  "next_attempt": null,
  "date_created": "2026-10-21T09:12:45Z",
  "date_sent": "2026-10-21T09:12:46Z",
  "payload": {
    "id": "EV3QK9WT7PZMXDH4",
    "type": "pact.sealed",
    "created": "2026-10-21T09:12:45Z",
    "data": {
      "pact": {
        "uid": "K4TQ7MZE",
        "title": "Consulting agreement with Acme",
        "status": "sealed",
        "message": "Please sign by Friday.",
        "page_count": 3,
        "created_by": "api",
        "current_signer": null,
        "date_created": "2026-10-20T14:05:00Z",
        "date_sent": "2026-10-20T14:05:01Z",
        "date_lapses": "2026-11-03T14:05:01Z",
        "date_sealed": "2026-10-21T09:12:44Z",
        "date_updated": "2026-10-21T09:12:44Z",
        "documents_charged": 1,
        "documents_cost": null,
        "sent_sha256": "9f2c4e81b07d5a3c6e1f0b9a8d7c6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b0c9d",
        "signed_sha256": "3b7e1d9c5a8f2e4b6d0c1a9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d",
        "recipients": [
          {
            "order": 1,
            "role": "signer",
            "name": "Avery Lane",
            "email": "avery@example.com",
            "status": "signed",
            "date_viewed": "2026-10-20T15:28:02Z",
            "date_signed": "2026-10-20T15:31:40Z",
            "typed_name": "Avery Lane",
            "decline_reason": null
          },
          {
            "order": 2,
            "role": "signer",
            "name": "Sam Ortiz",
            "email": "sam@example.com",
            "status": "signed",
            "date_viewed": "2026-10-21T09:10:15Z",
            "date_signed": "2026-10-21T09:12:44Z",
            "typed_name": "Sam Ortiz",
            "decline_reason": null
          },
          {
            "order": 3,
            "role": "cc",
            "name": "Records",
            "email": "records@example.com",
            "status": "pending",
            "date_viewed": null,
            "date_signed": null,
            "typed_name": null,
            "decline_reason": null
          }
        ],
        "links": {
          "document": "https://api.signwithsigil.com/v1/pacts/K4TQ7MZE/document.pdf",
          "signed": "https://api.signwithsigil.com/v1/pacts/K4TQ7MZE/signed.pdf",
          "sigil": "https://api.signwithsigil.com/v1/pacts/K4TQ7MZE/sigil.pdf",
          "dashboard": "https://www.signwithsigil.com/pacts/K4TQ7MZE"
        }
      }
    }
  }
}