Skip to main content
GET
/
v1
/
webhook-endpoints
List webhook endpoints
curl --request GET \
  --url https://api.scrip.dev/v1/webhook-endpoints \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "created_at": "2026-01-15T10:30:00Z",
      "description": "Production webhook receiver",
      "enabled_events": [
        "balance.credited",
        "balance.debited"
      ],
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "metadata": "<unknown>",
      "secret": "whsec_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
      "status": "ACTIVE",
      "updated_at": "2026-01-15T10:30:00Z",
      "url": "https://example.com/webhooks"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "YWJjMTIz"
  }
}
Returns all webhook endpoints for your organization, ordered by creation date (newest first). Archived endpoints are excluded. Filter by status to find only ACTIVE or DISABLED endpoints. The secret field is never included in list responses.
For usage patterns and examples, see the Webhooks guide.

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header.

Query Parameters

​
status
enum<string>

Filter by endpoint status

Available options:
ACTIVE,
DISABLED
​
limit
integer
default:20

Maximum number of results (default 20, max 100)

Required range: x >= 1
​
cursor
string

Pagination cursor from previous response

Response

List of endpoints

​
data
object[]

Data contains the list of items

​
pagination
object

Pagination contains cursor information for fetching more results