List endpoints

GET

/v1/endpoints

• Production

List all endpoints for the authenticated project. Supports cursor-based pagination.

Authorizations

• BearerAuth

Parameters

Query Parameters

limit

integer

default: 50 >= 1 <= 100

Maximum number of results to return

Example

50

cursor

string

Pagination cursor from previous response

Responses

200

Endpoints retrieved successfully

Paginated list of endpoints. Uses EndpointSummary (omits headers, rate limits) for performance. Use GET /endpoints/:id for full details.

object

data

Array<object>

Summary endpoint info for list responses (omits headers for performance)

object

id

Unique endpoint identifier

string

Example

ep_550e8400e29b41d4a716446655440000

url

Webhook delivery URL

string format: uri

Example

https://customer.app/webhooks

description

Optional description

string

Example

Main production webhook

paused

Whether the endpoint is paused

boolean

created_at

When the endpoint was created

string format: date-time

Example

2025-12-01T10:00:00Z

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

next_cursor

Cursor for the next page of results (opaque, do not parse)

string

Example

{
  "data": [
    {
      "id": "ep_550e8400e29b41d4a716446655440000",
      "url": "https://customer.app/webhooks",
      "description": "Main production webhook",
      "created_at": "2025-12-01T10:00:00Z"
    }
  ],
  "meta": {
    "request_id": "req_xyz123",
    "next_cursor": null
  }
}

401

Unauthorized - Invalid or missing API key

object

error

object

code

Machine-readable error code

string

Example

INVALID_REQUEST

message

Human-readable error message

string

Example

endpoint must be a valid HTTPS URL

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Example

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}