# Get Usage

GET /api/v2/projects/{projectId}/analytics/usage

Returns metered spend for the project over a date window, broken down by day, app, and upstream service. This is the cost side of the ledger. See Get Balance Transactions for how that spend drew down the credit balance.

## Request

- projectId: string, path, required — ID of the project to report usage for.
- dateFrom: string, query — Start of the window as a `YYYY-MM-DD` date, inclusive and read in UTC.
- dateTo: string, query — End of the window as a `YYYY-MM-DD` date, inclusive and read in UTC.

## Response

- 200: Successful response
  - data: object[], required
    - app: string, required
    - cost: number, required
    - date: string, required
    - service: string, required
  - meta: object[], required
    - name: string, required
    - type: string, required
  - rows: number, required
  - statistics: object, required
    - bytes_read: number, required
    - elapsed: number, required
    - rows_read: number, required
  - usage: object, required
    - cost: number, required
    - duration: number
    - metricCount: number
- 400: Invalid input data
- 401: Authorization not provided
- 403: Insufficient access
- 404: Not found
- 500: Internal server error