---
title: "List webhook endpoints"
method: GET
path: "/webhook_endpoints"
tags: ["webhooks"]
---

# List webhook endpoints

`GET /webhook_endpoints`

## Request

- Base URL: `https://api.mobilevalidate.com/v1`
- URL: `https://api.mobilevalidate.com/v1/webhook_endpoints`
- Auth: HTTP bearer

Every endpoint of the account that is not deleted and has the same mode as the key (test keys list test endpoints, live keys live endpoints). Needs `webhooks:manage`.

## Response `200`

Endpoints.

- object
  - `object` 'list', required
  - `data` WebhookEndpoint[], required
    - `object` 'webhook_endpoint', required
    - `id` string, required
    - `url` string, uri, required
    - `events` WebhookEvent[], required
    - `status` 'pending_verification' | 'active' | 'disabled', required
    - `livemode` boolean: Mode of the key that created the endpoint. Test keys see and manage only test endpoints, live keys only live endpoints; test-mode events are delivered only to test endpoints and live events only to live endpoints.
    - `created_at` string, date-time, required
  - `has_more` boolean, required

## Other responses

- `default`: Error. Branch on `error.code`; `suggestion` (optional) says how to fix the request. A known path called with the wrong method answers `404 not_found` with an `Allow` header listing the methods it accepts.

---

[API](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api.md) · [All operations](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mobilevalidate/apis/mobilevalidate-api/revisions/f2e56c2454ef?raw)