Get Dedicated Endpoint

GET

api

dedicated

endpoints

{id}

Get a dedicated endpoint

curl --request GET \
  --url https://api.morphllm.com/api/v1/dedicated/endpoints/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.morphllm.com/api/v1/dedicated/endpoints/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.morphllm.com/api/v1/dedicated/endpoints/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.morphllm.com/api/v1/dedicated/endpoints/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.morphllm.com/api/v1/dedicated/endpoints/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

{
  "error": "Unauthorized"
}

{
  "error": "Endpoint not found"
}

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.

Authorizations

Authorization

string

header

required

Morph API key, passed as Authorization: Bearer sk-.... Create keys at https://www.morphllm.com/dashboard/api-keys.

Path Parameters

string<uuid>

required

Identifies the endpoint to read. Endpoint id from the list response or purchase.

Example:

"7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47"

Response

The endpoint snapshot.

Full lifecycle snapshot of one dedicated endpoint.

string<uuid>

required

Endpoint id (the order id).

Example:

"7f3c9a12-4b8e-4d21-9c6a-2e5f8b1d0a47"

state

enum<string>

required

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

Available options:

checkout_pending,

paid,

capacity_held,

provisioning,

pr_open,

merged,

deploying,

ready,

refunding,

refunded,

failed,

suspended,

canceled

Example:

"ready"

createdAt

string<date-time>

required

ISO 8601 creation time of the order.

Example:

"2026-10-01T09:14:00.000Z"

activationDeadline

string<date-time> | null

required

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

string<date-time> | null

required

Example:

"2026-10-01T10:52:37.000Z"

failureCode

string | null

required

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

Example:

null

spendCapCents

integer

required

Billing spend cap for the order, in US cents.

Example:

2000000

planName

string

required

Display name of the capacity plan.

Example:

"2× B200 Hourly"

reservedGpuEquivalents

integer

required

GPUs reserved by the plan.

Example:

2

modelId

string

required

Catalog model id purchased.

Example:

"deepseek-v4-flash"

modelDisplayName

string

required

Display name of the purchased model.

Example:

"DeepSeek V4 Flash 0731"

modelHardware

string

required

GPU generation for the purchased model.

Example:

"B200"

provisioningStatus

enum<string> | null

required

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

Available options:

pending,

pr_open,

merged,

deploying,

ready,

failed,

null

Example:

"ready"

events

object[]

required

Lifecycle trail, oldest first.

Show child attributes

Example:

[
  {
    "id": "9b2f4e71-0c3d-4a58-8e16-7d5a3b9c2f04",
    "eventType": "deployment.ready",
    "fromState": "deploying",
    "toState": "ready",
    "actorType": "system",
    "createdAt": "2026-10-01T10:52:37.000Z"
  }
]

endpoint

object

required

Serving coordinates, or null before provisioning creates them. Not cleared when the endpoint stops serving, so check state.

Show child attributes

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
}

cancelEffectiveAt

string<date-time> | null

required

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

Example:

null

Get a dedicated endpoint

curl --request GET \
  --url https://api.morphllm.com/api/v1/dedicated/endpoints/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.morphllm.com/api/v1/dedicated/endpoints/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.morphllm.com/api/v1/dedicated/endpoints/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.morphllm.com/api/v1/dedicated/endpoints/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.morphllm.com/api/v1/dedicated/endpoints/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

{
  "error": "Unauthorized"
}

{
  "error": "Endpoint not found"
}

Get Started

Models

API Reference

Integrations

Overview

Authorizations

Path Parameters

Response

​Overview

Authorizations

Path Parameters

Response

Overview