# Retrieve a contact using its ID
curl -X GET "https://api.contactship.ai/v1/contacts/c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6" \
  -H "x-api-key: your-api-key"

# Retrieve a contact using its email address
curl -X GET "https://api.contactship.ai/v1/contacts/juan@ejemplo.com?identifierType=email" \
  -H "x-api-key: your-api-key"

# Retrieve a contact using its phone number (URL-encoded)
curl -X GET "https://api.contactship.ai/v1/contacts/%2B12124567890?identifierType=phone_number" \
  -H "x-api-key: your-api-key"

// Using Fetch API to retrieve a contact by ID
const getContactById = async (contactId) => {
  try {
    const response = await fetch(`https://api.contactship.ai/v1/contacts/${contactId}`, {
      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 contact = await response.json();
    console.log('Contact retrieved:', contact);
    return contact;
  } catch (error) {
    console.error('Error fetching contact:', error);
  }
};

// Call the function with a contact ID
getContactById('c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6');

// Using Fetch API to retrieve a contact by email
const getContactByEmail = async (email) => {
  try {
    const response = await fetch(`https://api.contactship.ai/v1/contacts/${encodeURIComponent(email)}?identifierType=email`, {
      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 contact = await response.json();
    console.log('Contact retrieved:', contact);
    return contact;
  } catch (error) {
    console.error('Error fetching contact:', error);
  }
};

// Call the function with an email
getContactByEmail('juan@ejemplo.com');

// Using Fetch API to retrieve a contact by phone number
const getContactByPhone = async (phoneNumber) => {
  try {
    const response = await fetch(`https://api.contactship.ai/v1/contacts/${encodeURIComponent(phoneNumber)}?identifierType=phone_number`, {
      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 contact = await response.json();
    console.log('Contact retrieved:', contact);
    return contact;
  } catch (error) {
    console.error('Error fetching contact:', error);
  }
};

// Call the function with a phone number
getContactByPhone('+12124567890');

import requests
import urllib.parse

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

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

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

# Example 1: Retrieve by ID
def get_contact_by_id(contact_id):
    response = requests.get(f"{base_url}/v1/contacts/{contact_id}", headers=headers)
    process_response(response)

# Example 2: Retrieve by email
def get_contact_by_email(email):
    encoded_email = urllib.parse.quote(email)
    response = requests.get(
        f"{base_url}/v1/contacts/{encoded_email}?identifierType=email", 
        headers=headers
    )
    process_response(response)

# Example 3: Retrieve by phone number
def get_contact_by_phone(phone_number):
    encoded_phone = urllib.parse.quote(phone_number)
    response = requests.get(
        f"{base_url}/v1/contacts/{encoded_phone}?identifierType=phone_number", 
        headers=headers
    )
    process_response(response)

# Helper function to process the response
def process_response(response):
    if response.status_code == 200:
        contact = response.json()
        print(f"Contact found: {contact['full_name']}")
        print(f"Phone: {contact['phone_number']}")
        print(f"Email: {contact['email']}")
        
        # Print additional data if available
        if contact['additional_data']:
            print("Additional information:")
            for data in contact['additional_data']:
                print(f"  {data['field']}: {data['value']} ({data['type']})")
    elif response.status_code == 404:
        print("Contact not found")
    else:
        print(f"Error: {response.status_code}")
        print(response.text)

# Usage examples
contact_id = "c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6"
email = "juan@ejemplo.com"
phone_number = "+12124567890"

print("Looking up by ID:")
get_contact_by_id(contact_id)

print("\nLooking up by email:")
get_contact_by_email(email)

print("\nLooking up by phone number:")
get_contact_by_phone(phone_number)

{
  "id": "c1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6",
  "created_at": "2023-01-01T12:00:00Z",
  "phone_number": "+12124567890",
  "full_name": "Juan Pérez",
  "country": "México",
  "email": "juan@ejemplo.com",
  "description": "Lead from LinkedIn campaign",
  "additional_data": [
    {
      "type": "location",
      "field": "dirección",
      "value": "Av. Insurgentes 123"
    },
    {
      "type": "text",
      "field": "notas",
      "value": "Cliente potencial para servicio premium"
    }
  ],
  "organization_id": "org123456"
}