> ## Documentation Index > Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # List daily usage > List daily deployment resource cost data synced from the org's Sigma cost breakdown export. Enterprise+ tier only. ## OpenAPI ````yaml /astro/api/v-1-labs/openapi.yaml get /organizations/{organizationId}/billing/daily-usage openapi: 3.0.3 info: contact: {} description: Astro Labs API - Experimental endpoints for preview features title: Astro Labs API version: v1 servers: - url: https://api.astronomer.io/labs/v1 security: - JWT: [] tags: - description: >- Canned-data placeholder used to exercise the labs epoch versioning surface. Real labs endpoints register their own tags. name: Example - name: allowed-ip-address-range x-group: Allowed IP Address Range paths: /organizations/{organizationId}/billing/daily-usage: get: tags: - Billing summary: List daily usage description: >- List daily deployment resource cost data synced from the org's Sigma cost breakdown export. Enterprise+ tier only. operationId: LabsListDailyUsage parameters: - description: The ID of the Organization to retrieve cost data for. in: path name: organizationId required: true schema: type: string - description: Start of the date range (YYYY-MM-DD). in: query name: startDate required: true schema: type: string - description: >- End of the date range (YYYY-MM-DD). Range must not exceed 12 months. in: query name: endDate required: true schema: type: string - description: Filter by workspace ID. At most 1000. in: query name: workspaceId schema: items: type: string type: array - description: Filter by deployment ID. At most 1000. in: query name: deploymentId schema: items: type: string type: array - description: Response shape. in: query name: format schema: default: astronomer enum: - astronomer - focus type: string - description: The number of results to skip before returning values. in: query name: offset schema: default: 0 minimum: 0 type: integer - description: The maximum number of results to return. in: query name: limit schema: default: 20 maximum: 1000 minimum: 0 type: integer - description: >- Fields to sort by, formatted as `:asc` or `:desc`. in: query name: sorts schema: items: type: string type: array responses: '200': content: application/json: schema: $ref: '#/components/schemas/DailyUsageVariants' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/Error' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/Error' description: Forbidden '500': content: application/json: schema: $ref: '#/components/schemas/Error' description: Internal Server Error security: - JWT: [] components: schemas: DailyUsageVariants: discriminator: mapping: astronomer: $ref: '#/components/schemas/DailyUsagesPaginated' focus: $ref: '#/components/schemas/FocusDailyUsagesPaginated' propertyName: format oneOf: - $ref: '#/components/schemas/DailyUsagesPaginated' - $ref: '#/components/schemas/FocusDailyUsagesPaginated' type: object Error: properties: fieldErrors: description: >- FieldErrors carries one entry per failed request-validation constraint. Only present on 400 responses caused by request binding/validation. items: $ref: '#/components/schemas/FieldValidationError' type: array message: type: string requestId: type: string statusCode: maximum: 600 minimum: 400 type: integer required: - message - requestId - statusCode type: object DailyUsagesPaginated: title: astronomer properties: format: description: >- Discriminates this response from FocusDailyUsagesPaginated when both are valid oneOf variants (e.g. an empty items page). enum: - astronomer - focus example: astronomer type: string items: description: The list of deployment resource costs in the current page. items: $ref: '#/components/schemas/DailyUsage' type: array limit: description: The maximum number of results in one page. example: 20 type: integer offset: description: The offset of the current page of results. example: 0 type: integer totalCount: description: >- The total number of deployment resource cost rows matching the query. example: 15196 type: integer required: - format - items - limit - offset - totalCount type: object FocusDailyUsagesPaginated: title: focus properties: format: description: >- Discriminates this response from DailyUsagesPaginated when both are valid oneOf variants (e.g. an empty items page). enum: - astronomer - focus example: focus type: string items: description: >- The list of deployment resource costs in the current page, in FOCUS format. items: $ref: '#/components/schemas/FocusDailyUsage' type: array limit: description: The maximum number of results in one page. example: 20 type: integer offset: description: The offset of the current page of results. example: 0 type: integer totalCount: description: >- The total number of deployment resource cost rows matching the query. example: 15196 type: integer required: - format - items - limit - offset - totalCount type: object FieldValidationError: properties: code: type: string field: type: string message: type: string required: - code - field - message type: object DailyUsage: properties: clusterId: description: The ID of the cluster the Deployment runs on. example: clpirf9ep03c701omoxq4gjkd type: string clusterName: description: The name of the cluster the Deployment runs on. example: AWS us-east-1 type: string cost: description: The cost incurred, in USD. example: 0.35 type: number date: description: The day this cost row covers, in UTC. example: '2026-06-05' type: string deploymentDescription: description: The description of the Deployment the cost was incurred by. type: string deploymentId: description: The ID of the Deployment the cost was incurred by. example: cmoln7wql2ktt01kxjpznlek2 type: string deploymentName: description: The name of the Deployment the cost was incurred by. example: timo-re-dnd type: string isHostedDedicated: description: Whether the Deployment runs on Hosted Dedicated infrastructure. example: true type: boolean organizationId: description: The ID of the Organization the cost was incurred by. example: cl17wsdpe084o0rw3e46g3smn type: string organizationName: description: The name of the Organization the cost was incurred by. example: Cosmic Energy type: string qty: description: The quantity of the resource consumed. example: 3600 type: number resource: description: The billed resource (e.g. scheduler size, worker size). example: Small Scheduler type: string unit: description: The unit the quantity is measured in. example: runtime seconds type: string workspaceDescription: description: The description of the Workspace the cost was incurred by. type: string workspaceId: description: The ID of the Workspace the cost was incurred by. example: cm7f419mg0no001jhunzjeer1 type: string workspaceName: description: The name of the Workspace the cost was incurred by. example: Sandbox type: string yearMonth: description: The calendar month this cost row falls in, in UTC. example: 2026-06 type: string required: - cost - date - deploymentId - organizationId - qty - resource - unit - workspaceId - yearMonth type: object FocusDailyUsage: properties: billingAccountId: description: The ID of the Organization being billed. example: cl17wsdpe084o0rw3e46g3smn type: string billingAccountName: description: The name of the Organization being billed. example: Cosmic Energy type: string chargeCategory: description: The FOCUS charge category. example: Usage type: string chargeFrequency: description: The FOCUS charge frequency. example: Usage-Based type: string chargePeriodEnd: description: End of the charge period (exclusive), in UTC. format: date-time type: string chargePeriodStart: description: Start of the charge period, in UTC. format: date-time type: string consumedQuantity: description: The quantity of the resource consumed. example: 3600 type: number consumedUnit: description: The unit the consumed quantity is measured in. example: runtime seconds type: string invoiceIssuerName: description: The entity that issues the invoice for the charge. example: Astronomer type: string listCost: description: The list cost incurred, in USD. example: 0.35 type: number providerName: description: The cloud/software provider billing the charge. example: Astronomer type: string publisherName: description: The publisher of the billed service. example: Astronomer type: string resourceId: description: >- Comma-separated cluster ID and Deployment ID the charge was incurred by. example: clpirf9ep03c701omoxq4gjkd,cmoln7wql2ktt01kxjpznlek2 type: string resourceName: description: >- Comma-separated cluster name and Deployment name the charge was incurred by. example: AWS us-east-1,timo-re-dnd type: string resourceType: description: The FOCUS resource types the charge spans. example: Cluster,Deployment type: string serviceCategory: description: The FOCUS service category. example: Compute type: string serviceName: description: The name of the billed service. example: Astro type: string serviceSubCategory: description: The FOCUS service sub-category. example: Data Orchestration type: string skuId: description: A slugified identifier for the billed resource. example: small-scheduler type: string subAccountId: description: The ID of the Workspace the charge was incurred by. example: cm7f419mg0no001jhunzjeer1 type: string subAccountName: description: The name of the Workspace the charge was incurred by. example: Sandbox type: string required: - billingAccountId - chargeCategory - chargeFrequency - chargePeriodEnd - chargePeriodStart - consumedQuantity - consumedUnit - invoiceIssuerName - listCost - providerName - publisherName - resourceId - resourceType - serviceCategory - serviceName - serviceSubCategory - skuId - subAccountId type: object securitySchemes: JWT: scheme: bearer type: http ````