---
title: "Create Inbound Phone Numbers Level Report"
method: POST
path: "/v2/Voice/Reports/PhoneNumbers/Inbound"
tags: ["InsightsV1CreateInboundPhoneNumbersReport"]
---

# Create Inbound Phone Numbers Level Report

`POST /v2/Voice/Reports/PhoneNumbers/Inbound`

Create Inbound specific Phone Numbers Report for a specific account with given time range.

## Request body

- InsightsV2CreatePhoneNumbersReportRequest
  - `time_range` object
    - `start_datetime` string, date-time — Start date time of the report
    - `end_datetime` string, date-time — End date time of the report
  - `filters` PhoneNumberReportFilter[]
    - `key` string — The name of the filter
    - `values` string[] — List of supported filter values for the field name
  - `size` integer — The number of max available top Phone Numbers to generate.

## Response `201`

Created

- InsightsV2CreateReportResponse
  - `account_sid` string — The unique SID identifier of the Account.
  - `report_id` string — The report identifier as Voice Insights Report TTID.
  - `status` 'created' | 'running' | 'completed' — The status of the report.
  - `request_meta` ReportMetadata
    - `start_datetime` string, date-time — Start date time of the report
    - `end_datetime` string, date-time — End date time of the report
    - `filters` ReportFilter[] — Filter values applied to the report
      - `key` string — The name of the filter 'call_state', 'call_direction', 'call_type', 'twilio_regions', 'caller_country_code', 'callee_country_code', 'silent'
      - `values` string[] — List of supported filter values for the field name
  - `url` string, uri, nullable — The URL of this resource.

---

[API](https://skmtc.net/twilio/apis/insights-v2.md) · [All operations](https://skmtc.net/twilio/apis/insights-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/insights-v2/revisions/2ab2d41cf493/schema)