# Get call history for a contact by phone number
curl -X GET "https://api.contactship.ai/v1/contacts/+573014445709/call-history" \
  -H "x-api-key: your-api-key"

# Get filtered call history for a contact by phone number
curl -X GET "https://api.contactship.ai/v1/contacts/+573014445709/call-history?start_date=2023-01-01&direction=outbound&status=answered" \
  -H "x-api-key: your-api-key"

// Using Fetch API to get call history by phone number
const getCallHistoryByPhone = async (phoneNumber, 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/${encodeURIComponent(phoneNumber)}/call-history${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 data = await response.json();
    console.log('Contact:', data.contact);
    console.log(`Retrieved ${data.call_history.calls.length} call records`);
    return data;
  } catch (error) {
    console.error('Error fetching call history:', error);
  }
};

// Example usage with filters
const phoneNumber = '+12124567890';
const queryParams = {
  start_date: '2023-01-01',
  end_date: '2023-12-31',
  direction: 'outbound',
  status: 'answered'
};

getCallHistoryByPhone(phoneNumber, queryParams);

import requests
import urllib.parse
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"

# Phone number to retrieve call history for
phone_number = "+12124567890"

# 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
encoded_phone = urllib.parse.quote(phone_number)
response = requests.get(
    f"{base_url}/v1/contacts/{encoded_phone}/call-history", 
    headers=headers,
    params=params
)

# Check if the request was successful
if response.status_code == 200:
    data = response.json()
    contact = data['contact']
    call_history = data['call_history']
    
    print(f"Contact found: {contact['full_name']}")
    print(f"Total calls: {len(call_history['calls'])}")
    
    # Print the most recent calls
    print("\nMost recent calls:")
    sorted_calls = sorted(call_history['calls'], 
                         key=lambda x: x['call_time'], 
                         reverse=True)
    
    for call in sorted_calls[:5]:  # Show 5 most recent calls
        call_time = call['call_time']
        direction = call['direction']
        status = call['status']
        duration = call['duration']
        print(f"  {call_time}: {direction.capitalize()} call, {status}, {duration} seconds")
        
elif response.status_code == 404:
    print("Contact not found")
else:
    print(f"Error: {response.status_code}")
    print(response.text)

{
  "statusCode": 200,
  "data": {
    "contact_id": "c8a23f45-9b12-4d78-af90-1e5d23c67890",
    "contact": {
      "full_name": "Maria González",
      "country": "México",
      "email": "maria.gonzalez@ejemplo.com",
      "phone_number": "+525512345678",
      "additional_data": null,
      "description": "Lead from Facebook campaign",
      "created_at": "2024-03-01T15:30:00.123+00:00"
    },
    "history": {
      "call_attempts": 2,
      "calls": [
        {
          "direction": "outbound-api",
          "from": "+525619190379",
          "call_record": "https://storage.example.com/recordings/abc123def456/recording.wav",
          "status": "answered",
          "start_at": "2024-03-05T14:20:15.445+00:00",
          "finished_at": "2024-03-05T14:23:45.571+00:00",
          "price": 15,
          "price_unit": "USD",
          "duration": "210",
          "call_analysis": {
            "call_summary": "Cliente mostró interés en el producto premium. Solicitó información sobre precios y características específicas.",
            "in_voicemail": false,
            "user_sentiment": "Positive",
            "call_successful": true,
            "custom_analysis_data": {
              "email_usuario": "maria.gonzalez@ejemplo.com",
              "canal_de_seguimiento": "email",
              "quiere_mas_informacion": true
            }
          },
          "type": "api_call",
          "created_at": "2024-03-05T14:20:00.123456+00:00",
          "chat_history": [
            {
              "role": "assistant",
              "content": "¡Hola! Le llamo de parte de nuestra empresa para hablar sobre nuestros servicios premium."
            },
            {
              "role": "user",
              "content": "Me interesa conocer más sobre los precios y características."
            }
          ]
        },
        {
          "direction": "outbound-api",
          "from": "+525619190379",
          "call_record": "https://storage.example.com/recordings/xyz789uvw/recording.wav",
          "status": "voicemail",
          "start_at": "2024-03-01T16:00:00.445+00:00",
          "finished_at": "2024-03-01T16:00:45.571+00:00",
          "price": 5,
          "price_unit": "USD",
          "duration": "45",
          "call_analysis": {
            "call_summary": "Llamada dirigida a buzón de voz. Se dejó mensaje con información de contacto.",
            "in_voicemail": true,
            "user_sentiment": "Neutral",
            "call_successful": true,
            "custom_analysis_data": {
              "email_usuario": "",
              "canal_de_seguimiento": "phone",
              "quiere_mas_informacion": false
            }
          },
          "type": "api_call",
          "created_at": "2024-03-01T16:00:00.123456+00:00",
          "chat_history": [
            {
              "role": "assistant",
              "content": "Le dejamos un mensaje en su buzón de voz con nuestra información de contacto."
            }
          ]
        }
      ],
      "last_call": {
        "direction": "outbound-api",
        "from": "+525619190379",
        "call_record": "https://storage.example.com/recordings/abc123def456/recording.wav",
        "status": "answered",
        "start_at": "2024-03-05T14:20:15.445+00:00",
        "finished_at": "2024-03-05T14:23:45.571+00:00",
        "price": 15,
        "price_unit": "USD",
        "duration": "210",
        "call_analysis": {
          "call_summary": "Cliente mostró interés en el producto premium. Solicitó información sobre precios y características específicas.",
          "in_voicemail": false,
          "user_sentiment": "Positive",
          "call_successful": true,
          "custom_analysis_data": {
            "email_usuario": "maria.gonzalez@ejemplo.com",
            "canal_de_seguimiento": "email",
            "quiere_mas_informacion": true
          }
        },
        "type": "api_call",
        "created_at": "2024-03-05T14:20:00.123456+00:00",
        "chat_history": [
          {
            "role": "assistant",
            "content": "¡Hola! Le llamo de parte de nuestra empresa para hablar sobre nuestros servicios premium."
          },
          {
            "role": "user",
            "content": "Me interesa conocer más sobre los precios y características."
          }
        ]
      }
    }
  }
}