---
title: "Returns the request throughput information for an account, can be further filtered."
method: GET
path: "/v1/accounts/{accountSid}/metrics/throughput"
tags: ["Metrics"]
---

# Returns the request throughput information for an account, can be further filtered.

`GET /v1/accounts/{accountSid}/metrics/throughput`

## Request

- Base URL: `https://api.apitraffic.io`
- URL: `https://api.apitraffic.io/v1/accounts/{accountSid}/metrics/throughput`
- Auth: none declared
- TypeScript: <https://skmtc.dev/apitraffic/apis/apitraffic-api-documentation/docs/v1/accounts/:accountSid/metrics/throughput/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `accountSid` string, required: accountSid

## Query parameters

- `startTime` string, required: The start date/time for the data that should be returned.
- `endTime` string, required: The end date/time for the data that should be returned.
- `environmentSid` string, required: Sid of the environment
- `bucketSid` string: A BucketSid to filter the data by.
- `apiSid` string: An ApiSid to filter the data by.
- `pathSid` string: A PathSid to filter the data by.
- `resolution` '1min' | '10min' | '1hr' | '2hr' | '1d' | '1mo': The resolution that the data should be grouped and returned in.
- `units` 'rps' | 'rpm': Return metric as requests per second (rps) or requests per minute (rpm).

## Response `200`

The data structure that throuput data be reported back with.

- ThroughputResponse: The data structure that throuput data be reported back with.
  - `summary` Model10, required
    - `startTime` string, required: The start date/time for the period.
    - `endTime` string, required: The end date/time for the period.
    - `averageUnits` 'rps' | 'rpm', required: Returning metric as requests per second (rps) or requests per minute (rpm)
    - `total` Model4: Metric for the total number of requests across all HTTP statuses.
      - `count` number, required: The request count.
      - `average` number, required: The average number of requests per unit.
    - `httpStatus` Model9: The data structure that throuput data be reported back with.
      - `200` Model5: Metrics for requests in the 200 HTTP status code range.
        - `count` number, required: The request count.
        - `average` number, required: The average number of requests per unit.
      - `300` Model6: Metrics for requests in the 300 HTTP status code range.
        - `count` number, required: The request count.
        - `average` number, required: The average number of requests per unit.
      - `400` Model7: Metrics for requests in the 400 HTTP status code range.
        - `count` number, required: The request count.
        - `average` number, required: The average number of requests per unit.
      - `500` Model8: Metrics for requests in the 500 HTTP status code range.
        - `count` number, required: The request count.
        - `average` number, required: The average number of requests per unit.
  - `periods` Model11[], required
    - `startTime` string, required: The start date/time for the period.
    - `endTime` string, required: The end date/time for the period.
    - `averageUnits` 'rps' | 'rpm', required: Returning metric as requests per second (rps) or requests per minute (rpm)
    - `total` Model4: Metric for the total number of requests across all HTTP statuses.
      - `count` number, required: The request count.
      - `average` number, required: The average number of requests per unit.
    - `httpStatus` Model9: The data structure that throuput data be reported back with.
      - `200` Model5: Metrics for requests in the 200 HTTP status code range.
        - `count` number, required: The request count.
        - `average` number, required: The average number of requests per unit.
      - `300` Model6: Metrics for requests in the 300 HTTP status code range.
        - `count` number, required: The request count.
        - `average` number, required: The average number of requests per unit.
      - `400` Model7: Metrics for requests in the 400 HTTP status code range.
        - `count` number, required: The request count.
        - `average` number, required: The average number of requests per unit.
      - `500` Model8: Metrics for requests in the 500 HTTP status code range.
        - `count` number, required: The request count.
        - `average` number, required: The average number of requests per unit.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/apitraffic/apis/apitraffic-api-documentation.md) - [All operations](https://skmtc.dev/apitraffic/apis/apitraffic-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/apitraffic/apis/apitraffic-api-documentation/revisions/b2a22a9b5c98?raw)