# List UsageRecords

**GET /v1/UsageRecords**

List UsageRecords
Usage information for Sim resources

## Servers
- https://supersim.twilio.com: https://supersim.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters


### Query parameters
- **Sim** (string)
  SID or unique name of a Sim resource. Only show UsageRecords representing usage incurred by this Super SIM.
- **Fleet** (string)
  SID or unique name of a Fleet resource. Only show UsageRecords representing usage for Super SIMs belonging to this Fleet resource at the time the usage occurred.
- **Network** (string)
  SID of a Network resource. Only show UsageRecords representing usage on this network.
- **IsoCountry** (string(iso-country-code))
  Alpha-2 ISO Country Code. Only show UsageRecords representing usage in this country.
- **Group** (string)
  Dimension over which to aggregate usage records. Can be: `sim`, `fleet`, `network`, `isoCountry`. Default is to not aggregate across any of these dimensions, UsageRecords will be aggregated into the time buckets described by the `Granularity` parameter.
- **Granularity** (string)
  Time-based grouping that UsageRecords should be aggregated by. Can be: `hour`, `day`, or `all`. Default is `all`. `all` returns one UsageRecord that describes the usage for the entire period.
- **StartTime** (string(date-time))
  Only include usage that occurred at or after this time, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. Default is one month before the `end_time`.
- **EndTime** (string(date-time))
  Only include usage that occurred before this time (exclusive), specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. Default is the current time.
- **PageSize** (integer(int64))
  How many resources to return in each list page. The default is 50, and the maximum is 1000.
- **Page** (integer)
  The page index. This value is simply for client state.
- **PageToken** (string)
  The page token. This is provided by the API.


## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **usage_records** (array[object])

- **meta** (object)



[Powered by Bump.sh](https://bump.sh)