MOmorphllm
dedicated

Get a dedicated endpoint

Changed on

Full lifecycle snapshot: state, provisioning status, failure code, the event trail, connection details, and any scheduled cancellation.

get/api/v1/dedicated/endpoints/{id}

Request

  • Base URL
    https://api.morphllm.com
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Endpoint id from the list response or purchase.

Example:7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47

Identifies the endpoint to read.

Response

The endpoint snapshot.

idstring uuid required

Endpoint id (the order id).

state'checkout_pending' | 'paid' | 'capacity_held' | 'provisioning' | 'pr_open' | 'merged' | 'deploying' | 'ready' | 'refunding' | 'refunded' | 'failed' | 'suspended' | 'canceled' required

Lifecycle state; same values as the list response. Only ready serves requests.

createdAtstring date-time required

ISO 8601 creation time of the order.

activationDeadlinestring date-time nullable required

Set at payment, two hours out. If the endpoint is not ready by then, the order moves to refunding.

readyAtstring date-time nullable required

ISO 8601 time of first readiness, else null.

failureCodestring nullable required

Reserved; currently always null. For why an order ended before activation, read the last entry in events.

spendCapCentsinteger required

Billing spend cap for the order, in US cents.

planNamestring required

Display name of the capacity plan.

reservedGpuEquivalentsinteger required

GPUs reserved by the plan.

modelIdstring required

Catalog model id purchased.

modelDisplayNamestring required

Display name of the purchased model.

modelHardwarestring required

GPU generation for the purchased model.

provisioningStatus'pending' | 'pr_open' | 'merged' | 'deploying' | 'ready' | 'failed' | 'null' nullable required

Status of the internal deployment job, or null before one starts. Diagnostic only: gate on state, which also covers payment and cancellation.

cancelEffectiveAtstring date-time nullable required

When a requested cancellation takes effect, else null. A ready endpoint with this set keeps serving until then, then moves to canceled.

Example response

{
  "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
}

Changes