---
title: "Get Developer billing"
method: GET
path: "/v1/billing/developer"
tags: ["Billing"]
---

# Get Developer billing

`GET /v1/billing/developer`

## Request

- Base URL: `https://api.recruitmcp.com`
- URL: `https://api.recruitmcp.com/v1/billing/developer`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://recruitmcp.com/oauth/authorize`, token URL `https://recruitmcp.com/oauth/token`, scopes: `account:read`)

Spending limit and current-period metered usage. 404 feature_disabled when Developer billing is off for this deployment. Account keys only.

Scope: `account:read`. Acts on the account; keys bound to a customer are refused.

## Headers

- `RecruitMCP-Version` '2026-10-13'

## Response `200`

Developer billing.

- DeveloperBilling
  - `object` 'developer_billing', required
  - `status` 'inactive' | 'active' | 'suspended' | 'ending' | 'ended', required
  - `spend_limit_eur` integer, required: Customer monthly limit in euros.
  - `effective_limit_eur` number, required: Limit that applies now, after the first-cycle cap and the server ceiling.
  - `min_spend_limit_eur` integer
  - `max_spend_limit_eur` integer
  - `usage_credits` number, required: Metered credits in the current period.
  - `usage_eur` number, required: Metered euros in the current period.
  - `period_start` string, date-time, nullable
  - `period_end` string, date-time, nullable
  - `first_invoice_paid` boolean, required
  - `card_on_file` boolean, required
  - `suspended_reason` string, nullable
  - `price_eur_per_credit` number, required

## Other responses

- `400`: `unsupported_version` (do not retry): RecruitMCP-Version is not a supported version.
- `401`: `unauthorized` (do not retry): Missing bearer API key.
- `403`: `forbidden` (do not retry): This route acts on the account. Keys bound to a customer cannot use it. `insufficient_scope` (do not retry): This key does not include the scope this endpoint requires.
- `404`: `feature_disabled` (do not retry): Developer billing is not enabled.
- `409`: `conflict` (do not retry): The resource is in a state that refuses this change.
- `429`: `rate_limited` (retry): Per-key rate limit exceeded.

## Changes

- **2026-10-20** `ad27b35513a6`: 6 warning
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `400`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `401`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `403`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `404`
  - …2 more

[Operation history](https://skmtc.dev/recruitmcp/apis/recruitmcp-api/changes/v1/billing/developer/get.md)

---

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