API reference · Webhooks

Retrieve a webhook endpoint

GEThttps://fomodata.dev/v1/webhooks/{id}

Scopes:webhooks:writeRate class:standardFlag:WEBHOOKS_ENABLED

Example request

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

Try it in the playground

Parameters

Path parameters

idstringrequired: e.g. wh_8Tq3NkVz1LmB5xRc7pYd2F

Response

200 The webhook endpoint (never includes the secret)

application/jsonWebhook

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

200 · exampleJSON

{
  "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"
}

Errors

Status	When
`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