Webhooks

Get an endpoint

Reads a webhook endpoint by id.

GET
/v1/webhooks/endpoints/{id}

Returns an endpoint of your account by its id. The secret does not come back: it only shows up at creation.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

id*string

Identifier of the resource, as returned by the API.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

The requested endpoint. The secret is never returned again.

application/json
  1. response

An endpoint of your system that receives our webhooks.

id*string

Opaque unique identifier of the endpoint, generated by the API. Use it in the /v1/webhooks/endpoints/{id} routes and to filter deliveries.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
url*string

Where we send the events, with a POST.

description*|

Your note about the endpoint. null when there is none.

events*array<|>

Event types the endpoint receives, or ["*"] for every type, including future ones.

enabled*boolean

false pauses the endpoint: new events skip it, and its pending deliveries fail without a call.

createdAt*string

When the endpoint was created, in ISO-8601 (UTC).

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
updatedAt*string

When the endpoint last changed, in ISO-8601 (UTC).

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
curl -X GET "https://example.com/v1/webhooks/endpoints/3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01"
{  "id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",  "url": "https://your-app.com/webhooks/marketapi",  "description": "Production",  "events": [    "*"  ],  "enabled": true,  "createdAt": "2026-10-06T14:20:00.000Z",  "updatedAt": "2026-10-06T14:20:00.000Z"}