# Retrieve the first page of contacts (1000 per page)
curl -X GET "https://api.contactship.ai/v1/contacts?limit=1000&offset=0" \
  -H "x-api-key: your-api-key"

# Search for contacts with "Juan" in their name
curl -X GET "https://api.contactship.ai/v1/contacts?full_name=Juan" \
  -H "x-api-key: your-api-key"

# Search for contacts with both name and phone number criteria
curl -X GET "https://api.contactship.ai/v1/contacts?full_name=Juan&phone_number=%2B1212" \
  -H "x-api-key: your-api-key"

// Using Fetch API to get all contacts
const fetchContacts = async () => {
  try {
    const response = await fetch('https://api.contactship.ai/v1/contacts', {
      method: 'GET',
      headers: {
        'x-api-key': 'your-api-key'
      }
    });
    
    if (!response.ok) {
      throw new Error(`HTTP error! Status: ${response.status}`);
    }
    
    const { data: contacts } = await response.json();
    console.log('Contacts retrieved:', contacts);
    return contacts;
  } catch (error) {
    console.error('Error fetching contacts:', error);
  }
};

// Call the function
fetchContacts();

import requests

# 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
}

# Optional: Add query parameters for filtering
params = {
    "full_name": "Juan",  # Optional: Filter by name
    # "email": "example.com",  # Optional: Filter by email domain
    # "phone_number": "+1212"  # Optional: Filter by phone number
}

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

# Check if the request was successful
if response.status_code == 200:
    contacts = response.json()["data"]
    print(f"Found {len(contacts)} contacts")
    for contact in contacts:
        print(f"Name: {contact['full_name']}, Phone: {contact['phone_number']}")
else:
    print(f"Error: {response.status_code}")
    print(response.text)

{
  "statusCode": 200,
  "data": [
    {
      "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"
    },
    {
      "id": "d5e6f7g8-h9i0-j1k2-l3m4-n5o6p7q8r9s0",
      "created_at": "2023-01-05T09:30:00Z",
      "phone_number": "+12125678901",
      "full_name": "Juan Martínez",
      "country": "Colombia",
      "email": "juan.martinez@ejemplo.com",
      "description": "Cliente potencial",
      "additional_data": [],
      "organization_id": "org123456"
    }
  ],
  "pagination": {
    "page": 1,
    "total_rows": 2,
    "total_pages": 1
  }
}