Get LLM Details

GET

llms

{id}

Get LLM Details

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

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

fetch('https://api.dialnexa.com/v1/llms/{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.dialnexa.com/v1/llms/{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.dialnexa.com/v1/llms/{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.dialnexa.com/v1/llms/{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": "llm_mfgt5q2x8k4w7r",
  "name": "GPT-4.1 Mini",
  "provider": "openai"
}

{
  "message": "API key is missing or invalid. You can generate this by logging in into dashboard"
}

{
  "message": "Could not find LLM with id: abc12345678901"
}

{
  "message": "An unexpected error occurred. Please try again later."
}

Read only Returns the API-key catalog fields for a single LLM in DialNexa’s supported model catalogue. The response includes the model’s stable id, the upstream provider (for example openai, google or groq) and the display name. Context window sizes and feature flags such as tool calling are not part of the API-key response.

When To Get LLM Details

Use this endpoint when you have an llm_id saved on an agent configuration or in your own database and you need to resolve it into a human-readable label. The API-key response contains only id, name, and provider. This endpoint returns any model in the catalog that is not deleted. It does not check primary or fallback eligibility, so a model returned here may not be accepted in that role. To check that a model can be used as a primary or fallback model, look for it in List LLMs or List Fallback LLMs.

Agent build UIs typically fetch this when rendering the LLM selection for an already-saved agent so the dropdown can display the correct provider and name.
Migration tooling that retires a deprecated model uses this to confirm the target model still exists in the catalog before bulk-updating agents.
Cost-aware dashboards read the provider from this endpoint to attribute spend per model in workspace reports.

If you need the full list of available LLMs, call List LLMs instead. That endpoint returns every model that can be an agent’s primary LLM, the same list for every workspace, one page at a time.

Path parameters

Parameter	Description
`id`	The LLM ID, for example `llm_mfgt5q2x8k4w7r`.

Errors

404 Not Found is returned when the id does not match an LLM in the catalog, or the model has been deleted. This usually means the model has been deprecated and removed, or the ID was mistyped.
401 Unauthorized is returned when the API key is missing, malformed, or revoked. See API authentication.

List LLMs: fetch the models available as a primary LLM.
Update Agent: change the LLM assigned to an existing agent.
LLMs and conversation behavior: guidance on choosing an LLM for your use case.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

LLM ID

Example:

"llm_mfgt5q2x8k4w7r"

Response

LLM returned successfully.

string

required

Signed LLM ID

Example:

"llm_mfgt5q2x8k4w7r"

name

string

provider

enum<string>

Available options:

google,

openai,

deepseek,

groq,

gemini,

sarvam

Get LLM Details

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

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

fetch('https://api.dialnexa.com/v1/llms/{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.dialnexa.com/v1/llms/{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.dialnexa.com/v1/llms/{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.dialnexa.com/v1/llms/{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": "llm_mfgt5q2x8k4w7r",
  "name": "GPT-4.1 Mini",
  "provider": "openai"
}

{
  "message": "API key is missing or invalid. You can generate this by logging in into dashboard"
}

{
  "message": "Could not find LLM with id: abc12345678901"
}

{
  "message": "An unexpected error occurred. Please try again later."
}

Overview

Endpoints

When To Get LLM Details

Path parameters

Errors

Authorizations

Path Parameters

Response

​When To Get LLM Details

​Path parameters

​Errors

​Related endpoints

Authorizations

Path Parameters

Response

When To Get LLM Details

Path parameters

Errors

Related endpoints