# Retrieve all call history for a contact
curl -X GET "https://api.contactship.ai/v1/contacts/c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6/calls" \
  -H "x-api-key: your-api-key"

# Retrieve calls with specific filters
curl -X GET "https://api.contactship.ai/v1/contacts/c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6/calls?start_date=2023-01-01&direction=outbound&status=answered" \
  -H "x-api-key: your-api-key"

// Using Fetch API to get call history for a contact
const getContactCallHistory = async (contactId, queryParams = {}) => {
  try {
    // Build query string from parameters
    const queryString = Object.keys(queryParams)
      .map(key => `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`)
      .join('&');
    
    const url = `https://api.contactship.ai/v1/contacts/${contactId}/calls${queryString ? `?${queryString}` : ''}`;
    
    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'x-api-key': 'your-api-key'
      }
    });
    
    if (!response.ok) {
      if (response.status === 404) {
        console.error('Contact not found');
        return null;
      }
      throw new Error(`HTTP error! Status: ${response.status}`);
    }
    
    const callHistory = await response.json();
    console.log(`Retrieved ${callHistory.length} call records`);
    return callHistory;
  } catch (error) {
    console.error('Error fetching call history:', error);
  }
};

// Example usage with filters
const contactId = 'c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6';
const queryParams = {
  start_date: '2023-01-01',
  end_date: '2023-12-31',
  direction: 'outbound',
  status: 'answered'
};

getContactCallHistory(contactId, queryParams);

import requests
from datetime import datetime, timedelta

# Replace with your actual API key
api_key = "your-api-key"

# Base URL for the API
base_url = "https://api.contactship.ai"

# Contact ID to retrieve call history for
contact_id = "c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6"

# Headers
headers = {
    "x-api-key": api_key
}

# Optional: Add query parameters for filtering
# Get calls from the last 30 days
thirty_days_ago = (datetime.now() - timedelta(days=30)).strftime('%Y-%m-%d')
today = datetime.now().strftime('%Y-%m-%d')

params = {
    "start_date": thirty_days_ago,
    "end_date": today,
    # "direction": "outbound",  # Optional: Filter by call direction
    # "status": "answered"      # Optional: Filter by call status
}

# Make the GET request
response = requests.get(
    f"{base_url}/v1/contacts/{contact_id}/calls", 
    headers=headers,
    params=params
)

# Check if the request was successful
if response.status_code == 200:
    calls = response.json()
    print(f"Found {len(calls)} call records")
    
    # Calculate some statistics
    total_duration = sum(call.get('duration', 0) for call in calls)
    outbound_calls = sum(1 for call in calls if call.get('direction') == 'outbound')
    inbound_calls = sum(1 for call in calls if call.get('direction') == 'inbound')
    
    print(f"Total call duration: {total_duration} seconds")
    print(f"Outbound calls: {outbound_calls}")
    print(f"Inbound calls: {inbound_calls}")
    
    # Print the most recent calls
    print("\nMost recent calls:")
    sorted_calls = sorted(calls, key=lambda x: x.get('call_time', ''), reverse=True)
    for call in sorted_calls[:5]:  # Show 5 most recent calls
        call_time = call.get('call_time', 'Unknown')
        direction = call.get('direction', 'Unknown')
        status = call.get('status', 'Unknown')
        duration = call.get('duration', 0)
        print(f"  {call_time}: {direction.capitalize()} call, {status}, {duration} seconds")
        
elif response.status_code == 404:
    print("Error: Contact not found")
else:
    print(f"Error: {response.status_code}")
    print(response.text)

[
  {
    "id": "d5e6f7g8-h9i0-j1k2-l3m4-n5o6p7q8r9s0",
    "created_at": "2023-03-15T14:35:00Z",
    "call_time": "2023-03-15T14:30:00Z",
    "duration": 245,
    "direction": "outbound",
    "status": "answered",
    "notes": "Cliente interesado en el plan premium, solicita demostración",
    "recording_url": "https://api.contactship.ai/recordings/d5e6f7g8-h9i0-j1k2-l3m4-n5o6p7q8r9s0.mp3",
    "contact_id": "c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6",
    "user_id": "u1v2w3x4-y5z6-a7b8-c9d0-e1f2g3h4i5j6",
    "organization_id": "org123456"
  },
  {
    "id": "f7g8h9i0-j1k2-l3m4-n5o6-p7q8r9s0t1u2",
    "created_at": "2023-02-20T10:15:00Z",
    "call_time": "2023-02-20T10:10:00Z",
    "duration": 180,
    "direction": "inbound",
    "status": "answered",
    "notes": "Cliente pidió información sobre precios",
    "recording_url": "https://api.contactship.ai/recordings/f7g8h9i0-j1k2-l3m4-n5o6-p7q8r9s0t1u2.mp3",
    "contact_id": "c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6",
    "user_id": "u1v2w3x4-y5z6-a7b8-c9d0-e1f2g3h4i5j6",
    "organization_id": "org123456"
  },
  {
    "id": "h9i0j1k2-l3m4-n5o6-p7q8-r9s0t1u2v3w4",
    "created_at": "2023-01-10T15:45:00Z",
    "call_time": "2023-01-10T15:40:00Z",
    "duration": 0,
    "direction": "outbound",
    "status": "missed",
    "notes": "No contestó, intentar más tarde",
    "recording_url": null,
    "contact_id": "c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6",
    "user_id": "u1v2w3x4-y5z6-a7b8-c9d0-e1f2g3h4i5j6",
    "organization_id": "org123456"
  }
]