List Subscriptions

List Subscriptions - Webhooks API

List Subscriptions - Returns all webhook subscriptions of your account

List Subscriptions - [Value: 20CU]
Returns an array of all your webhook subscriptions in any status. Optionally filter by chain
GET https://lb.drpc.live/lambda/{key}/v1/webhooks/subscriptions
Use cases

Use cases

  • See all your subscriptions in any status
  • Find subscriptions that cover a specific chain
Constraints

Constraints

  • Returns only subscriptions that belong to your account
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request GET \
  --url https://lb.drpc.live/lambda/{key}/v1/webhooks/subscriptions \
  --header 'accept: application/json'
Copy
Response
200
[
  {
    "id": "0450d9f4-304f-420f-9b49-3625d9c52c1f",
    "callback_url": "https://example.com/hooks/lambda",
    "status": "enabled",
    "chain_ids": [
      "ethereum",
      "base"
    ],
    "filters": {},
    "address_count": 1,
    "created_at": "2026-09-21T12:52:46.024339Z",
    "updated_at": "2026-09-21T12:52:46.024339Z"
  }
]
Copy

Path params

Parameters
keystring
[Required] Your dRPC API key

Query params

Parameters
filter[chain_ids]string
Keep only subscriptions that cover this chain. A subscription with empty chain_ids covers every chain, so it always matches

Request params

ParametersThis method does not accept any parameters.

Response

200

Response params

array of objects
idstring
[Required] Subscription id (UUID)
callback_urlstring
[Required] HTTPS URL that receives signed POST deliveries
statusstring
[Required] Only enabled subscriptions get deliveries
chain_idsarray_of_strings
[Required] Lowercase chain slugs. [] means every supported chain, including future ones
filtersobject
[Required] Subscription filters. {} when none are set
address_countinteger
[Required] How many addresses the subscription watches. The list itself is never inlined; use List Addresses
created_atstring
[Required] Creation time, ISO 8601
updated_atstring
[Required] Last update time, ISO 8601