---
title: "Create a porting related report"
method: POST
path: "/porting/reports"
tags: ["Porting Orders"]
---

# Create a porting related report

`POST /porting/reports`

Generate reports about porting operations.

## Request body

- object — The parameters for generating a new porting related report.
  - `report_type` 'export_porting_orders_csv', required — Identifies the type of report
  - `params` ExportPortingOrdersCSVReport, required — The parameters for generating a porting orders CSV report.
    - `filters` object, required — The filters to apply to the export porting order CSV report.
      - `status__in` string[] — The status of the porting orders to include in the report.
      - `customer_reference__in` string[] — The customer reference of the porting orders to include in the report.
      - `created_at__lt` string, date-time — The date and time the porting order was created before.
      - `created_at__gt` string, date-time — The date and time the porting order was created after.

## Response `201`

Successful response

- object
  - `data` PortingReport
    - `id` string, uuid — Uniquely identifies the report.
    - `report_type` 'export_porting_orders_csv' — Identifies the type of report
    - `status` 'pending' | 'completed' — The current status of the report generation.
    - `params` ExportPortingOrdersCSVReport — The parameters for generating a porting orders CSV report.
      - `filters` object, required — The filters to apply to the export porting order CSV report.
        - `status__in` string[] — The status of the porting orders to include in the report.
        - `customer_reference__in` string[] — The customer reference of the porting orders to include in the report.
        - `created_at__lt` string, date-time — The date and time the porting order was created before.
        - `created_at__gt` string, date-time — The date and time the porting order was created after.
    - `document_id` string, uuid — Identifies the document that was uploaded when report was generated. This field is only populated when the report is under completed status.
    - `record_type` string — Identifies the type of the resource.
    - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `422` — Unprocessable entity. Check message field in response for details.
- `500` — Internal server error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)