FurniOpsDocs
API referenceBilling

Read the credit rate card

What each model Ask AI uses costs at list price today, and how many of its tokens one credit (1¢) and one dollar buy, worked out from the dated prices; with the rates already set for later (a rise is announced 30 days ahead). Every member may read it.

  • Scopesnone
  • Rate classread
GET/v1/billing/credits/rates

What each model Ask AI uses costs at list price today, and how many of its tokens one credit (1¢) and one dollar buy, worked out from the dated prices; with the rates already set for later (a rise is announced 30 days ahead). Every member may read it.

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
If-None-Match?string

ETag of a cached representation; a match returns 304

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/billing/credits/rates"
{  "object": "credit_rate_card",  "currency": "usd",  "micros_per_credit": 10000,  "day": "2019-08-24",  "models": [    {      "from": "2019-08-24",      "input_per_m_micros": 0,      "cached_input_per_m_micros": 0,      "output_per_m_micros": 0,      "tokens_per_credit": {        "input": 0,        "cached_input": 0,        "output": 0      },      "tokens_per_usd": {        "input": 0,        "output": 0      },      "model": "string",      "provider": "google",      "upcoming": [        {          "from": "2019-08-24",          "input_per_m_micros": 0,          "cached_input_per_m_micros": 0,          "output_per_m_micros": 0,          "tokens_per_credit": {            "input": 0,            "cached_input": 0,            "output": 0          },          "tokens_per_usd": {            "input": 0,            "output": 0          }        }      ]    }  ]}

Retrieve a credit purchase GET

One purchase. After the browser confirms the payment, poll it until `status` is `succeeded` (the credit is in) or `failed` (pay again with the same purchase).

List credit entries GET

The credit ledger, newest first: purchases, staff grants, Ask AI spend (per member, never what they asked), refunds, disputes and expiry, each with the balance after it. Filter by `kind` and time.