After OpenAI linked ChatGPT Pro and Business API credits to one organization on October 28, how should you reconcile Responses usage JSON with Credit grants?

As of 2 November 2026: Pro tiers up to $500/month, Business seats pooled and capped at $500. One org link, same email, owner activation. Promotional credits before purchased; usage JSON is not grant balance.

As of 28 October 2026, eligible ChatGPT Pro and Business subscriptions can link a subscription API credit grant to one API Organization you own—up to $500 per month on Pro tiers, or pooled Business seats capped at $500 per workspace. Credits land only in that linked org. They do not raise ChatGPT chat limits, Business workspace usage credits, or Codex usage billed through API keys. Promotional API credits spend before purchased credits; unused grant balance does not roll over at cycle end. Usage JSON in API responses is not the same dataset as Credit grants on the Billing page.

This article is dated 2 November 2026, from the developer guide “API credits for ChatGPT subscribers”, Help Center article 20001626, and the 28 October API changelog. Three days ago we covered Claude 128 MB and Usage Cost Analytics. That was Admin billing rows; here you are modeling OpenAI org grants separately from Responses usage.

How monthly amounts are calculated

Pro maps to $100, $200, or $500 per full monthly period. Business pools $20 per paid Standard seat and $100 per paid Premium seat, then applies a $500 per workspace monthly cap. Annual prepaid Business workspaces receive the full-year grant upfront, capped at $6,000 for the annual cycle.

SubscriptionFull-period API credits (USD)
Pro $100 tier100 / month
Pro $200 tier200 / month
Pro $500 tier500 / month
Business Standard (per paid seat)20, pooled
Business Premium (per paid seat)100, pooled
Business workspace cap500 / month

First activation mid-cycle is prorated for the remaining paid term. Confirm the amount shown in ChatGPT billing before you accept.

One-to-one link and eligibility

  • Paid Pro or Business for at least seven days; free trials and Plus do not qualify.
  • You must own both the ChatGPT subscription or Business workspace and the receiving API Organization.
  • ChatGPT and the API account used to link must share the same email.
  • One eligible subscription or workspace links to one org; one org has only one active link of this kind.

Activate from ChatGPT or API Platform

Either path links the same benefit: Pro billing in ChatGPT Settings, or Business workspace billing; alternatively API Platform → your org → Billing → select the eligible subscription. Renewals grant automatically while the benefit and eligibility remain in force—no monthly re-claim.

Billing JSON: usage vs credit grants

Responses and Chat Completions still return per-request usage token fields. That JSON measures activity; grant balances deduct at the organization layer.

{
  "usage": {
    "input_tokens": 1240,
    "output_tokens": 380,
    "input_tokens_details": {"cached_tokens": 900}
  }
}

Split FinOps models: Usage Dashboard/API for activity (including cache fields in 12h prompt cache usage); Billing → Credit grants for promotional balance and expiry. Promotional credits consume before purchased credits.

What API spend is covered

Linked-org billed usage includes Responses, Chat Completions, Agents, Decisions, realtime, images, and applicable tool/storage charges per the developer guide. It excludes Codex through API keys and does not increase in-app ChatGPT limits.

Running out, rate limits, negative balance

An active grant can work without an API payment method. Credits do not remove RPM/TPM or model limits. Exhausted balances can yield 429-style errors. Prepaid balances may lag; short negative balances can appear and net against the next purchase—do not treat usage JSON as a real-time spend gate.

FAQ

Can Pro API credits pay for ChatGPT chat?

No. They apply only to the linked API Organization.

Can one org link two Business workspaces?

No. One active link per org and one linked org per eligible subscription or workspace.

Why doesn’t usage JSON match Billing?

Usage counts tokens; grants track promotional balance. Activity cost is not the same as cash after credits.

Why is my first grant below $500?

Mid-cycle activation is prorated for the remaining billing period.

Do unused grant credits roll over?

No. They expire at the end of the subscription billing cycle (or annual cycle for upfront Business).

Must I buy prepaid credits before claiming?

No. An active promotional grant is enough to call the API; purchased credits are optional.

Summary

28 October adds subscription-linked promotional grants to a single API org—not a change to Responses usage shape. Model grant metadata separately from usage JSON, verify ownership and email alignment, then run paid API paths such as Agents and Decisions on the linked org.