> ## 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.

# Get Dedicated Endpoint

> Fetch one endpoint's lifecycle at /api/v1/dedicated/endpoints/{id}

## Overview

Returns one endpoint's full snapshot: `state`, `provisioningStatus`, `failureCode`, the lifecycle `events` trail, connection details under `endpoint`, and `cancelEffectiveAt` when a cancellation is scheduled. This is the read behind `morph dedicated status --json`.

Gate on `state`. `provisioningStatus` only tracks the deployment job and does not reflect payment, suspension, or cancellation.


## OpenAPI

````yaml GET /api/v1/dedicated/endpoints/{id}
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/{id}:
    get:
      tags:
        - dedicated
      summary: Get a dedicated endpoint
      description: >-
        Full lifecycle snapshot: state, provisioning status, failure code, the
        event trail, connection details, and any scheduled cancellation.
      operationId: getDedicatedEndpoint
      parameters:
        - schema:
            type: string
            format: uuid
            description: Endpoint id from the list response or purchase.
            example: 7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47
          required: true
          description: Identifies the endpoint to read.
          name: id
          in: path
      responses:
        '200':
          description: The endpoint snapshot.
          content:
            application/json:
              example:
                id: 7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47
                state: ready
                createdAt: '2026-10-01T09:14:00.000Z'
                activationDeadline: '2026-10-01T11:14:05.000Z'
                readyAt: '2026-10-01T10:52:37.000Z'
                failureCode: null
                spendCapCents: 2000000
                planName: 2× B200 Hourly
                reservedGpuEquivalents: 2
                modelId: deepseek-v4-flash
                modelDisplayName: DeepSeek V4 Flash 0731
                modelHardware: B200
                provisioningStatus: ready
                events:
                  - id: 9b2f4e71-0c3d-4a58-8e16-7d5a3b9c2f04
                    eventType: deployment.ready
                    fromState: deploying
                    toState: ready
                    actorType: system
                    createdAt: '2026-10-01T10:52:37.000Z'
                endpoint:
                  servedModelName: morph-dedicated-7f3c9a124b8e
                  displayName: DeepSeek V4 Flash 0731
                  endpointUrl: https://dedicated-7f3c9a124b8e.morphllm.com
                  hardware: B200
                  contextWindow: 1048576
                  maxConcurrency: 64
                  inputPricePerM: 0.14
                  outputPricePerM: 0.28
                  cachedInputPricePerM: 0.0028
                cancelEffectiveAt: null
              schema:
                $ref: '#/components/schemas/DedicatedEndpointStatus'
        '401':
          $ref: '#/components/responses/DedicatedUnauthorized'
        '404':
          $ref: '#/components/responses/DedicatedNotFound'
      security:
        - bearerAuth: []
components:
  schemas:
    DedicatedEndpointStatus:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Endpoint id (the order id).
          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; same values as the list response. Only `ready`
            serves requests.
          example: ready
        createdAt:
          type: string
          format: date-time
          description: ISO 8601 creation time of the order.
          example: '2026-10-01T09:14:00.000Z'
        activationDeadline:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Set at payment, two hours out. If the endpoint is not `ready` by
            then, the order moves to `refunding`.
          example: '2026-10-01T11:14:05.000Z'
        readyAt:
          type:
            - string
            - 'null'
          format: date-time
          description: ISO 8601 time of first readiness, else null.
          example: '2026-10-01T10:52:37.000Z'
        failureCode:
          type:
            - string
            - 'null'
          description: >-
            Reserved; currently always null. For why an order ended before
            activation, read the last entry in `events`.
          example: null
        spendCapCents:
          type: integer
          description: Billing spend cap for the order, in US cents.
          example: 2000000
        planName:
          type: string
          description: Display name of the capacity plan.
          example: 2× B200 Hourly
        reservedGpuEquivalents:
          type: integer
          description: GPUs reserved by the plan.
          example: 2
        modelId:
          type: string
          description: Catalog model id purchased.
          example: deepseek-v4-flash
        modelDisplayName:
          type: string
          description: Display name of the purchased model.
          example: DeepSeek V4 Flash 0731
        modelHardware:
          type: string
          description: GPU generation for the purchased model.
          example: B200
        provisioningStatus:
          type:
            - string
            - 'null'
          enum:
            - pending
            - pr_open
            - merged
            - deploying
            - ready
            - failed
            - null
          description: >-
            Status of the internal deployment job, or null before one starts.
            Diagnostic only: gate on `state`, which also covers payment and
            cancellation.
          example: ready
        events:
          type: array
          items:
            $ref: '#/components/schemas/DedicatedLifecycleEvent'
          description: Lifecycle trail, oldest first.
          example:
            - id: 9b2f4e71-0c3d-4a58-8e16-7d5a3b9c2f04
              eventType: deployment.ready
              fromState: deploying
              toState: ready
              actorType: system
              createdAt: '2026-10-01T10:52:37.000Z'
        endpoint:
          allOf:
            - $ref: '#/components/schemas/DedicatedEndpointConnection'
            - type:
                - object
                - 'null'
              description: >-
                Serving coordinates, or null before provisioning creates them.
                Not cleared when the endpoint stops serving, so check `state`.
        cancelEffectiveAt:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            When a requested cancellation takes effect, else null. A `ready`
            endpoint with this set keeps serving until then, then moves to
            `canceled`.
          example: null
      required:
        - id
        - state
        - createdAt
        - activationDeadline
        - readyAt
        - failureCode
        - spendCapCents
        - planName
        - reservedGpuEquivalents
        - modelId
        - modelDisplayName
        - modelHardware
        - provisioningStatus
        - events
        - endpoint
        - cancelEffectiveAt
      description: Full lifecycle snapshot of one dedicated endpoint.
      example:
        id: 7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47
        state: ready
        createdAt: '2026-10-01T09:14:00.000Z'
        activationDeadline: '2026-10-01T11:14:05.000Z'
        readyAt: '2026-10-01T10:52:37.000Z'
        failureCode: null
        spendCapCents: 2000000
        planName: 2× B200 Hourly
        reservedGpuEquivalents: 2
        modelId: deepseek-v4-flash
        modelDisplayName: DeepSeek V4 Flash 0731
        modelHardware: B200
        provisioningStatus: ready
        events:
          - id: 9b2f4e71-0c3d-4a58-8e16-7d5a3b9c2f04
            eventType: deployment.ready
            fromState: deploying
            toState: ready
            actorType: system
            createdAt: '2026-10-01T10:52:37.000Z'
        endpoint:
          servedModelName: morph-dedicated-7f3c9a124b8e
          displayName: DeepSeek V4 Flash 0731
          endpointUrl: https://dedicated-7f3c9a124b8e.morphllm.com
          hardware: B200
          contextWindow: 1048576
          maxConcurrency: 64
          inputPricePerM: 0.14
          outputPricePerM: 0.28
          cachedInputPricePerM: 0.0028
        cancelEffectiveAt: null
    DedicatedLifecycleEvent:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Event id.
          example: 9b2f4e71-0c3d-4a58-8e16-7d5a3b9c2f04
        eventType:
          type: string
          description: >-
            What happened, as `area.action`: for example `payment.succeeded`,
            `capacity.held`, `deployment.started`, `deployment.ready`,
            `deployment.failed`, `cancellation.noticed`,
            `cancellation.effective`.
          example: deployment.ready
        fromState:
          type:
            - string
            - 'null'
          description: State before the event, or null when the event did not change state.
          example: deploying
        toState:
          type:
            - string
            - 'null'
          description: State after the event, or null when the event did not change state.
          example: ready
        actorType:
          type: string
          description: >-
            Who caused the event: `user`, `stripe`, `system`, `github_app`, or
            `github_actions`.
          example: system
        createdAt:
          type: string
          format: date-time
          description: ISO 8601 time of the event.
          example: '2026-10-01T10:52:37.000Z'
      required:
        - id
        - eventType
        - fromState
        - toState
        - actorType
        - createdAt
      description: One entry in an endpoint’s lifecycle trail.
      example:
        id: 9b2f4e71-0c3d-4a58-8e16-7d5a3b9c2f04
        eventType: deployment.ready
        fromState: deploying
        toState: ready
        actorType: system
        createdAt: '2026-10-01T10:52:37.000Z'
    DedicatedEndpointConnection:
      type: object
      properties:
        servedModelName:
          type: string
          description: The `model` value requests must use.
          example: morph-dedicated-7f3c9a124b8e
        displayName:
          type: string
          description: Human-readable name of the served model.
          example: DeepSeek V4 Flash 0731
        endpointUrl:
          type:
            - string
            - 'null'
          format: uri
          description: Base URL for requests; append `/v1` for OpenAI clients.
          example: https://dedicated-7f3c9a124b8e.morphllm.com
        hardware:
          type:
            - string
            - 'null'
          description: Hardware serving this endpoint.
          example: B200
        contextWindow:
          type:
            - integer
            - 'null'
          description: Maximum context length in tokens.
          example: 1048576
        maxConcurrency:
          type:
            - integer
            - 'null'
          description: Concurrent request limit for the endpoint.
          example: 64
        inputPricePerM:
          type: number
          description: USD per million input tokens, for usage display.
          example: 0.14
        outputPricePerM:
          type: number
          description: USD per million output tokens, for usage display.
          example: 0.28
        cachedInputPricePerM:
          type:
            - number
            - 'null'
          description: USD per million cached input tokens, for usage display.
          example: 0.0028
      required:
        - servedModelName
        - displayName
        - endpointUrl
        - hardware
        - contextWindow
        - maxConcurrency
        - inputPricePerM
        - outputPricePerM
        - cachedInputPricePerM
      description: Serving coordinates, present once provisioning creates the endpoint.
      example:
        servedModelName: morph-dedicated-7f3c9a124b8e
        displayName: DeepSeek V4 Flash 0731
        endpointUrl: https://dedicated-7f3c9a124b8e.morphllm.com
        hardware: B200
        contextWindow: 1048576
        maxConcurrency: 64
        inputPricePerM: 0.14
        outputPricePerM: 0.28
        cachedInputPricePerM: 0.0028
    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
    DedicatedNotFound:
      description: >-
        No endpoint with this id belongs to the key. Endpoints owned by another
        account also return 404, so existence is never leaked.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DedicatedError'
          example:
            error: Endpoint not found
  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.