Webhooks

List Webhooks

List webhook subscriptions for the current account.

Coming soon

This endpoint is documented but not yet available in production. The contract below reflects the planned behavior. Reach out via support for early access or launch notification.

GET /v1/webhooks returns paginated webhook subscriptions for your account. Use it when you need to audit configured callbacks or find a webhook ID before updating it.

Request

The example below returns the first page of webhook subscriptions.

export SCRAPER_API_BASE_URL="https://scraper.geonode.io"
export GEONODE_SCRAPER_API_KEY="YOUR_API_KEY"

curl "$SCRAPER_API_BASE_URL/v1/webhooks?page=1&page_size=100" \
  -H "X-Api-Key: $GEONODE_SCRAPER_API_KEY"

Query Parameters

Use pagination when your account has many webhook subscriptions.

ParameterTypeRequiredDefaultDescription
pageintegerNo1Page number. Must be greater than 0.
page_sizeintegerNo100Results per page. Maximum is 100.

Response

The response contains webhook objects and pagination metadata. Signing secrets are not included in list responses.

{
  "items": [
    {
      "id": "2a936d3b-5a5d-47a0-b68d-5df0d8b8327c",
      "url": "https://example.com/webhooks/geonode-scraper",
      "description": "Production batch completion webhook",
      "is_active": true,
      "event_type": "batch_completed",
      "created_at": "2026-05-27T08:15:30Z",
      "updated_at": "2026-05-27T08:15:30Z"
    }
  ],
  "page": 1,
  "page_size": 100,
  "page_count": 1
}

On this page