---
title: "List customer service records"
method: GET
path: "/customer_service_records"
tags: ["Customer Service Record"]
---

# List customer service records

`GET /customer_service_records`

List customer service records.

## Query parameters

- `page` object
  - `size` integer — The size of the page
  - `number` integer — The page number to load
- `filter` object
  - `phone_number` object
    - `eq` string — Filters records to those with a specified number.
    - `in` string[] — Filters records to those with at least one number in the list.
  - `status` object
    - `eq` 'pending' | 'completed' | 'failed' — Filters records to those with a specific status.
    - `in` string[] — Filters records to those with a least one status in the list.
  - `created_at` object
    - `lt` string, date-time — Filters records to those created before a specific date.
    - `gt` string, date-time — Filters records to those created after a specific date.
- `sort` object
  - `value` 'created_at' | '-created_at' — Specifies the sort order for results. If not given, results are sorted by created_at in descending order.

## Response `200`

Successful Response

- object
  - `data` CustomerServiceRecord[]
    - `id` string, uuid — Uniquely identifies this customer service record
    - `phone_number` string — The phone number of the customer service record.
    - `status` 'pending' | 'completed' | 'failed' — The status of the customer service record
    - `error_message` string, nullable — The error message in case status is `failed`. This field would be null in case of `pending` or `completed` status.
    - `result` object, nullable — The result of the CSR request. This field would be null in case of `pending` or `failed` status.
      - `carrier_name` string — The name of the carrier that the customer service record is for.
      - `associated_phone_numbers` string[] — The associated phone numbers of the customer service record.
      - `admin` object — The admin of the customer service record.
        - `name` string — The name of the customer service record.
        - `billing_phone_number` string — The billing phone number of the customer service record.
        - `account_number` string — The account number of the customer service record.
        - `authorized_person_name` string — The authorized person name of the customer service record.
      - `address` object — The address of the customer service record
        - `administrative_area` string — The state of the address
        - `locality` string — The city of the address
        - `postal_code` string — The zip code of the address
        - `street_address` string — The street address
        - `full_address` string — The full address
    - `webhook_url` string — Callback URL to receive webhook notifications.
    - `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 created.
  - `meta` PaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

- `401` — The required authentication headers were either invalid or not included in the request.
- `403` — You do not have permission to perform the requested action on the specified resource or resources.
- `422` — Unprocessable entity. Check the 'detail' field in response for details.
- `500` — An unexpected error occurred.

---

[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)