> ## Documentation Index > Fetch the complete documentation index at: https://agents.docs.timepay.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Logs > Retrieve paginated communication logs (calls, WhatsApp, SMS) with optional filters. ### Headers Bearer token for authentication (e.g., `Bearer `). ### Query Parameters Filter by communication type. * `call` — Voice calls * `whatsapp` — WhatsApp messages Filter by log status (e.g., `No Contact`, `Completed`, `Failed`). Filter by call disposition (e.g., `Voicemail`, `Promise to Pay`, `Not Interested`). Filter by caller/sender phone number (e.g., `+918035450808`). Filter by customer phone number (e.g., `8888889956`). Filter by campaign ID. Filter by agent ID. Filter logs from this datetime (inclusive). Format: ISO 8601 (e.g., `2026-01-17T00:00:00`). Filter logs until this datetime (inclusive). Format: ISO 8601 (e.g., `2026-01-17T23:59:59`). Page number (1-indexed). Each page returns **10** logs. If `true`, returns only the total count of matching logs without fetching log data. ### Response #### Standard Response (count\_only=false) Indicates whether the request was successful. Array of log entries. Fields vary slightly based on type. Date of the log entry (`YYYY-MM-DD`). Present only for Collection organizations. Unique loan identifier of the customer. Present only for Lead Generation organizations. Unique lead identifier of the customer. Start timestamp (ISO 8601). End timestamp (ISO 8601). `null` for WhatsApp/SMS. Name of the campaign. Campaign ID. Customer's name as specified in campaign data Duration in seconds (0 for WhatsApp/SMS). Direction: `outbound` or `inbound`. Caller/sender phone number. Customer phone number. Log status. Call disposition/outcome. Data extracted by the AI agent during the conversation. Agent ID that handled the interaction. Disposition configuration ID. AI-generated call summary. Communication type: `call`, `whatsapp`, or `sms`. Unique call identifier. Transcript ID extracted from the transcript file path. Use the [Get Transcript](/api-reference/get-transcript) endpoint to fetch the full transcript. Recording ID. Use the [Get Recording](/api-reference/get-recording) endpoint to stream the audio. Unique message identifier. WhatsApp message ID assigned by Meta. WhatsApp conversation thread. Message role: `assistant` or `user`. Message content. Message timestamp (ISO 8601). WhatsApp delivery errors from Meta API. Meta error code. Error title. Error message. Link to Meta error documentation. Additional error details. Pagination metadata. Current page number. Results per page (always 10). Total matching logs. Total number of pages. Whether a next page exists. Whether a previous page exists. #### Count-Only Response (count\_only=true) Indicates whether the request was successful. Total number of logs matching the filters. ```json 200 Call Logs theme={null} { "success": true, "data": [ { "call_id": "KjbdfYCefvutafHGCDhgfhgafhdyfyg", "date": "2026-01-17", "start_time": "2026-01-17T08:33:36", "end_time": "2026-01-17T08:35:08", "campaign_name": "August EMI Reminder Campaign", "campaign_id": "LKsfiGVdygfvYFGCdygayhf", "name": "John Wick", "loan_id": "LOAN-ABC-123", "duration": 14, "direction": "outbound", "from": "+918888888888", "to": "9999999999", "status": "No Contact", "disposition": "Voicemail", "transcript_id": "7437557f-7ab9-4012-b411-a6f534c5aaf0", "recording_id": "9242c009-1f8f-4bd6-a40c-e40926d1fd88", "extracted_data": {}, "summary": "Customer acknowledged the pending EMI of ₹12,500 due on August 15 and promised to deposit the amount by tomorrow.", "agent_id": "lGJVyhgvayGDtfsfdfdf", "disposition_id": "YefgTYRCdygdygw", "type": "call" } ], "pagination": { "page": 1, "per_page": 10, "total": 2450, "total_pages": 245, "has_next": true, "has_prev": false } } ``` ```json 200 WhatsApp Logs theme={null} { "success": true, "data": [ { "message_id": "kajdfahbfuyFYtdygfvygYFDCycf", "date": "2026-01-22", "start_time": "2026-01-22T19:04:31", "end_time": null, "campaign_name": "August EMI Reminder Campaign", "campaign_id": "khYTFvdygvgYCFDgvhbfvn", "name": "John Wick", "loan_id": "LOAN-ABC-123", "duration": 0, "direction": "outbound", "from": null, "to": "8264705488", "status": "Read", "disposition": null, "extracted_data": {}, "agent_id": "", "disposition_id": null, "type": "whatsapp", "wamid": "wamid.HBgMOTE4MjY0NzA1NDg4FQIAERgSMUREQzk0RjExNTQzMzE3RkZGAA==", "conversation": [ { "role": "assistant", "content": "नमस्ते john\n\nआपका timepay.ai लोन किस्त (Loan ID: 243410) 18 दिन से बकाया पड़ा है।\n\nबकाया राशि: ₹7442\n\nकृपया तुरंत timepay.ai ऐप के ज़रिए पेमेंट क्लियर करें।", "timestamp": "2026-01-22T19:04:31" } ], "errors": [ { "code": 131042, "href": "https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/", "title": "Business eligibility payment issue", "message": "Business eligibility payment issue", "error_data": { "details": "Message failed to send because there were one or more errors related to your payment method." } } ] } ], "pagination": { "page": 1, "per_page": 10, "total": 1250, "total_pages": 125, "has_next": true, "has_prev": false } } ``` ```json 200 Count Only theme={null} { "success": true, "total": 15340 } ``` ```json 200 Mixed Types (no type filter) theme={null} { "success": true, "data": [ { "message_id": "IbugvFCTDFCdgtfdhgCTYRFCYGEf", "date": "2026-01-22", "start_time": "2026-01-22T19:04:31", "end_time": null, "campaign_name": "Aug Campaign", "campaign_id": "tcELESaJAtDfnWxJvzLU", "name": "Rajesh Joshi", "loan_id": "LOAN-ABC-334", "to": "8264705488", "status": "Failed", "agent_id": "", "type": "whatsapp", "wamid": "wamid.HBgMOTE4MjY0NzA1NDg4FQIAERgSMUREQzk0RjExNTQzMzE3RkZGAA==", "conversation": [], "errors": [] }, { "date": "2026-01-17", "start_time": "2026-01-17T08:33:36", "end_time": "2026-01-17T08:35:08", "campaign_name": "Jan Campaign", "campaign_id": "MboeowkjabsXlVwgkwlm", "name": "Trilok", "loan_id": "LOAN-ABC-334", "duration": 14, "direction": "outbound", "from": "+918035450808", "to": "8888889956", "status": "No Contact", "disposition": "Voicemail", "transcript_id": "7437557f-7ab9-4012-b411-a6f534c5aaf0", "recording_id": "9242c009-1f8f-4bd6-a40c-e40926d1fd88", "extracted_data": {}, "agent_id": "lHLbgcfaUBTFvYodWKUR", "disposition_id": "ZvhjjEIldlzSEcCWibNM", "type": "call" } ], "pagination": { "page": 1, "per_page": 10, "total": 15340, "total_pages": 1534, "has_next": true, "has_prev": false } } ``` ```json 400 Validation Error theme={null} { "success": false, "message": "Validation failed", "errors": [ "Invalid type 'email'. Must be one of: call, whatsapp, sms" ] } ``` ```json 500 Server Error theme={null} { "success": false, "error": "Internal Server Error", "message": "An unexpected error occurred" } ``` ### Usage Examples **Get all logs (page 1):** ``` GET /api/v1/logs ``` **Get only call logs:** ``` GET /api/v1/logs?type=call ``` **Get WhatsApp logs for a specific campaign:** ``` GET /api/v1/logs?type=whatsapp&campaign_id=tcELESaJAtDfnWxJvzLU ``` **Get logs within a date range:** ``` GET /api/v1/logs?start_time=2026-01-17T00:00:00&end_time=2026-01-17T23:59:59 ``` **Get failed WhatsApp messages:** ``` GET /api/v1/logs?type=whatsapp&status=Failed ``` **Filter by customer phone and disposition:** ``` GET /api/v1/logs?phone=8888889956&disposition=Voicemail ``` **Get logs from a specific caller number:** ``` GET /api/v1/logs?from_phone=+918035450808&type=call ``` **Get page 3 of call logs:** ``` GET /api/v1/logs?type=call&page=3 ``` **Count total failed logs:** ``` GET /api/v1/logs?status=Failed&count_only=true ``` **Combine multiple filters:** ``` GET /api/v1/logs?type=call&status=No Contact&disposition=Voicemail&start_time=2026-01-01T00:00:00&end_time=2026-01-31T23:59:59&page=1 ```