---
title: "Request a CDR export"
method: POST
path: "/api/v1/cdr-exports"
tags: ["CDR Exports"]
---

# Request a CDR export

`POST /api/v1/cdr-exports`

Triggers an asynchronous export of Charge Detail Records (CDRs) for an operator. The export is processed in the background and the resulting file is delivered by email to the address provided. The recipient email must belong to a Monta user with export permission on the target operator.</br></br>*Notes:*</br>- The date range may not exceed 31 days.</br>- If `operatorId` is omitted, it is derived from the credentials. Consumers with multiple authorised operators must specify it explicitly.</br>- `direction` defaults to `INBOUND` (CDRs Monta issued as CPO to partner eMSPs). Set `OUTBOUND` to export CDRs Monta received as eMSP from partner CPOs.</br></br>Required scope: `cdr-exports:write` </br>Organization authorization: `supported`

## Request body

- CdrExportRequest
  - `operatorId` integer, nullable — The ID of the operator whose CDRs will be exported. If not provided, operator ID will be derived from the used api credentials.
  - `from` string, required — Start of the export range (inclusive), in `yyyy-MM-dd` format.
  - `to` string, required — End of the export range (inclusive), in `yyyy-MM-dd` format. Must be on or after `from`, and the range may not exceed 31 days.
  - `format` 'CSV' | 'JSON'
  - `email` string, email, required — Email address that the export will be delivered to. Must belong to a Monta user with the export permission on the target operator.
  - `emspIdentifier` string, nullable — Optional filter. When set, only CDRs whose EMSP identifier (`{CountryCode}*{PartyId}`) matches are exported. Does not appear as a column in the exported file.
  - `selfManaged` boolean, nullable — Optional filter. When set, only CDRs with the matching self-managed flag (bilateral agreement) are exported.
  - `direction` 'INBOUND' | 'OUTBOUND'

## Response `202`

CDR export accepted; the file will be sent by email

- CdrExportAccepted
  - `status` string, required — Export request status. Always `queued` for an accepted request.
  - `message` string, required — Human-readable confirmation message.

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)