---
title: "Create Charges Report [EXPERIMENTAL]"
method: POST
path: "/reports/charges"
tags: ["Charges Reports"]
---

# Create Charges Report \[EXPERIMENTAL\]

`POST /reports/charges`

## Request

- Base URL: `https://eu-west-1.api.silverflow.com/v1`
- URL: `https://eu-west-1.api.silverflow.com/v1/reports/charges`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/silverflow/apis/silverflow-api/docs/reports/charges/post.ts> (a function with typed inputs; its response is checked against the schema)

Schedules the creation of a Charges Report.

Requires the `reports:CreateCharges` permission.

Please check our detailed guide on the report content and other considerations [here](https://docs.silverflow.com/guides/charges-report).

## Request body

- ChargesReportRequest: Create Charges Report
  - `parameters` ChargesReportParameters, required: The query parameters used for a report.
    - `createdFrom` string, date-time, required: Include only items that have a created date greater than or equal to the specified date
    - `createdTo` string, date-time, required: Include only items that have a created date less than or equal to the specified date
  - `mimeType` 'text/csv', required: The mime-type in which the Charges report is available.
  - `reference` string: Unique ID used to identify a report.
  - `distributions` DistributionKey[]: The distribution objects' keys. If passed, the report will be distributed when generation is completed.

## Response `201`

The scheduled Charges Report

- CreateChargesReportResponse
  - `reportName` 'Charges', required: The name of the report.
  - `parameters` ChargesReportParameters, required: The query parameters used for a report.
    - `createdFrom` string, date-time, required: Include only items that have a created date greater than or equal to the specified date
    - `createdTo` string, date-time, required: Include only items that have a created date less than or equal to the specified date
  - `mimeType` 'text/csv', required: The mime-type in which the Charges report is available.
  - `key` string, required: Uniquely identifies a report object
  - `agentKey` string, required: Uniquely identifies an Agent
  - `reference` string: Unique ID used to identify a report.
  - `status` 'scheduled', required: The status of the report.
  - `created` string, date-time, required: The date and time this object was created
  - `distributions` DistributionKey[]: The distribution objects' keys. If passed, the report will be distributed when generation is completed.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: The authenticated client is forbidden to make the request for the resource identified.
- `429`: The number of requests (per minute) has exceeded the configured maximum

---

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