API reference · Webhooks

List webhook endpoints

Webhooks belong to the key's project and environment: a test key manages test-mode endpoints (sandbox events), a live key live endpoints.

GEThttps://fomodata.dev/v1/webhooks

Scopes:webhooks:writeRate class:standardFlag:WEBHOOKS_ENABLED

Example request

curl 'https://fomodata.dev/v1/webhooks' \
  -H "Authorization: Bearer $FOMODATA_API_KEY"

Try it in the playground

Parameters

Query parameters

limitstring: 1–100, default 25.
cursorstring: next_cursor from the previous page.

Response

200 Webhook endpoints, newest first

application/jsonWebhookList

objectenumrequired"list"
dataarray<Webhook>required+ 11 child attributes
- objectenumrequired"webhook"
- idstringrequired
- urlstring (uri)required
- descriptionstring | nullrequired
- eventsarray<EventType>required
- filtersobjectrequired+ 3 child attributes
  - tokenarray<string>Token refs ($SYMBOL, address or tk_ id).
  - handlearray<string>
  - chainarray<string>
- statusenumrequired"enabled""disabled""disabled_failing"
- secret_prefixstringrequired
- livemodebooleanrequired
- created_atstring (date-time)required
- updated_atstring (date-time)required
next_cursorstring | nullrequired
has_morebooleanrequired

200 · exampleJSON

{
  "object": "list",
  "data": [
    {
      "object": "webhook",
      "id": "wh_8Tq3NkVz1LmB5xRc7pYd2F",
      "url": "https://example.com",
      "description": "string",
      "events": [
        "thesis.created"
      ],
      "filters": {
        "token": [
          "string"
        ],
        "handle": [
          "string"
        ],
        "chain": [
          "string"
        ]
      },
      "status": "enabled",
      "secret_prefix": "whsec_Ab12",
      "livemode": true,
      "created_at": "2026-10-07T10:04:12.000Z",
      "updated_at": "2026-10-07T10:04:12.000Z"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Errors

Status	When
`400`	Bad request
`401`	Missing, invalid, revoked or expired API key
`403`	Insufficient scope, live access not approved, or history limit
`404`	Not found (or feature disabled)
`429`	Rate limit or quota exceeded

All errors use the standard envelope. See error codes for every code value.

← All endpoints openapi.json