> For the complete documentation index, see [llms.txt](https://docs.imerit.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imerit.net/sdk/sdk-documentation/organization-level-sdk-functions/get_llms.md).

# get\_llms

`imerit_ango.sdk.SDK.`

## get\_llms(llm\_id)

Retrieve the LLM integrations configured for your organization.

### Parameters

* **llm\_id:** string, *Optional, Default None*
  * The unique identifier of an LLM integration. If provided, the function returns the matching integration instead of the full response.

Returns:

* **output:** dict
  * Without `llm_id`, a dictionary containing a `status` field and the integrations in `data.llms`.
  * With `llm_id`, the matching LLM integration object.

{% hint style="warning" %}
The response includes the stored provider API key in `configuration.apiKey`. Handle the response as sensitive data and do not write it to logs or expose it to clients.
{% endhint %}

### Example

Retrieve all LLM integrations in the organization:

{% tabs %}
{% tab title="python" %}

```python
import os
from dotenv import load_dotenv
from imerit_ango.sdk import SDK

load_dotenv('variables.env')
api_key = os.getenv('API_KEY')

ango_sdk = SDK(api_key)

sdk_response = ango_sdk.get_llms()
llm_list = sdk_response['data']['llms']
```

{% endtab %}

{% tab title="curl" %}

```bash
curl -X GET "https://imeritapi.ango.ai/v2/llms" \
  -H "Content-Type: application/json" \
  -H "apikey: $ANGO_API_KEY"
```

{% endtab %}
{% endtabs %}

Retrieve a specific LLM integration:

{% tabs %}
{% tab title="python" %}

```python
llm_id = "<LLM ID>"
llm = ango_sdk.get_llms(llm_id=llm_id)
```

{% endtab %}

{% tab title="curl" %}

```bash
curl -X GET "https://imeritapi.ango.ai/v2/llms?_id=<LLM ID>" \
  -H "Content-Type: application/json" \
  -H "apikey: $ANGO_API_KEY"
```

{% endtab %}
{% endtabs %}

<details>

<summary>Sample Output</summary>

```json
{
  "status": "success",
  "data": {
    "llms": [
      {
        "name": "My OpenAI Account",
        "provider": "openai",
        "model": "gpt-4.1-mini",
        "isStreamable": true,
        "configuration": {
          "apiKey": "<OPENAI API KEY>"
        },
        "organization": {
          "id": "ORGANIZATION_ID"
        },
        "deleted": false,
        "_id": "LLM_ID"
      }
    ],
    "total": 1
  }
}
```

</details>

{% hint style="info" %}
**See also**

[create\_llm](/sdk/sdk-documentation/organization-level-sdk-functions/create_llm.md), [delete\_llm](/sdk/sdk-documentation/organization-level-sdk-functions/delete_llm.md)
{% endhint %}