# List endpoints

Source: https://checkslip.com/en/docs/list-endpoints

GET `https://api.checkslip.com/api/webhooks/endpoints`

API key

Lists every endpoint of the account with its url, the event_types it receives, enabled, and the last 4 characters of the signing secret in secret_hint. A disabled endpoint carries the reason in disabled_reason: MANUAL (you turned it off), GONE (your system answered 410) or FAILING (every send failed for 5 days in a row). A disabled endpoint stores no new messages. Use next_cursor for the next page. Needs an API key with webhook:read.

## Parameters

| Field | In | Type | Required |
| --- | --- | --- | --- |
| `traceparent` | header | `string` | no |
| `limit` | query | `integer` | no |
| `cursor` | query | `string` | no |

## Responses

### 200 `application/json`

| Field | Type | Required |
| --- | --- | --- |
| `items` | `Endpoint[]` | yes |
| `items[].id` | `string` | yes |
| `items[].url` | `string (uri)` | yes |
| `items[].description` | `string \| null` | yes |
| `items[].event_types` | `slip.checked \| webhook.test[]` | yes |
| `items[].enabled` | `boolean` | yes |
| `items[].disabled_reason` | `MANUAL \| GONE \| FAILING \| null` | yes |
| `items[].secret_hint` | `string` | yes |
| `items[].previous_secret_expires_at` | `string (date-time) \| null` | no |
| `items[].created_at` | `string (date-time)` | yes |
| `items[].updated_at` | `string (date-time)` | yes |
| `next_cursor` | `string \| null` | yes |

### Possible errors

400 401 403

An error as Problem Details. All codes are listed at [Error codes](https://checkslip.com/en/docs/errors)

**cURL**

```bash
curl https://api.checkslip.com/api/webhooks/endpoints \
  -H "Authorization: Bearer $CHECKSLIP_API_KEY"
```

**Node.js**

```javascript
const res = await fetch("https://api.checkslip.com/api/webhooks/endpoints", {
  headers: {
    Authorization: `Bearer ${process.env.CHECKSLIP_API_KEY}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os

import requests

res = requests.get(
    "https://api.checkslip.com/api/webhooks/endpoints",
    headers={
        "Authorization": f"Bearer {os.environ['CHECKSLIP_API_KEY']}",
    },
)
data = res.json()
```

```json
{
  "items": [
    {
      "id": "string",
      "url": "https://example.com/hooks/checkslip",
      "description": "string",
      "event_types": [
        "slip.checked"
      ],
      "enabled": true,
      "disabled_reason": "MANUAL",
      "secret_hint": "string",
      "previous_secret_expires_at": "2026-11-05T09:30:00+07:00",
      "created_at": "2026-11-05T09:30:00+07:00",
      "updated_at": "2026-11-05T09:30:00+07:00"
    }
  ],
  "next_cursor": "string"
}
```