> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/tools-tips-and-tricks/restful-api/extracting-call-traces-with-the-api.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.