List webhook endpoints
Returns the project's webhook endpoint (at most one). The secret is never included.
GET
/v1/webhook_endpointsAuthorization
bearerAuth AuthorizationBearer <token>
Secret API key as a bearer token: Authorization: Bearer sk_live_….
Test keys (sk_test_…) are refused with 401 test_mode_unavailable.
Keys are issued per project in the dashboard. Never expose a secret
key in browser or mobile code.
In: header
Query Parameters
limit?integer
Page size, 1–100. Default 10. Anything else returns 400 parameter_invalid.
starting_after?string
Cursor — the id of the last object on the previous page; returns the objects after it.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/webhook_endpoints"{
"object": "list",
"url": "/v1/webhook_endpoints",
"has_more": false,
"data": [
{
"id": "we_t5kz2m7qx3wn4vbc6rjy2dfa6h",
"object": "webhook_endpoint",
"url": "https://yourshop.mn/webhooks/wire",
"enabled_events": [
"*"
],
"status": "enabled",
"livemode": true,
"created": 1791770400
}
]
}{
"error": {
"type": "invalid_request_error",
"code": "parameter_missing",
"message": "amount is required",
"param": "amount",
"request_id": "req_8f3a1c9e5b7d2f4a6c0e9b1d"
}
}{
"error": {
"type": "api_error",
"code": "test_mode_unavailable",
"message": "test keys are not accepted by this API; use a live secret key",
"request_id": "req_8f3a1c9e5b7d2f4a6c0e9b1d"
}
}