Customers

curl -X POST https://api.epd.com/v1/customers \
  -H "Authorization: Bearer epd_test_sk_xxxx" \
  -H "Content-Type: application/json" \
  -H "EPD-Version: 2026-02-11" \
  -d '{
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+14155551234",
    "company": "Acme Corp"
  }'

const response = await fetch('https://api.epd.com/v1/customers', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer epd_test_sk_xxxx',
    'Content-Type': 'application/json',
    'EPD-Version': '2026-02-11',
  },
  body: JSON.stringify({
    email: 'john@example.com',
    first_name: 'John',
    last_name: 'Doe',
    phone: '+14155551234',
    company: 'Acme Corp',
  }),
});

const customer = await response.json();
console.log(customer.id); // 550e8400-e29b-41d4-a716-446655440000

import requests

response = requests.post(
    'https://api.epd.com/v1/customers',
    headers={
        'Authorization': 'Bearer epd_test_sk_xxxx',
        'EPD-Version': '2026-02-11',
    },
    json={
        'email': 'john@example.com',
        'first_name': 'John',
        'last_name': 'Doe',
        'phone': '+14155551234',
        'company': 'Acme Corp',
    }
)

customer = response.json()
print(customer['id'])  # 550e8400-e29b-41d4-a716-446655440000

$ch = curl_init('https://api.epd.com/v1/customers');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer epd_test_sk_xxxx',
        'Content-Type: application/json',
        'EPD-Version: 2026-02-11',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'email' => 'john@example.com',
        'first_name' => 'John',
        'last_name' => 'Doe',
        'phone' => '+14155551234',
    ]),
]);

$response = json_decode(curl_exec($ch), true);
echo $response['id']; // 550e8400-e29b-41d4-a716-446655440000

# List first 20 customers
curl https://api.epd.com/v1/customers?limit=20 \
  -H "Authorization: Bearer epd_test_sk_xxxx" \
  -H "EPD-Version: 2026-02-11"

# Search by email
curl "https://api.epd.com/v1/customers?email=john@example.com" \
  -H "Authorization: Bearer epd_test_sk_xxxx"

# Full-text search with date filter
curl "https://api.epd.com/v1/customers?q=acme&created_at[gte]=2024-01-01" \
  -H "Authorization: Bearer epd_test_sk_xxxx"

// List customers with pagination
const params = new URLSearchParams({
  limit: '20',
  expand: 'payment_methods',
});

const response = await fetch(
  `https://api.epd.com/v1/customers?${params}`,
  {
    headers: {
      'Authorization': 'Bearer epd_test_sk_xxxx',
      'EPD-Version': '2026-02-11',
    },
  }
);

const { data, has_more, cursors } = await response.json();

// Get next page
if (has_more) {
  const nextPage = await fetch(
    `https://api.epd.com/v1/customers?limit=20&starting_after=${cursors.next}`,
    { headers: { 'Authorization': 'Bearer epd_test_sk_xxxx' } }
  );
}

import requests

# List customers with filters
response = requests.get(
    'https://api.epd.com/v1/customers',
    headers={
        'Authorization': 'Bearer epd_test_sk_xxxx',
        'EPD-Version': '2026-02-11',
    },
    params={
        'limit': 20,
        'expand': 'payment_methods',
        'created_at[gte]': '2024-01-01',
    }
)

result = response.json()
customers = result['data']

# Iterate through all pages
while result['has_more']:
    response = requests.get(
        'https://api.epd.com/v1/customers',
        headers={'Authorization': 'Bearer epd_test_sk_xxxx'},
        params={
            'limit': 20,
            'starting_after': result['cursors']['next'],
        }
    )
    result = response.json()
    customers.extend(result['data'])

# Basic retrieval
curl https://api.epd.com/v1/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer epd_test_sk_xxxx"

# With expanded payment methods
curl "https://api.epd.com/v1/customers/550e8400-e29b-41d4-a716-446655440000?expand=payment_methods" \
  -H "Authorization: Bearer epd_test_sk_xxxx"

const response = await fetch(
  'https://api.epd.com/v1/customers/550e8400-e29b-41d4-a716-446655440000?expand=payment_methods',
  {
    headers: { 'Authorization': 'Bearer epd_test_sk_xxxx' },
  }
);

const customer = await response.json();
console.log(customer.email);
console.log(customer.payment_methods); // expanded

curl -X PATCH https://api.epd.com/v1/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer epd_test_sk_xxxx" \
  -H "Content-Type: application/json" \
  -H "X-EPD-Idempotency-Key: $(uuidgen)" \
  -d '{
    "email": "newemail@example.com",
    "metadata": { "tier": "enterprise" }
  }'

const response = await fetch('https://api.epd.com/v1/customers/550e8400-e29b-41d4-a716-446655440000', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer epd_test_sk_xxxx',
    'Content-Type': 'application/json',
    'X-EPD-Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    email: 'newemail@example.com',
    metadata: { tier: 'enterprise' },
  }),
});

const customer = await response.json();