{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Returns cost and usage data for all accounts within an organization,\naligned with the [FinOps FOCUS v1.3](https://focus.finops.org/focus-specification/v1-3/)\nCost and Usage dataset specification.\n\nEach record represents one billable metric for one account on one day.\nThis includes all metered usage, including usage that falls within\nfree-tier allowances and may result in zero cost. The response\nincludes usage for every account belonging to the specified\norganization.\n\n**Note:** This endpoint serves `usage` records only; cost and pricing\nfields are absent from responses. Rated costs are available per\naccount via `POST /accounts/{account_id}/billable/usage` with\n`Metric: cost`.\n\nWhen `from` and `to` are omitted, defaults to the start of the current\nmonth through today. The maximum date range is 31 days.\n\nAn organization with no accounts, or an organization ID that does not\nexist, returns a successful response with an empty result set rather\nthan an error.\n","properties":{"path":{"type":"object","properties":{"organization_id":{"$ref":"#/definitions/billable-usage-api_identifier","description":"Identifies the Cloudflare organization."}},"required":["organization_id"],"additionalProperties":false},"query":{"type":"object","properties":{"from":{"type":"string","format":"date","examples":["2025-05-01"],"description":"Start date for the usage query (ISO 8601). Required if `to` is set. When omitted along with `to`, defaults to the start of the current month. Filters by charge period (when consumption happened), not billing period. The maximum date range is 31 days."},"to":{"type":"string","format":"date","examples":["2025-05-31"],"description":"End date for the usage query (ISO 8601). Required if `from` is set. When omitted along with `from`, defaults to today. Filters by charge period (when consumption happened), not billing period. The maximum date range is 31 days."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false,"definitions":{"billable-usage-api_identifier":{"description":"Represents a Cloudflare resource identifier tag.","type":"string","maxLength":32,"pattern":"^[0-9a-f]{32}$","examples":["023e105f4ecef8ad9ca31a8372d0c353"]}}},"name":"Get Organization Usage (Version 2, Alpha, Restricted)","id":"cloudflare.billable-usage-v2-get-organization-usage","example":{"path":{"organization_id":"023e105f4ecef8ad9ca31a8372d0c353"}},"maxRequests":1,"summary":false}}