Get webhook subscription

Webhooks

GET/api/v1/scent/webhooks/{id}

Retrieves one of your own webhook subscriptions by ID. The response never includes the signing secret.

Path parameters

idstring (uuid)Required

Response

idstring (uuid)

urlstring (uri)

eventTypesarray of string

isActiveboolean

lastDeliveryAtstring (date-time)

lastDeliveryStatusstring (enum)

Null until the first delivery attempt. DeadLettered means every retry was exhausted — see the Webhooks guide for the retry schedule.

createdAtstring (date-time)

Other responses

401No bearer token (UNAUTHORIZED_MISSING_TOKEN), an invalid token (UNAUTHORIZED_INVALID_TOKEN) or an expired one (UNAUTHORIZED_TOKEN_EXPIRED — mint a new token). UPSTREAM_AUTH_FAILED is different: a dependent service refused the Gateway itself. That is a server-side fault — retry later and do NOT re-mint your token. See the Errors guide.

403The route is not available to your credential (FORBIDDEN).

404Unknown subscription.

429Too many requests — see the Rate limits guide. Retry after the Retry-After header (seconds).

502A dependent service returned an invalid response (BAD_GATEWAY). Retry with backoff.

503The service is temporarily unavailable (SERVICE_UNAVAILABLE). Retry with backoff.

504A dependent service did not respond in time (GATEWAY_TIMEOUT). Retry with backoff.

cURL

curl --request GET \
  --url https://api-omni.linra.net/api/v1/scent/webhooks/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b \
  --header 'Authorization: Bearer $TOKEN'

JavaScript

const res = await fetch('https://api-omni.linra.net/api/v1/scent/webhooks/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b', {
  headers: {
    Authorization: `Bearer ${token}`,
  },
});
const { payload } = await res.json();

C#

var response = await httpClient.GetAsync("https://api-omni.linra.net/api/v1/scent/webhooks/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b");

var envelope = await response.Content.ReadFromJsonAsync<ApiResponse<WebhookSubscriptionPartnerResponse>>();

Response

{
  "state": "SUCCESS",
  "payload": {
    "id": "5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b",
    "url": "https://your-integration.example.com/webhooks/linra",
    "eventTypes": [
      "string"
    ],
    "isActive": true,
    "lastDeliveryAt": "2026-08-22T09:14:03Z",
    "lastDeliveryStatus": "Success",
    "createdAt": "2026-08-22T09:14:03Z"
  },
  "details": null
}