> ## Documentation Index > Fetch the complete documentation index at: https://developers.datagrid.com/llms.txt > Use this file to discover all available pages before exploring further. # List consumption breakdown > Return Control Tower teamspace/organization credit consumption rows for the authenticated organization. The date window is measured in UTC calendar days and must not exceed 90 days. A date-only `start_date` begins at UTC midnight and a date-only `end_date` covers that whole UTC day. Pagination uses opaque `after` / `before` cursors from `first_id` / `last_id`. The cursors encode a position in the result set, not a record id, so rows written between two page requests can shift the window. Dollar `amount` is not included. ## OpenAPI ````yaml get /organization/reports/consumption-breakdown openapi: 3.0.3 info: version: 0.1.1 title: Datagrid API description: Datagrid API servers: - url: https://api.datagrid.com/v1 security: - BearerAuth: [] paths: /organization/reports/consumption-breakdown: get: tags: - Credits summary: List consumption breakdown description: | Return Control Tower teamspace/organization credit consumption rows for the authenticated organization. The date window is measured in UTC calendar days and must not exceed 90 days. A date-only `start_date` begins at UTC midnight and a date-only `end_date` covers that whole UTC day. Pagination uses opaque `after` / `before` cursors from `first_id` / `last_id`. The cursors encode a position in the result set, not a record id, so rows written between two page requests can shift the window. Dollar `amount` is not included. operationId: ListConsumptionBreakdown parameters: - name: start_date in: query required: true description: >- Inclusive start of the report window (ISO 8601 date or date-time). Date-only values are UTC midnight. schema: type: string format: date-time - name: end_date in: query required: true description: >- Inclusive end of the report window (ISO 8601 date or date-time). A date-only value covers that entire UTC day; a date-time is used exactly as given. schema: type: string format: date-time - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/after' - $ref: '#/components/parameters/before' responses: '200': description: Consumption breakdown rows content: application/json: schema: $ref: '#/components/schemas/ConsumptionBreakdownList' '400': description: >- Bad request. The date window is invalid or longer than 90 UTC calendar days, or the pagination cursor is invalid. '404': description: >- Not found. The authenticated caller does not have permission to read Control Tower reports for this organization. '429': description: >- Rate limit exceeded. The request has been throttled because the rate limit for this endpoint has been reached. Check the `Retry-After` response header and retry after the specified number of seconds. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' components: parameters: limit: name: limit in: query schema: type: integer default: 50 minimum: 1 maximum: 100 required: false description: The limit on the number of objects to return, ranging between 1 and 100. after: name: after in: query schema: type: string required: false description: >- A cursor to use in pagination. `after` is an object ID that defines your place in the list. For example, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `after=obj_foo` to fetch the next page of the list. before: name: before in: query schema: type: string required: false description: >- A cursor to use in pagination. `before` is an object ID that defines your place in the list. For example, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `before=obj_bar` to fetch the previous page of the list. schemas: ConsumptionBreakdownList: type: object required: - object - data - has_more - first_id - last_id properties: object: type: string enum: - list description: The object type, always 'list'. data: type: array items: $ref: '#/components/schemas/ConsumptionBreakdown' description: Consumption breakdown rows for this page. has_more: type: boolean description: Whether additional rows exist after this page. first_id: type: string nullable: true description: >- Opaque cursor for the first row on this page, or null when the page is empty. last_id: type: string nullable: true description: >- Opaque cursor for the last row on this page, or null when the page is empty. RateLimitError: type: object description: >- Returned when the rate limit is exceeded. Rate limits are enforced per teamspace, endpoint path, and HTTP method over a 60-second sliding window. Each endpoint may have its own limit — check the X-RateLimit-Limit response header for the effective value. required: - error - message - retryable - status_code properties: status_code: type: integer description: The HTTP status code (429). statusCode: type: integer deprecated: true description: Deprecated. Use status_code instead. error: type: string enum: - rate_limit_exceeded description: The error code identifying this as a rate limit error. message: type: string description: A human-readable error message. mitigation: type: string description: Suggested action to resolve the error. retryable: type: boolean description: Whether the request can be retried after a delay. details: type: object properties: reason: type: string description: A detailed explanation of why the rate limit was exceeded. ConsumptionBreakdown: type: object required: - object - credits - created_at - action - organization properties: object: type: string enum: - consumption_breakdown description: Object type discriminator. credits: type: number description: >- Credits consumed by this row. Fractional — the row is a sum of decimal ledger amounts. created_at: type: string format: date-time description: When the consumption occurred. action: type: string description: Human-readable action or service label. organization: type: string description: Consumer organization (teamspace) name. resource: type: string description: Optional resource associated with the consumption. resource_type: type: string description: Optional resource type associated with the consumption. credit_source: type: string description: Labelled source of the credits (for example a recurring invoice). securitySchemes: BearerAuth: type: http scheme: bearer ````