---
title: "Get telco data usage report by ID"
method: GET
path: "/legacy_reporting/usage_reports/number_lookup/{id}"
tags: ["Telco Data Usage Reports"]
---

# Get telco data usage report by ID

`GET /legacy_reporting/usage_reports/number_lookup/{id}`

Retrieve a specific telco data usage report by its ID

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved telco data usage report

- TelcoDataGetUsageReportByIdResponse
  - `data` TelcoDataUsageReportResponse — Telco data usage report response
    - `id` string, uuid — Unique identifier for the report
    - `start_date` string, date — Start date of the report period
    - `end_date` string, date — End date of the report period
    - `aggregation_type` string — Type of aggregation used in the report
    - `status` string — Current status of the report
    - `report_url` string — URL to download the complete report
    - `created_at` string, date-time — Timestamp when the report was created
    - `updated_at` string, date-time — Timestamp when the report was last updated
    - `managed_accounts` string[] — List of managed account IDs included in the report
    - `result` TelcoDataUsageRecord[] — Array of usage records
      - `user_id` string, uuid — User ID
      - `aggregations` TelcoDataAggregation[] — List of aggregations by lookup type
        - `type` string — Type of telco data lookup
        - `total_dips` integer — Total number of lookups performed
        - `total_cost` number — Total cost for this aggregation
        - `currency` string — Currency code
      - `record_type` string — Record type identifier
    - `record_type` string — Record type identifier

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Report not found
- `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/versions/8f5f4e537994/schema)