> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morphllm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Dedicated Endpoints

> Discover your dedicated endpoints at /api/v1/dedicated/endpoints

## Overview

Lists every dedicated endpoint the key's account or organization owns, newest first. Each item carries `endpointUrl` and `servedModelName`, so discovery needs one call.

The list includes endpoints in every state, and ended endpoints are never removed. Route traffic only to items with `state` `ready`: `endpointUrl` stays set after an endpoint is canceled or suspended.

```bash theme={null}
curl https://api.morphllm.com/api/v1/dedicated/endpoints \
  -H "Authorization: Bearer $MORPH_API_KEY"
```

See [state values](/dedicated-endpoints#endpoint-states) for what each `state` means.


## OpenAPI

````yaml GET /api/v1/dedicated/endpoints
openapi: 3.1.0
info:
  title: Morph API
  version: 1.2.0
  description: >-
    The Morph public API at api.morphllm.com: OpenAI- and Anthropic-compatible
    inference (chat completions, messages), Fast Apply code editing, Compact
    context compression, Reflex classification, Singleshot typed decisions,
    fine-tuning, and dedicated endpoint management. Model ids, prices, and
    context windows are served live at https://www.morphllm.com/api/models/json.
  contact:
    name: Morph
    url: https://morphllm.com
    email: info@morphllm.com
  license:
    name: Proprietary
    url: https://morphllm.com/privacy/tos
servers:
  - url: https://api.morphllm.com
    description: Production
security: []
tags:
  - name: chat
    description: >-
      OpenAI- and Anthropic-compatible chat inference, including Fast Apply and
      WarpGrep models.
  - name: compact
    description: Context compression for long agent conversations.
  - name: reflex
    description: 'Per-turn classifiers: realtime prediction and batches.'
  - name: singleshot
    description: 'Typed decisions: a state in, a calibrated distribution per question out.'
  - name: fine-tuning
    description: Reflex fine-tuning job lifecycle.
  - name: models
    description: Model listing and management.
  - name: dedicated
    description: Dedicated endpoint discovery, status, and cancellation.
  - name: telemetry
    description: Usage reporting hooks.
paths:
  /api/v1/dedicated/endpoints:
    get:
      tags:
        - dedicated
      summary: List dedicated endpoints
      description: >-
        Every dedicated endpoint owned by the key: an organization key sees the
        organization’s endpoints, a personal key sees the user’s own. Includes
        connection details, so discovery needs no per-endpoint call.
      operationId: listDedicatedEndpoints
      responses:
        '200':
          description: The endpoints, newest first.
          content:
            application/json:
              example:
                endpoints:
                  - id: c204e8b1-9a3f-4f0e-8d72-5b6a1c9e3f10
                    state: deploying
                    createdAt: '2026-10-13T17:02:11.000Z'
                    readyAt: null
                    modelId: deepseek-v4-flash
                    modelDisplayName: DeepSeek V4 Flash 0731
                    modelHardware: B200
                    planName: 2× B200 Hourly
                    endpointUrl: null
                    servedModelName: null
                  - id: 7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47
                    state: ready
                    createdAt: '2026-10-01T09:14:00.000Z'
                    readyAt: '2026-10-01T10:52:37.000Z'
                    modelId: deepseek-v4-flash
                    modelDisplayName: DeepSeek V4 Flash 0731
                    modelHardware: B200
                    planName: 2× B200 Hourly
                    endpointUrl: https://dedicated-7f3c9a124b8e.morphllm.com
                    servedModelName: morph-dedicated-7f3c9a124b8e
                  - id: 3e91d0c5-6b27-4a8f-b1e4-9f0c2d7a5b83
                    state: canceled
                    createdAt: '2026-06-02T15:20:45.000Z'
                    readyAt: '2026-06-02T16:48:09.000Z'
                    modelId: deepseek-v4-flash
                    modelDisplayName: DeepSeek V4 Flash 0731
                    modelHardware: B200
                    planName: 2× B200 Hourly
                    endpointUrl: https://dedicated-3e91d0c56b27.morphllm.com
                    servedModelName: morph-dedicated-3e91d0c56b27
              schema:
                $ref: '#/components/schemas/DedicatedEndpointList'
        '401':
          $ref: '#/components/responses/DedicatedUnauthorized'
      security:
        - bearerAuth: []
components:
  schemas:
    DedicatedEndpointList:
      type: object
      properties:
        endpoints:
          type: array
          items:
            $ref: '#/components/schemas/DedicatedEndpointSummary'
          description: >-
            Every endpoint the key can see, newest first, in every state. Ended
            endpoints are never removed, so filter on `state`.
          example:
            - id: c204e8b1-9a3f-4f0e-8d72-5b6a1c9e3f10
              state: deploying
              createdAt: '2026-10-13T17:02:11.000Z'
              readyAt: null
              modelId: deepseek-v4-flash
              modelDisplayName: DeepSeek V4 Flash 0731
              modelHardware: B200
              planName: 2× B200 Hourly
              endpointUrl: null
              servedModelName: null
            - id: 7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47
              state: ready
              createdAt: '2026-10-01T09:14:00.000Z'
              readyAt: '2026-10-01T10:52:37.000Z'
              modelId: deepseek-v4-flash
              modelDisplayName: DeepSeek V4 Flash 0731
              modelHardware: B200
              planName: 2× B200 Hourly
              endpointUrl: https://dedicated-7f3c9a124b8e.morphllm.com
              servedModelName: morph-dedicated-7f3c9a124b8e
            - id: 3e91d0c5-6b27-4a8f-b1e4-9f0c2d7a5b83
              state: canceled
              createdAt: '2026-06-02T15:20:45.000Z'
              readyAt: '2026-06-02T16:48:09.000Z'
              modelId: deepseek-v4-flash
              modelDisplayName: DeepSeek V4 Flash 0731
              modelHardware: B200
              planName: 2× B200 Hourly
              endpointUrl: https://dedicated-3e91d0c56b27.morphllm.com
              servedModelName: morph-dedicated-3e91d0c56b27
      required:
        - endpoints
      description: Dedicated endpoints owned by the API key’s account or organization.
      example:
        endpoints:
          - id: c204e8b1-9a3f-4f0e-8d72-5b6a1c9e3f10
            state: deploying
            createdAt: '2026-10-13T17:02:11.000Z'
            readyAt: null
            modelId: deepseek-v4-flash
            modelDisplayName: DeepSeek V4 Flash 0731
            modelHardware: B200
            planName: 2× B200 Hourly
            endpointUrl: null
            servedModelName: null
          - id: 7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47
            state: ready
            createdAt: '2026-10-01T09:14:00.000Z'
            readyAt: '2026-10-01T10:52:37.000Z'
            modelId: deepseek-v4-flash
            modelDisplayName: DeepSeek V4 Flash 0731
            modelHardware: B200
            planName: 2× B200 Hourly
            endpointUrl: https://dedicated-7f3c9a124b8e.morphllm.com
            servedModelName: morph-dedicated-7f3c9a124b8e
          - id: 3e91d0c5-6b27-4a8f-b1e4-9f0c2d7a5b83
            state: canceled
            createdAt: '2026-06-02T15:20:45.000Z'
            readyAt: '2026-06-02T16:48:09.000Z'
            modelId: deepseek-v4-flash
            modelDisplayName: DeepSeek V4 Flash 0731
            modelHardware: B200
            planName: 2× B200 Hourly
            endpointUrl: https://dedicated-3e91d0c56b27.morphllm.com
            servedModelName: morph-dedicated-3e91d0c56b27
    DedicatedEndpointSummary:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Endpoint id (the order id). Pass it to the status and cancel routes.
          example: 7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47
        state:
          type: string
          enum:
            - checkout_pending
            - paid
            - capacity_held
            - provisioning
            - pr_open
            - merged
            - deploying
            - ready
            - refunding
            - refunded
            - failed
            - suspended
            - canceled
          description: >-
            Lifecycle state, and the field to gate on. Provisioning:
            `checkout_pending`, `paid`, `capacity_held`, `provisioning`,
            `pr_open`, `merged`, `deploying`. Serving: `ready` (the only state
            that accepts requests). Paused for non-payment: `suspended` (can
            return to `ready`). Ended before activation (canceled, provisioning
            failed, no capacity, or activation window elapsed): `refunding` →
            `refunded`. Ended after activation, or checkout abandoned:
            `canceled`. Ended with an error that needs support (rare): `failed`.
          example: ready
        createdAt:
          type: string
          format: date-time
          description: ISO 8601 time the order was created.
          example: '2026-10-01T09:14:00.000Z'
        readyAt:
          type:
            - string
            - 'null'
          format: date-time
          description: ISO 8601 time the endpoint first became `ready`, else null.
          example: '2026-10-01T10:52:37.000Z'
        modelId:
          type: string
          description: >-
            Catalog model id that was purchased. Not the name to send requests
            with.
          example: deepseek-v4-flash
        modelDisplayName:
          type: string
          description: Human-readable model name.
          example: DeepSeek V4 Flash 0731
        modelHardware:
          type: string
          description: GPU generation serving the model.
          example: B200
        planName:
          type: string
          description: Display name of the purchased capacity plan.
          example: 2× B200 Hourly
        endpointUrl:
          type:
            - string
            - 'null'
          format: uri
          description: >-
            Base URL to send OpenAI-compatible requests to (append `/v1`). Null
            until provisioning assigns it. It stays set after the endpoint stops
            serving, so check `state` before routing traffic.
          example: https://dedicated-7f3c9a124b8e.morphllm.com
        servedModelName:
          type:
            - string
            - 'null'
          description: >-
            The `model` value requests must use. Null until provisioning assigns
            it; like `endpointUrl`, it stays set after the endpoint stops
            serving.
          example: morph-dedicated-7f3c9a124b8e
      required:
        - id
        - state
        - createdAt
        - readyAt
        - modelId
        - modelDisplayName
        - modelHardware
        - planName
        - endpointUrl
        - servedModelName
      description: One dedicated endpoint as it appears in the list response.
      example:
        id: 7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47
        state: ready
        createdAt: '2026-10-01T09:14:00.000Z'
        readyAt: '2026-10-01T10:52:37.000Z'
        modelId: deepseek-v4-flash
        modelDisplayName: DeepSeek V4 Flash 0731
        modelHardware: B200
        planName: 2× B200 Hourly
        endpointUrl: https://dedicated-7f3c9a124b8e.morphllm.com
        servedModelName: morph-dedicated-7f3c9a124b8e
    DedicatedError:
      type: object
      properties:
        error:
          type: string
          description: Why the dedicated endpoint request failed.
          example: Endpoint not found
      required:
        - error
      description: Error body returned by the dedicated endpoint routes.
      example:
        error: Endpoint not found
  responses:
    DedicatedUnauthorized:
      description: The Authorization header is missing or holds an invalid Morph API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DedicatedError'
          example:
            error: Unauthorized
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: >-
        Morph API key, passed as `Authorization: Bearer sk-...`. Create keys at
        https://www.morphllm.com/dashboard/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.