Download OpenAPI Spec
Home
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Beta Admin Billing Endpoints

(beta) Admin API - manage spend limits, rate limits and roles. Requires an admin API key.

Get Rate Limits

GET /v1/admin/rate-limit#

Get Rate Limits

200

OK

requests_per_second#
*integer

Maximum API requests allowed per second.

tokens_limits_by_model#
*map<TokenLimitsByModel>

Token limits for each model.

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/admin/rate-limit \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "requests_per_second": 87,
  "tokens_limits_by_model": [
    {
      "tokens_per_minute": 14,
      "tokens_per_month": 56
    }
  ]
}

Get Spend Limits

GET /v1/admin/spend-limit#

Get usage, rate, and job limits for the Organization.

200

OK

limits#
*LimitsContext

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/admin/spend-limit \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "limits": {
    "completion": {
      "monthly_limit_reached": false
    },
    "currency": "USD",
    "last_payment_failure": false,
    "last_payment_failure_protection": null
  }
}

Update Spend Limits

POST /v1/admin/spend-limit#

Update the Organization usage limit.

200

OK

limits#
*LimitsContext

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/admin/spend-limit \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "amount": 87
}'

200

{
  "limits": {
    "completion": {
      "monthly_limit_reached": false
    },
    "currency": "USD",
    "last_payment_failure": false,
    "last_payment_failure_protection": null
  }
}

Get Usage

GET /v1/admin/usage#

Get usage and cost data for the Organization.

200

OK

audio#
*BasicModelUsageDataJSON
audio_characters#
*BasicModelUsageDataJSON
chat#
*BasicModelUsageDataJSON
completion#
*BasicModelUsageDataJSON
connectors#
*BasicModelUsageDataJSON
currency#
*string|null

Currency used for usage prices.

currency_symbol#
*string|null

Currency symbol used for usage prices.

date#
*date-time

Reference date for the usage period.

end_date#
*date-time

End of the usage period.

fine_tuning#
*FineTuningDataJSON
libraries_api#
*LibrariesAPIUsageDataJSON
next_month#
*string|null

Next month in the usage report.

ocr#
*BasicModelUsageDataJSON
previous_month#
*string|null

Previous month in the usage report.

prices#
*array<PriceData>|null

Prices used to calculate usage amounts.

start_date#
*date-time

Start of the usage period.

vibe_usage#
*number

Current Vibe usage amount.

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/admin/usage \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "audio": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "audio_characters": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "chat": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "completion": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "connectors": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "currency": null,
  "currency_symbol": null,
  "date": "2025-12-17T10:25:07.818693Z",
  "end_date": "2025-12-17T10:25:07.818693Z",
  "fine_tuning": {
    "storage": [
      87
    ],
    "training": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "libraries_api": {
    "audio_seconds": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    },
    "pages": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    },
    "tokens": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    }
  },
  "next_month": null,
  "ocr": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "previous_month": null,
  "prices": null,
  "start_date": "2025-12-17T10:25:07.818693Z",
  "vibe_usage": 14
}