# getOpenApi

> Part of the MAP Audio Music API docs. Index of every page: https://map.audio/developers/music-api/llms.txt. OpenAPI document: https://map.audio/developers/music-api/openapi.json.

`GET https://api.map.audio/v1/openapi.json`

Get this OpenAPI document

This document, with `servers` set to the origin that served it. Public. Free.

Auth: none; this route is public. Not an MCP tool: This document; MCP clients get the same schemas from tools/list.

## Example

```sh
curl -sS "https://api.map.audio/v1/openapi.json" \
  -H "Map-Version: 2026-11-01"
```

### 200: The document (shortened)

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "MAP Audio Music API",
    "version": "2026-11-01"
  },
  "servers": [
    {
      "url": "https://api.map.audio"
    }
  ]
}
```

### 500: Internal error

```json
{
  "error": {
    "type": "unavailable",
    "code": "internal_error",
    "message": "Something went wrong on our side; nothing was charged.",
    "param": null,
    "retryable": true,
    "jobId": null,
    "docUrl": "https://map.audio/developers/music-api/errors#internal_error",
    "requestId": "9a3f7c2e5b1d8f40-LHR"
  }
}
```

## Responses

- `200`: OpenAPI 3.1.
- `500`: Internal error
- `default`: Any other error: `error.code` names it, `error.param` the field at fault, and `error.docUrl` its entry in the error catalogue.