---
title: "List all endpoints"
method: GET
path: "/endpoints"
tags: ["Endpoints"]
---

# List all endpoints

`GET /endpoints`

Returns a list of all endpoints associated with your account. You can filter the results by type (dedicated or serverless).

## Query parameters

- `type` 'dedicated' | 'serverless' — Filter endpoints by type
- `usage_type` 'on-demand' | 'reserved' — Filter endpoints by usage type
- `mine` boolean — If true, return only endpoints owned by the caller

## Response `200`

200

- object
  - `object` 'list', required — The object type, which is always `list`.
  - `data` ListEndpoint[], required
    - `object` 'endpoint', required — The object type, which is always `endpoint`.
    - `id` string, required — Unique identifier for the endpoint
    - `name` string, required — System name for the endpoint
    - `model` string, required — The model deployed on this endpoint
    - `type` 'serverless' | 'dedicated', required — The type of endpoint
    - `owner` string, required — The owner of this endpoint
    - `state` 'PENDING' | 'STARTING' | 'STARTED' | 'STOPPING' | 'STOPPED' | 'ERROR', required — Current state of the endpoint
    - `created_at` string, date-time, required — Timestamp when the endpoint was created

## Other responses

- `403` — Unauthorized
- `500` — Internal error

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/468edbdc879c/schema)