# GetReportingReportTypesReportType

From **Stripe API**.

`GET /v1/reporting/report_types/{report_type}`

<p>Retrieves the details of a Report Type. (Certain report types require a <a href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)</p>

## Parameters

### `expand`

- Location: query
- Required: false
- Type: `array`

Specifies which fields in the response should be expanded.

### `report_type`

- Location: path
- Required: true
- Type: `string`

## Request body

- Required: false
### `application/x-www-form-urlencoded`

- Type: `object`

```json
{"additionalProperties":false,"type":"object"}
```

## Security

### `basicAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `basic`
Send credentials in the `Authorization` request header using the `Basic` scheme.

Basic HTTP authentication. Allowed headers-- Authorization: Basic <api_key> | Authorization: Basic <base64 hash of `api_key:`>

### `bearerAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `bearer`
- Bearer format: `auth-scheme`
Send the token in the `Authorization` request header using the `Bearer` scheme.

Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>

## Responses

### `200`

Successful response.

### `application/json`

- Type: `object`

The Report Type resource corresponds to a particular type of report, such as
the "Activity summary" or "Itemized payouts" reports. These objects are
identified by an ID belonging to a set of enumerated values. See
[API Access to Reports documentation](https://stripe.com/docs/reporting/statements/api)
for those Report Type IDs, along with required and optional parameters.

Note that certain report types can only be run based on your live-mode data (not test-mode
data), and will error when queried without a [live-mode API key](https://stripe.com/docs/keys#test-live-modes).

```json
{"description":"The Report Type resource corresponds to a particular type of report, such as\nthe \"Activity summary\" or \"Itemized payouts\" reports. These objects are\nidentified by an ID belonging to a set of enumerated values. See\n[API Access to Reports documentation](https://stripe.com/docs/reporting/statements/api)\nfor those Report Type IDs, along with required and optional parameters.\n\nNote that certain report types can only be run based on your live-mode data (not test-mode\ndata), and will error when queried without a [live-mode API key](https://stripe.com/docs/keys#test-live-modes).","properties":{"data_available_end":{"description":"Most recent time for which this Report Type is available. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"data_available_start":{"description":"Earliest time for which this Report Type is available. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"default_columns":{"description":"List of column names that are included by default when this Report Type gets run. (If the Report Type doesn't support the `columns` parameter, this will be null.)","items":{"maxLength":5000,"type":"string"},"nullable":true,"type":"array"},"id":{"description":"The [ID of the Report Type](https://stripe.com/docs/reporting/statements/api#available-report-types), such as `balance.summary.1`.","maxLength":5000,"type":"string"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"name":{"description":"Human-readable name of the Report Type","maxLength":5000,"type":"string"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["reporting.report_type"],"type":"string"},"updated":{"description":"When this Report Type was latest updated. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"version":{"description":"Version of the Report Type. Different versions report with the same ID will have the same purpose, but may take different run parameters or have different result schemas.","type":"integer"}},"required":["data_available_end","data_available_start","id","livemode","name","object","updated","version"],"title":"reporting_report_type","type":"object","x-expandableFields":[],"x-resourceId":"reporting.report_type"}
```

### `default`

Error response.

### `application/json`

- Type: `object`

An error response from the Stripe API

```json
{"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url https://api.stripe.com/v1/reporting/report_types/{report_type} \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data '{}'
```