---
title: "Retrieve a CSV download"
method: GET
path: "/phone_numbers/csv_downloads/{id}"
tags: ["CSV Downloads"]
---

# Retrieve a CSV download

`GET /phone_numbers/csv_downloads/{id}`

## Path parameters

- `id` string, required

## Response `200`

Successful response with details about a CSV download.

- object
  - `data` CsvDownload[]
    - `id` string — Identifies the resource.
    - `record_type` string — Identifies the type of the resource.
    - `url` string — The URL at which the CSV file can be retrieved.
    - `status` 'pending' | 'complete' | 'failed' | 'expired' — Indicates the completion level of the CSV report. Only complete CSV download requests will be able to be retrieved.

## Other responses

- `400` — Bad request, the request was unacceptable, often due to missing a required parameter.
- `401` — Unauthorized
- `404` — The requested resource doesn't exist.
- `422` — Unprocessable entity. Check the 'detail' field in response for details.
- `500` — Unexpected 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)