Marrow
Docs Log in Sign up

Usage And Credits

Marrow shows account usage in the console and returns usage headers from API requests. Use this page to understand what changes your balance, where to check remaining credits, and how to handle quota or credit errors.

Where To Check Usage

Open console.marrow.id and use the Usage tab. It shows:

  • monthly credits remaining;
  • onboarding credits remaining;
  • total credits remaining;
  • recent ingest jobs;
  • recent account activity.

Direct HTTP integrations can read the same account summary:

marrow api usage

The command returns a human-readable summary by default and supports --json for integrations.

Direct HTTP integrations can use the account usage endpoint:

GET /v1/account/usage
Authorization: Bearer <API key>

The response includes credits, quota counters, recent ledger rows, and 30 UTC daily usage buckets:

{
  "schemaVersion": "marrow-account-usage-v1",
  "credits": {
    "balance": {
      "totalRemaining": 349
    },
    "monthly": {
      "remaining": 99,
      "resetAt": "2026-06-01T00:00:00.000Z"
    },
    "onboarding": {
      "remaining": 250
    }
  }
}

What Uses Credits

Queries cost 1 credit. Ingest costs vary when Marrow distills source material, because the amount of source text and processing work can differ by file or URL.

Monthly credits are used before onboarding credits. The monthly balance resets at the start of the account's current monthly period. Onboarding credits are a one-time balance for initial setup.

API Headers

Successful query responses and credit-related errors include usage headers:

x-marrow-credit-source: query
x-marrow-credit-cost: 1
x-marrow-credit-remaining: 349
x-marrow-credit-monthly-remaining: 99
x-marrow-credit-onboarding-remaining: 250
x-marrow-credit-monthly-period: 2026-05-01

Live ingest jobs also count against ingest queue quotas. Queue responses include quota headers when a live job is accepted:

x-marrow-quota-metric: ingest
x-marrow-quota-daily-limit: 50
x-marrow-quota-daily-remaining: 49
x-marrow-quota-monthly-limit: 200
x-marrow-quota-monthly-remaining: 199

Credit And Quota Errors

If credits run out, query or ingest returns account_credits_exhausted and no additional model request is made.

If the ingest queue quota is exhausted, live ingest returns account_quota_exceeded. Wait for the next reset or reduce queued ingest work before retrying.

Per-key request rate limits return rate_limited. The response includes standard retry headers when available.

  1. Create an account in the console.
  2. Create or copy an API key from the API keys tab.
  3. Install and configure the CLI.
  4. Add one representative source.
  5. Query evidence after ingest succeeds.
  6. Monitor usage in the console or with marrow api usage.