# Extracting Call Traces with the API

The best resource is to use a `GET` method on `https://tmedia.com:12358/call_trace`

By default this will return the IDs of last `10` call legs. Unless you have set a different value in the same session.

 

To modify the number of results use the `nb_result` parameter.

Add Parameters using the following format:

`http://tmedia.com:12358/resource_url?parameter_a=1&parameter_b=2`

Like So:

`https://tmedia.com:12358/call_trace?nb_result=20`

 

To get full information on each leg add the parameter `recursive=yes`

`https://tmedia.com:12358/call_trace?nb_result=20&recursive=yes`

To get older information specify your page number, where 1 is the most recent calls.

`https://tmedia.com:12358/call_trace?page=2&recursive=yes&nb_result=20`

To get different information you can use different filters by adding them as parameters.

`https://tmedia.com:12358/call_trace?start=2025-03-03 00:00:00&end=2025-03-03 16:59:59&page=2&recursive=yes&terminate_reason=Not Normal&nb_result=20`

 

Available Parameters:

<table><thead><tr><th width="145.75006103515625">Parameter</th><th>Valid Input</th></tr></thead><tbody><tr><td>page</td><td>Integer (e.g., 1, 2, 3). Specifies the page number for paginated results. Defaults to 1 if omitted.</td></tr><tr><td>nb_result</td><td>Integer (e.g., 1 through 1000*). Sets the number of results per page. Omitting this paramter can cause problems.<br><br><em>*Limit of 1000 since 3.1.148+ 3.2.65+ 3.3.9+, older versions are limited to 100</em></td></tr><tr><td>start</td><td>DateTime string in YYYY-MM-DD HH:MM:SS format (e.g., 2025-03-03 00:00:00). Filters calls starting after this time. </td></tr><tr><td>end</td><td>DateTime string in YYYY-MM-DD HH:MM:SS format (e.g., 2025-03-03 23:59:59). Filters calls ending before this time. Omitting this paramter can cause problems.</td></tr><tr><td>called</td><td>String (e.g., 1234567890). The called phone number or SIP URI. Omit this parameter for no filter.</td></tr><tr><td>calling</td><td>String (e.g., 0987654321). The calling phone number or SIP URI. Omit this parameter for no filter.</td></tr><tr><td>nap</td><td>String (e.g., nap1). NAP Name. Omit this parameter for no filter.</td></tr><tr><td>route</td><td>String (e.g., routeA). Call route identifier. Omit this parameter for no filter.</td></tr><tr><td>protocol</td><td>String (e.g., SIP, SS7, CAS, or ISDN). Call protocol. Omit this parameter for no filter.</td></tr><tr><td>direction</td><td>Integer, 1 = Incoming, 2 = Outgoing, 3 = Mixer, or 4 = MediaOnly). Call direction. Empty string means no filter.</td></tr><tr><td>recorded</td><td>String (e.g., Recorded, Not Recorded). Indicates if the call was recorded . Empty string means no filter.</td></tr><tr><td>call_state</td><td>String (e.g., Active, Inactive). Call status. Empty string means no filter.</td></tr><tr><td>leg_id</td><td>String (e.g., 0x2D9E9DDE). Unique ID of a call leg. Empty string means no filter.</td></tr><tr><td>call_duration</td><td>String (e.g., 300). Call duration in seconds. Empty string means no filter.</td></tr><tr><td>terminate_reason</td><td>String (e.g., Normal, Not Normal, Manually Removed, or custom string: 206, 404 etc..).Empty string means no filter.</td></tr><tr><td>mos</td><td>String (e.g., 4.5). Mean Opinion Score (Float 0.0-5.0 for call quality). Empty string means no filter.</td></tr><tr><td>network_quality</td><td>Calls will be filtered based on a network quality equal to or less than that specified. Range from 1 to 100<br><br>Comparison operators can be used to modify the field behavior:<br>x : Will return all calls with a value greater than x<br>x-y : Will return all calls with a value between x and y<br>&#x3C;x : Will return all calls with a value less than x. Equivalent to 'x' alone</td></tr><tr><td>call_id</td><td>String (e.g., 54-1154254@172.31.36.128). Unique call identifier . Empty string means no filter.</td></tr><tr><td>intercepted</td><td>String (e.g., Intercepted, Not Intercepted, All). Indicates if the call was intercepted Empty string means no filter.</td></tr><tr><td>interception_liid</td><td>String (e.g., LIID123). Lawful Interception ID . Empty string means no filter.</td></tr><tr><td>interception_leg</td><td>String (e.g., 0= Not Interception Leg,1` = Interception Leg). Intercepted call leg identifier. Empty string means no filter.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://prosbcdocs.telcobridges.com/tools-tips-and-tricks/restful-api/extracting-call-traces-with-the-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.