# Manage Call Logs The BYON Call Logs API allows you to manage call logs, which is a historical list of all calls received while your application has used BYON. It provides endpoints for searching, retrieving, deleting, and updating call logs. ## Base URLs - For your base URL, use the production server `https://naas.t-mobile.com/cpaas` - to find your specific endpoint, go to your dashboard's subscription settings and retrieve the API endpoint. ## Authentication Like all other BYON requests, your calls require two headers for authentication: - `Authorization`: Bearer token (e.g., `Bearer `) - `X-Authorization`: PoP token generated for each request Additionally, include the `msisdn` header with the user's phone number in the format `tel:+14255551111`. ## Endpoints ### 1. Search Call Logs Search for call logs based on criteria. ```bash curl -X POST "https://naas.t-mobile.com/cpaas/calllogs/v1/search" \ -H "Authorization: Bearer " \ -H "X-Authorization: " \ -H "msisdn: tel:+14255551111" \ -H "Content-Type: application/json" \ -d '{"minDate": "2023-08-12T00:00:00Z", "cursor": ""}' ``` ### 2. Get Call Log by ID Retrieve a specific call log by its ID. ```bash curl -X GET "https://naas.t-mobile.com/cpaas/calllogs/v1/{calllogId}" \ -H "Authorization: Bearer " \ -H "X-Authorization: " \ -H "msisdn: tel:+14255551111" ``` ### 3. Delete Call Log Delete a call log by its ID. ```bash curl -X DELETE "https://naas.t-mobile.com/cpaas/calllogs/v1/{calllogId}" \ -H "Authorization: Bearer " \ -H "X-Authorization: " \ -H "msisdn: tel:+14255551111" ``` ### 4. Update Call Log Status Update the status (flag) of a call log. ```bash curl -X PUT "https://naas.t-mobile.com/cpaas/calllogs/v1/{calllogId}/status" \ -H "Authorization: Bearer " \ -H "X-Authorization: " \ -H "msisdn: tel:+14255551111" \ -H "Content-Type: application/json" \ -d '{"flag": "SEEN"}' ``` ## Response Formats Successful responses return JSON data, and error responses include a JSON object with status, code, and message fields. ## Call Log Object Structure ```json { "msisdn": "string", "calllogId": "string", "from": "string", "to": "string", "direction": "string", "startTime": "string", "duration": "string", "flag": "NEW" | "SEEN", "status": "Missed" | "Answered" | "Failed" } ``` Remember to replace ******, ******, and ***{calllogId}*** with actual values in your requests. LC1.3-AUG14