> This page is for version V1 (default).
> For other versions, use one of these documentation indexes:
> - V1 (default): https://docs.ottimate.com/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ottimate.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ottimate.com/_mcp/server.

# Release Plan

## Overview

This page tracks all releases and updates to the Ottimate API. We continuously add new features and endpoints based on partner feedback and platform capabilities.

## Status Definitions

Each endpoint in the API Reference is tagged with a status indicator to help you understand its maturity and stability.

| Status                  | Meaning                                                                                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Stable**              | Fully production-ready. Covered by SLA and backward-compatibility guarantees.                                                                                |
| **Generally Available** | Released and available to all users. Stable for production use; no breaking changes without a versioned migration path.                                      |
| **Beta**                | Available for integration and testing. Functionality is complete but may receive minor changes based on feedback before reaching GA. Not yet covered by SLA. |
| **Pre-release**         | Early access preview. The interface and behavior may change significantly. Intended for evaluation and early feedback only.                                  |
| **In Development**      | Under active development. Endpoints are visible in documentation for planning purposes but are not yet available for use.                                    |
| **Deprecated**          | Scheduled for removal. The endpoint still functions but should be migrated away from. Refer to the changelog for the sunset timeline.                        |

## Current and Planned APIs

#### Current Release (v1.0.0)

### Accounts API

Manage account-level entities and organizational structures.

| Task                                 | Endpoint                                          |
| ------------------------------------ | ------------------------------------------------- |
| Retrieve a list of accounts          | `GET /v1/accounts`                                |
| Retrieve a list of companies         | `GET /v1/accounts/{id}/companies`                 |
| Retrieve a list of locations         | `GET /v1/accounts/{id}/locations`                 |
| Toggle Basic Approval for a location | `PATCH /v1/accounts/{id}/locations/{location_id}` |

Supports `X-API-Version: 1.1.0`, which renames the Location object's deprecated `group` field to `location_group`. Requests that send no version header, or an unrecognized one, are served `1.0.0`. See [API versioning](/account-structure/overview#api-versioning).

See [Accounts](/api-reference/api-reference/accounts/) in the API reference for usage and examples.

---

### Catalog API

Manage catalog entries, allowances, and variances for procurement operations.

| Task                                  | Endpoint                                       |
| ------------------------------------- | ---------------------------------------------- |
| List all catalog entries              | `GET /v1/catalog/entries`                      |
| Create a new catalog entry            | `POST /v1/catalog/entries`                     |
| Retrieve a specific catalog entry     | `GET /v1/catalog/entries/{id}`                 |
| Update a catalog entry                | `PATCH /v1/catalog/entries/{id}`               |
| Bulk create or update catalog entries | `POST /v1/catalog/entries/bulk`                |
| List all catalog allowances           | `GET /v1/catalog/allowances`                   |
| Create a new catalog allowance        | `POST /v1/catalog/allowances`                  |
| Update a catalog allowance            | `PATCH /v1/catalog/allowances/{id}`            |
| Bulk create or update allowances      | `POST /v1/catalog/allowances/bulk`             |
| List all catalog variances            | `GET /v1/catalog/variances`                    |
| Retrieve invoice items for a variance | `GET /v1/catalog/variances/{id}/invoice-items` |

See [Catalog](/api-reference/api-reference/catalog/) in the API reference for usage and examples.

---

### Dimensions API

Manage accounting dimensions such as cost centers, departments, and custom attributes.

| Task                             | Endpoint                   |
| -------------------------------- | -------------------------- |
| List all dimensions              | `GET /v1/dimensions`       |
| Create a new dimension           | `POST /v1/dimensions`      |
| Retrieve a specific dimension    | `GET /v1/dimensions/{id}`  |
| Bulk create or update dimensions | `POST /v1/dimensions/bulk` |

See [Dimensions](/api-reference/api-reference/dimensions/) in the API reference for usage and examples.

---

### Invoices API

Submit, manage, and process invoices and related approval workflows.

| Task                                 | Endpoint                             |
| ------------------------------------ | ------------------------------------ |
| List all invoices                    | `GET /v1/invoices`                   |
| Create a new invoice                 | `POST /v1/invoices`                  |
| Upload invoice files for extraction  | `POST /v1/invoices/upload`           |
| Retrieve a specific invoice          | `GET /v1/invoices/{id}`              |
| Update invoice details               | `PATCH /v1/invoices/{id}`            |
| Mark invoices as exported            | `POST /v1/invoices/mark-exported`    |
| Mark invoices as unexported          | `POST /v1/invoices/mark-unexported`  |
| Get status of uploaded invoice files | `GET /v1/invoices/uploads`           |
| List approvers for an invoice        | `GET /v1/invoices/{id}/approvers`    |
| Add approvers to an invoice          | `POST /v1/invoices/{id}/approvers`   |
| Remove approvers from an invoice     | `DELETE /v1/invoices/{id}/approvers` |
| Approve an invoice                   | `POST /v1/invoices/{id}/approve`     |
| Flag an invoice for review           | `POST /v1/invoices/{id}/flag`        |

See [Invoices](/api-reference/api-reference/invoices/) in the API reference for usage and examples.

---

### OAuth API

Authenticate and obtain access tokens for API requests.

| Task                        | Endpoint               |
| --------------------------- | ---------------------- |
| Generate OAuth access token | `POST /v1/oauth/token` |

See [OAuth](/api-reference/api-reference/o-auth/) in the API reference for usage and examples.

---

### Payments API

Create and track vendor payments.

| Task                       | Endpoint                                |
| -------------------------- | --------------------------------------- |
| Create a payments vendor   | `POST /v1/payments/vendor`              |
| Retrieve a payments vendor | `GET /v1/payments/vendor/{id}`          |
| Create a payment           | `POST /v1/payments/payment`             |
| Retrieve a payment         | `GET /v1/payments/payment/{id}`         |
| Cancel a payment           | `POST /v1/payments/payment/{id}/cancel` |

See [Payments](/payments) for the integration guide, and [Payments](/api-reference/api-reference/payments/) in the API reference for usage and examples.

---

### Vendors API

Manage vendor information and relationships.

| Task                          | Endpoint                |
| ----------------------------- | ----------------------- |
| List all vendors              | `GET /v1/vendors`       |
| Create a new vendor           | `POST /v1/vendors`      |
| Retrieve a specific vendor    | `GET /v1/vendors/{id}`  |
| Bulk create or update vendors | `POST /v1/vendors/bulk` |

See [Vendors](/api-reference/api-reference/vendors/) in the API reference for usage and examples.

#### Upcoming Features

### Planned Enhancements

We're continuously working on expanding the Ottimate API. Here are some areas we're exploring:

#### Q2 2026 (Under Development)

* Web-hook Support for Real-time Events

#### Q3 2026 (Planned)

* Statements API
* Fine Grained Scope Management
* More Actions APIs
* TypeScript SDK

> **Note**
>
> Roadmap items are subject to change based on partner feedback and business priorities. Reach out to [api-support@ottimate.com](mailto:api-support@ottimate.com) to discuss your integration needs and influence our roadmap.