---
title: "Customers"
description: "Manage customer records (tax numbers, addresses)."
url: https://docs.invoicefalcon.com/api/customers/
api: "API v1 reference"
---

# Customers

Manage customer records (tax numbers, addresses).

## The customer object

- `customer` (object)
  - `addresses` (array of objects)
    - `id` (integer): e.g. `5521`
    - `first_name` (string): e.g. `Jane`
    - `last_name` (string): e.g. `Doe`
    - `company` (string): e.g. `Doe Studio`
    - `address1` (string): e.g. `12 Example Street`
    - `address2` (string): e.g. `Suite 4`
    - `city` (string): e.g. `Springfield`
    - `province` (string): e.g. `Illinois`
    - `country` (string): e.g. `United States`
    - `zip` (string): e.g. `62701`
    - `phone` (string): e.g. `+1 555 010 0199`
    - `address_type` (string): e.g. `billing`

```json
{
  "customer": {
    "id": 9177,
    "email": "jane.doe@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+1 555 010 0199",
    "tax_number": "US-12-3456789",
    "eori_number": null,
    "tags": "wholesale, newsletter",
    "shopify_customer_id": 7001234567,
    "created_at": "2025-09-21T16:45:00Z",
    "updated_at": "2026-01-15T09:30:00Z",
    "addresses": [
      {
        "id": 5521,
        "first_name": "Jane",
        "last_name": "Doe",
        "company": "Doe Studio",
        "address1": "12 Example Street",
        "address2": "Suite 4",
        "city": "Springfield",
        "province": "Illinois",
        "country": "United States",
        "zip": "62701",
        "phone": "+1 555 010 0199",
        "address_type": "billing"
      }
    ]
  }
}
```

## Endpoints

- `GET /customers`: [List customers](https://docs.invoicefalcon.com/api/customers/list-customers.md)
- `POST /customers`: [Create a customer](https://docs.invoicefalcon.com/api/customers/create-a-customer.md)
- `GET /customers/{id}`: [Get a customer](https://docs.invoicefalcon.com/api/customers/get-a-customer.md)
- `PATCH /customers/{id}`: [Update a customer](https://docs.invoicefalcon.com/api/customers/update-a-customer.md)
- `DELETE /customers/{id}`: [Delete a customer](https://docs.invoicefalcon.com/api/customers/delete-a-customer.md)
