> For the complete documentation index, see [llms.txt](https://apidocs.api19.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.api19.com/my-inventory/cdr-records.md).

# CDR Records

Get all of the CDRs on your account

## GET or POST Request

{% hint style="info" %}
<https://v1.api19.com/cdrs/download/csv>
{% endhint %}

Get a list of all of your numbers on your account

You can either send the startdate and enddate or send progressive=yes to give you all of the new records since the last one you downloaded.

| Argument     | Required               | Type                                                                     |
| ------------ | ---------------------- | ------------------------------------------------------------------------ |
| startdate    | yes unless progressive | 04/04/2024                                                               |
| enddate      | yes unless progressive | 04/06/2024                                                               |
| record\_type | calls / sms            | Send sms to get sms record                                               |
| add\_data    | no                     | add\_data=yes will add additional data                                   |
| progressive  | no                     | <p>progressive=yes<br>makes it so you don't need startdate / enddate</p> |
| limit        | no                     | set a limit of how many records to reply with for progressive            |
| key          | yes                    | your token/key                                                           |

{% tabs %}
{% tab title="Curl Post" %}

```javascript
curl https://v1.api19.com/cdrs/download/csv \
 -d 'startdate=04/04/2024' \
 -d 'enddate=04/06/2024' \
 -d 'record_type=calls' \
 -d 'add_data=yes' \
 -d 'key=api_token'
 
May also use record_type=sms for sms records
```

{% endtab %}

{% tab title="Curl Get" %}

```
curl https://v1.api19.com/cdrs/download/csv?key=apikey&startdate=04/04/2024&enddate=04/05/2024
```

{% endtab %}

{% tab title="Calls Response" %}

```
date,your_cost,your_permin,submaster_id,user_id,submaster_cost,user_cost,submaster_permin,user_permin,billsec,src,dst,did,call_type

with add_data=yes:
date,your_cost,your_permin,submaster_id,user_id,submaster_cost,user_cost,submaster_permin,user_permin,billsec,src,dst,did,call_type,sip_code,sip_reason,call_sid
```

{% endtab %}

{% tab title="SMS Response" %}

```
date,your_cost,surcharge,src,dst,message,direction,alpha,msg_type,uuid
```

{% endtab %}
{% endtabs %}