Get a webhook endpoint
GET/v1/webhook-endpoints/{endpointId}
Returns one of this key's endpoints: its url, event types, whether it is on, and why it was switched off.
Permissions: any valid key · Kind: read · Cost: 1 unit
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
endpointId |
uuid | yes |
Query parameters
None.
Response 200
| Field | Type | Required | Description |
|---|---|---|---|
object |
"webhook_endpoint" | yes | |
id |
uuid | yes | |
url |
string | yes | |
description |
string | yes | |
eventTypes |
"trip.created" | "trip.updated" | "trip.archived" | "trip.restored" | "trip.published" | "trip.unpublished" | "trip.deleted" | "trip.itinerary.updated" | "quote.created" | "quote.updated" | "quote.sent" | "quote.accepted" | "quote.rejected" | "quote.deleted" | "traveler.added" | "traveler.updated" | "traveler.removed" | "trip.contact.updated" | "document.created" | "document.updated" | "document.deleted"[] | yes | |
enabled |
boolean | yes | |
disabledReason |
"manual" | "failing" | "key_invalid" | null | yes | Why it is off: switched off by a person, failing for 3 days, or its key is no longer usable. |
keyId |
uuid | yes | The API key it belongs to; its events are read with this key's permissions. |
previousSecretExpiresAt |
string | null | yes | After a rotation, the old secret keeps signing until this moment. |
lastSuccessAt |
string | null | yes | |
failingSince |
string | null | yes | |
createdAt |
string | yes | |
updatedAt |
string | yes |
Errors
Errors are problem details. Besides the refusals described above, any call like this one can return:
invalid_request— Invalid requestunauthorized— Missing or invalid API keyinsufficient_scope— Missing permissionrate_limited— Rate limit reachednot_found— Not found