> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Organization's Service Versions

> Retrieve a list of available versions for a specified service within an organization.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**org\_id** `string` *required*

The unique identifier of the organization.

**service** `string` *required*

The name of the service whose versions you want to retrieve.\
\
Valid values: `"api_server"`, `"ws_server"`

### Response

**data** `object`

Contains the list of available versions for the requested service.

**data.versions** `array`

An array of available versions.

**data.versions\[].id** `string`

The unique identifier of the version.

**data.versions\[].friendly\_name** `string`

A human-readable name for the version.

**data.versions\[].created\_at** `string (ISO 8601)`

The timestamp when the version was created.

**data.versions\[].git\_sha** `string`

The Git SHA hash of the version.

**data.versions\[].tags** `array`

Tags categorizing the version, e.g., `["latest"]`, `["stable"]`.

**data.versions\[].currently\_supported** `boolean`

Whether this version is currently supported.

**data.versions\[].recommended\_upgrade\_to** `string | null`

The recommended version to upgrade to, if applicable.

**data.versions\[].service** `string`

The name of the service this version belongs to.

**data.versions\[].placement\_group** `string`

The placement group of this version.

**errors** `null`

Always `null` on success.

```json Response   theme={null}
{
  "data": {
    "versions": [
      {
        "created_at": "2024-11-28T19:05:17.003Z",
        "git_sha": "",
        "friendly_name": "Latest",
        "tags": ["latest"],
        "currently_supported": true,
        "recommended_upgrade_to": null,
        "service": "api_server",
        "id": "adf1064d-5080-4055-8493-0d4fdc3c8106",
        "placement_group": "blandshared"
      },
      {
        "created_at": "2024-11-27T00:28:30.286Z",
        "git_sha": "",
        "friendly_name": "v1.0.1",
        "tags": ["stable"],
        "currently_supported": true,
        "recommended_upgrade_to": null,
        "service": "api_server",
        "id": "a46f516b-b01f-4ea6-9c7b-5b05fca49d4f",
        "placement_group": "blandshared"
      }
    ]
  },
  "errors": null
}

```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.