# Get webhook subscriptions

`GET /v2/webhooks`

**Base URLs:**

- Sandbox: `https://api.sandbox.bobgo.co.za`
- Production: `https://api.bobgo.co.za`

**Authentication:** Bearer token required (see the Authentication page).

## Example request

```bash
curl -X GET 'https://api.sandbox.bobgo.co.za/v2/webhooks' \
  -H "Authorization: Bearer <API_KEY>"
```

Lists the webhook subscriptions on your account, ordered by topic.

| Name | Type | Notes |
| --- | --- | --- |
| `topic` | string | Filter to one topic. |
| `status` | string | `active` or `inactive`. |
| `limit` | integer | Page size. There is no default: leave it out and every subscription comes back. |
| `offset`, `order`, `order_by` | | Standard [pagination](../1_Introduction/README.md#listing-and-pagination). |

## Response

```json
{
  "webhook_subscriptions": [
    {
      "id": 364,
      "account_id": 1234,
      "topic": "fulfillment/created",
      "delivery_url": "https://somewebhookurl.com",
      "status": "active",
      "first_failed_time": null,
      "time_created": "2026-09-05T08:30:00Z",
      "time_modified": "2026-09-05T08:30:00Z"
    }
  ],
  "count": 1
}
```

`first_failed_time` is the first place to look when events stop arriving. A
non-null value means deliveries have been failing since then, and after three
days of failures the subscription is set `inactive`. See
[How delivery works](README.md#how-delivery-works).