---
title: "Get LLM Provider"
method: POST
path: "/llm-provider/{id}/get-item"
tags: ["LLM Provider"]
---

# Get LLM Provider

`POST /llm-provider/{id}/get-item`

## Request

- Base URL: `https://oneuptime.com/api`
- URL: `https://oneuptime.com/api/llm-provider/{id}/get-item`
- Auth: API key in header `APIKey`
- TypeScript: <https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/docs/llm-provider/:id/get-item/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to retrieve a single LLM Provider by ID

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `select` LlmProviderSelectSchema: Select schema for LlmProvider. Set fields to true to include them in the response.
    - `_id` boolean
    - `createdAt` boolean
    - `updatedAt` boolean
    - `deletedAt` boolean
    - `name` boolean
    - `description` boolean
    - `slug` boolean
    - `llmType` boolean
    - `apiKey` boolean
    - `modelName` boolean
    - `baseUrl` boolean
    - `additionalParams` boolean
    - `hasAdditionalParams` boolean
    - `projectId` boolean
    - `createdByUserId` boolean
    - `isDefault` boolean
    - `costPerMillionTokensInUSDCents` boolean

## Response `200`

Successful response

- object
  - `data` LlmProvider
    - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `createdAt` object: Date and Time when the object was created. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `version` number: Object version
    - `name` string, required: A friendly name for this LLM configuration. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `description` string: Description of this LLM configuration. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `slug` string, required: Friendly globally unique name for your object. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [No access - you don't have permission for this operation]
    - `llmType` 'OpenAI' | 'AzureOpenAI' | 'Anthropic' | 'Groq' | 'Mistral' | 'Ollama' | 'OpenAICompatible', required: The type of LLM provider (OpenAI, Azure OpenAI, Anthropic, Groq, Mistral, Ollama, OpenAICompatible, etc.). Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `apiKey` string, password: The API key for the LLM provider. Required for OpenAI, Azure OpenAI / Microsoft Foundry (one of the resource's keys), Anthropic, Groq, and Mistral. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `modelName` string: The model to use (e.g., gpt-5.1, claude-sonnet-5-5, llama3.1). For Azure OpenAI / Microsoft Foundry, the deployment's name. Optional: left empty, the provider's default model is used, and an OpenAI-compatible server is asked for the first model it lists. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `baseUrl` string: The base URL for the LLM API. Required for Azure OpenAI / Microsoft Foundry (the resource's endpoint, such as https://<resource>.openai.azure.com/openai/v1), Ollama and OpenAI-compatible servers, optional for others. The API key and the Additional Parameters are sent to it, so only project owners and admins can change it. Everyone who may read the project's settings can read it, so never put a key, a token or a password in it: use the API Key. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin]
    - `additionalParams` object: Optional JSON object with extra parameters sent directly to the provider API. These are merged last and override any defaults. Read only by project owners and admins, like the API key. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `hasAdditionalParams` boolean: Whether Additional Parameters are saved. Worked out from the parameters on every read. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [No access - you don't have permission for this operation]
    - `projectId` string, uuid: ID of the project this LLM belongs to. If null, it is a global LLM. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [No access - you don't have permission for this operation]
    - `createdByUserId` string, uuid: User ID who created this object (if this object was created by a User). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner], Update: [No access - you don't have permission for this operation]
    - `isDefault` boolean, required: Is this the default LLM provider for the project? When set, the global LLM provider will not be used. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create LLM], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit LLM]
    - `costPerMillionTokensInUSDCents` number, required: Cost per million tokens in USD cents. Used for billing when using global LLM providers. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read LLM], Update: [No access - you don't have permission for this operation]

## Other responses

- `400`: Bad request. This response indicates that the request was malformed or contained invalid data.
- `401`: Unauthorized. This response indicates that the request requires user authentication.
- `402`: Payment Required. This response indicates that the request requires payment or a valid subscription.
- `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it.
- `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each.
- `405`: Project not found. This response indicates that the requested project does not exist or is not accessible.
- `408`: Request Timeout. This response indicates that the server timed out waiting for the request.
- `415`: Unable to reach server. This response indicates that the server is currently unreachable or down.
- `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource.
- `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)