# UsageReport

> The UsageReport object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `from` * | string (date-time) |  |
| `to` * | string (date-time) |  |
| `granularity` * | `hour`, `day` |  |
| `rows` * | array of [UsageRow](/docs/api/objects/usage-row/) |  |
| `next_cursor` | string or null |  |

\* always present

## Example

```json
{
  "from": "2026-10-22T13:05:00Z",
  "to": "2026-10-22T13:05:00Z",
  "granularity": "hour",
  "rows": [
    {
      "start": "2026-10-22T13:05:00Z",
      "environment_id": "string",
      "service_id": "string",
      "subject": {
        "type": "service",
        "id": "svc_01jbx2m9k7q4r8t5v6w3y0z1sv",
        "name": "web",
        "url": "/v1/projects/primecarers/services/web"
      },
      "metric": "vcpu_seconds",
      "quantity": "string",
      "unit": "string",
      "cost": {
        "amount": "7.42",
        "currency": "GBP",
        "display": "£7.42"
      }
    }
  ],
  "next_cursor": "string"
}
```

## Used by

- [Raw usage rows with cost](/docs/api/spend/#raw-usage-rows-with-cost)