Webhook delivery log API
Every delivery attempt of the monitor's events, newest first: status code, error, and whether the chain gave up (dead letter).
GET /v1/monitors/{monitor_id}/deliveries
GET /v1/monitors/{monitor_id}/deliveries
Every delivery attempt of the monitor's events, newest first: status code, error, and whether the chain gave up (dead letter). Free.
- Cost: Free
- Cache: Not cached.
Parameters#
| Name | Type | Required | Description | In |
|---|---|---|---|---|
monitor_id | string | yes | Monitor id. | path |
Every request also accepts:
cursor: the cursor from the previous page (Pagination).
Example request#
Set your key in the environment first (see Authentication).
1curl "https://api.socialscrape.dev/v1/monitors/mon_0123456789abcdef/deliveries" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY"1import os2import requests34res = requests.get(5 "https://api.socialscrape.dev/v1/monitors/mon_0123456789abcdef/deliveries",6 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},7)8body = res.json()910if body["ok"]:11 print(body["data"])12else:13 print(body["error"]["code"], body["error"]["message"])1const res = await fetch("https://api.socialscrape.dev/v1/monitors/mon_0123456789abcdef/deliveries", {2 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },3});4const body = await res.json();56if (body.ok) {7 console.log(body.data);8} else {9 console.error(body.error.code, body.error.message);10}1{2 "nodes": [3 {4 "name": "SocialScrape Webhook delivery log",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/monitors/{monitor_id}/deliveries",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "monitor_id",19 "value": "mon_0123456789abcdef"20 }21 ]22 },23 "sendHeaders": true,24 "headerParameters": {25 "parameters": [26 {27 "name": "x-api-key",28 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29 }30 ]31 }32 }33 }34 ],35 "connections": {}36}Example response#
This is a sample with illustrative values. Status 200.
1{2 "ok": true,3 "credits_charged": 0,4 "credits_remaining": 5000,5 "cached": false,6 "cached_at": null,7 "request_id": "req_536b0f4404add03022910747",8 "data": {9 "object": "list",10 "items": [11 {12 "object": "webhook_delivery",13 "event_id": "evt_0123456789abcdef",14 "monitor_id": "mon_0123456789abcdef",15 "attempt": 1,16 "status_code": 200,17 "ok": true,18 "dead_letter": false,19 "error": null,20 "created_at": "2026-10-29T15:00:03Z"21 }22 ],23 "cursor": null,24 "has_more": false25 },26 "cursor": null,27 "has_more": false28}Response#
A list of WebhookDelivery objects in data.items, with data.cursor and data.has_more.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
Every request can also fail with the account and platform errors listed on the Errors page.
Related endpoints#
- Create a monitor (
POST /v1/monitors) - List monitors (
GET /v1/monitors) - Delete a monitor (
DELETE /v1/monitors/{monitor_id}) - Send a test event (
POST /v1/monitors/{monitor_id}/test) - Send an event again (
POST /v1/monitors/events/{event_id}/redeliver) - Monitor events (
GET /v1/monitors/events)