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

# OpenAPI Specification

> Interactive API documentation via OpenAPI

The Moneda REST API publishes a machine-readable OpenAPI 3.1 specification. You can use it to explore the API interactively, generate client libraries, or import endpoints into your favorite API tool.

## Live specification

The OpenAPI spec is always up to date and available at:

```
https://api.moneda.com/v1/openapi.json
```

## Swagger UI

For interactive exploration, open the Swagger UI in your browser:

```
https://api.moneda.com/v1/docs
```

From there you can browse every endpoint, see request and response schemas, and make test requests with your token.

<Info>
  Click the "Authorize" button in Swagger UI and paste your OAuth Bearer token to make authenticated requests directly from the browser.
</Info>

## Using with API tools

### Postman

1. Open Postman and click **Import**
2. Enter the URL: `https://api.moneda.com/v1/openapi.json`
3. Postman will create a collection with all 32 endpoints
4. Set the `Authorization` header to `Bearer <your-token>` at the collection level

### Insomnia

1. Go to **Application > Preferences > Data > Import Data**
2. Choose **From URL** and enter: `https://api.moneda.com/v1/openapi.json`
3. All endpoints will be imported into a new workspace

### Bruno

1. Open Bruno and go to **Collection > Import**
2. Select **OpenAPI V3** and paste the spec URL
3. Configure your Bearer token in the collection's auth settings

## Generating client SDKs

Use [OpenAPI Generator](https://openapi-generator.tech/) to create a typed client in your language of choice:

<Tabs>
  <Tab title="TypeScript">
    ```bash theme={null}
    npx @openapitools/openapi-generator-cli generate \
      -i https://api.moneda.com/v1/openapi.json \
      -g typescript-fetch \
      -o ./moneda-client
    ```
  </Tab>

  <Tab title="Python">
    ```bash theme={null}
    npx @openapitools/openapi-generator-cli generate \
      -i https://api.moneda.com/v1/openapi.json \
      -g python \
      -o ./moneda-client
    ```
  </Tab>

  <Tab title="Go">
    ```bash theme={null}
    npx @openapitools/openapi-generator-cli generate \
      -i https://api.moneda.com/v1/openapi.json \
      -g go \
      -o ./moneda-client
    ```
  </Tab>
</Tabs>

<Note>
  Generated clients handle request serialization, response parsing, and type checking automatically. You still need to provide your OAuth token for authentication.
</Note>

## What's next?

<CardGroup cols={2}>
  <Card title="API Overview" icon="globe" href="/api/overview">
    Learn the basics of the Moneda REST API.
  </Card>

  <Card title="API Endpoints" icon="list" href="/api/endpoints">
    Browse all 32 endpoints with descriptions and scopes.
  </Card>

  <Card title="Authentication" icon="lock" href="/api/authentication">
    Set up your OAuth token for API access.
  </Card>

  <Card title="CLI Tool" icon="terminal" href="/cli/overview">
    Use the Moneda CLI for quick command-line access.
  </Card>
</CardGroup>