---
title: "Read CDRs for Specific User"
method: GET
path: "/domains/{domain}/users/{user}/cdrs"
tags: ["CDR (Call History)"]
---

# Read CDRs for Specific User

`GET /domains/{domain}/users/{user}/cdrs`

## Path parameters

- `domain` string, required — This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.
- `user` string, required — This is the main user extension for the user account. ~ can be used to mean "my account" which will extract the user from the token/key used for authentication.

## Query parameters

- `datetime-start` string, rfc3339, required — This is the start of the time window for a given query. The format is based on RFC3339 but also will support additonal params for use in providing a timezone which will allow the API to give the correct range for a given set of data and will be formated in respone using the same format. Supported formats include. * 2023-11-27 13:00:00 * 2023-11-27T13:00:00Z * 2023-11-27T13:00:00-08:00 * 2023-11-27T13:00:00-08:00[US/Pacific] * 2023-11-27T13:00:00Z[America/Phoenix]
- `datetime-end` string, rfc3339, required — This is the end of the time window for a given query. The format is based on RFC3339 but also will support additonal params for use in providing a timezone which will allow the API to give the correct range for a given set of data and will be formated in respone using the same format. Allowed values same as datetime-start.
- `start` number — This is the start value when using pagination. 0 is the default and the minimum value. For example the default of 0 paired with the default limit of 100 would return the first 100 objects in the data request. A start of 100 and a default limit of 100 would give you the second 100 results in the response.
- `limit` number — This is the limit of the number of objects that will be returned in the read/list API call. This can be used with pagination to help retrieve smaller chunks of data. Should be used in conjunction with Start.
- `type` string

## Response `200`

- CdrU[]
  - `uid` string, required
  - `domain` string, required
  - `cdr_id` string, required
  - `type` integer, required
  - `time_start` integer, required
  - `time_answer` integer, required
  - `time_release` integer, required
  - `duration` integer, required
  - `orig_to_uri` string, required
  - `number` string, nullable, required
  - `name` string, nullable, required
  - `onnet` integer, required
  - `hide` integer, required
  - `tag` string, required
  - `expected_trace` boolean, required

## Other responses

- `400`
- `401`
- `404`

---

[API](https://skmtc.net/ns-api/apis/netsapiens-api-v2.md) · [All operations](https://skmtc.net/ns-api/apis/netsapiens-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ns-api/netsapiens-api-v2/revisions/d37f65b5b886/schema)