---
title: "List all endpoints"
method: GET
path: "/v1/projects/{projectID}/endpoints"
tags: ["Endpoints"]
---

# List all endpoints

`GET /v1/projects/{projectID}/endpoints`

This endpoint fetches an endpoints

## Path parameters

- `projectID` string, required

## Query parameters

- `direction` 'next' | 'prev'
- `next_page_cursor` string
- `ownerId` string
- `perPage` integer
- `prev_page_cursor` string
- `q` string
- `sort` string

## Response `200`

OK

- object
  - `message` string
  - `status` boolean
  - `data` object
    - `content` ModelsEndpointResponse[]
      - `advanced_signatures` boolean
      - `authentication` DatastoreEndpointAuthentication
        - `api_key` DatastoreApiKey
          - `header_name` string
          - `header_value` string
        - `type` 'api_key'
      - `created_at` string
      - `deleted_at` string
      - `description` string
      - `events` integer
      - `http_timeout` integer
      - `name` string
      - `owner_id` string
      - `project_id` string
      - `rate_limit` integer
      - `rate_limit_duration` integer
      - `secrets` DatastoreSecret[]
        - `created_at` string
        - `deleted_at` string
        - `expires_at` string
        - `uid` string
        - `updated_at` string
        - `value` string
      - `slack_webhook_url` string
      - `status` 'active' | 'inactive' | 'pending' | 'paused'
      - `support_email` string
      - `uid` string
      - `updated_at` string
      - `url` string
    - `pagination` DatastorePaginationData
      - `has_next_page` boolean
      - `has_prev_page` boolean
      - `next_page_cursor` string
      - `per_page` integer
      - `prev_page_cursor` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

## Changes

- **2024-03-26** `2ddfad646792` — 1 info
  - api operation id `GetEndpoints` was added
- **2024-02-20** `17b85b56a687` — 1 info
  - added the new optional `query` request parameter `direction`
- **2024-02-20** `152f0e36cf45` — 1 warning
  - deleted the `query` request parameter `direction`
- **2024-02-08** `5e75c52bd9bd` — 1 info
  - added the new optional `query` request parameter `direction`
- **2024-01-30** `5a219dba9f40` — 1 warning, 1 info
  - deleted the `query` request parameter `direction`
  - api operation id `GetEndpoints` removed and replaced with ``

[Change history](https://skmtc.dev/frain-dev/apis/convoy-api-reference/changes/v1/projects/:projectID/endpoints/get.md)

---

[API](https://skmtc.dev/frain-dev/apis/convoy-api-reference.md) · [All operations](https://skmtc.dev/frain-dev/apis/convoy-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frain-dev/convoy-api-reference/revisions/2ddfad646792/schema)