## Get a webhook subscription by ID

`client.webhookSubscriptions.retrieve(stringsubscriptionID, RequestOptionsoptions?): WebhookSubscription`

**get** `/v3/webhook-subscriptions/{subscriptionId}`

Retrieve details for a specific webhook subscription including its
target URL, subscribed events, and current status.

### Parameters

- `subscriptionID: string`

### Returns

- `WebhookSubscription`

  - `id: string`

    Unique identifier for the webhook subscription

  - `created_at: string`

    When the subscription was created

  - `is_active: boolean`

    Whether this subscription is currently active

  - `subscribed_events: Array<WebhookEventType>`

    List of event types this subscription receives

    - `"message.sent"`

    - `"message.received"`

    - `"message.read"`

    - `"message.delivered"`

    - `"message.failed"`

    - `"message.edited"`

    - `"reaction.added"`

    - `"reaction.removed"`

    - `"participant.added"`

    - `"participant.removed"`

    - `"chat.created"`

    - `"chat.group_name_updated"`

    - `"chat.group_icon_updated"`

    - `"chat.group_name_update_failed"`

    - `"chat.group_icon_update_failed"`

    - `"chat.typing_indicator.started"`

    - `"chat.typing_indicator.stopped"`

    - `"phone_number.status_updated"`

    - `"call.initiated"`

    - `"call.ringing"`

    - `"call.answered"`

    - `"call.ended"`

    - `"call.failed"`

    - `"call.declined"`

    - `"call.no_answer"`

  - `target_url: string`

    URL where webhook events will be sent

  - `updated_at: string`

    When the subscription was last updated

  - `phone_numbers?: Array<string> | null`

    Phone numbers this subscription filters for. If null or empty, events from all phone numbers are delivered.

### Example

```typescript
import LinqAPIV3 from '@linqapp/sdk';

const client = new LinqAPIV3({
  apiKey: process.env['LINQ_API_V3_API_KEY'], // This is the default and can be omitted
});

const webhookSubscription = await client.webhookSubscriptions.retrieve(
  'b2c3d4e5-f6a7-8901-bcde-f23456789012',
);

console.log(webhookSubscription.id);
```

#### Response

```json
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "created_at": "2024-01-15T10:30:00Z",
  "is_active": true,
  "subscribed_events": [
    "message.sent",
    "message.delivered",
    "message.read"
  ],
  "target_url": "https://webhooks.example.com/linq/events",
  "updated_at": "2024-01-15T10:30:00Z",
  "phone_numbers": [
    "string"
  ]
}
```