---
title: "Batch Rates"
method: POST
path: "/v2/tms-api/batch/rates"
tags: ["TMS API", "TMS API - Batch Operations"]
---

# Batch Rates

`POST /v2/tms-api/batch/rates`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/tms-api/batch/rates`
- Auth: none declared

Create or upsert customer-supplied market rate snapshots in bulk.

## Headers

- `X-API-Key` string, nullable: API key for authentication

## Request body

- BatchMarketRateRequest
  - `items` BatchMarketRateItem[], required: Market rate snapshots to create or upsert
    - `data` object, required

## Response `200`

Successful Response

- BatchResponse: Response for batch operations.
  - `success_count` integer, required: Number of successful operations
  - `error_count` integer, required: Number of failed operations
  - `results` BatchResultItem[], required: Results for each item
    - `external_reference_id` string, required: External reference ID of the item
    - `operation` 'create' | 'update' | 'upsert' | 'delete', required: Batch operation types.
    - `success` boolean, required: Whether the operation succeeded
    - `id` string, nullable: ID of created/updated entity
    - `error` string, nullable: Error message if failed
    - `error_code` string, nullable: Error code (e.g., DUPLICATE, NOT_FOUND)

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)