---
title: "Customers"
description: "Customers: List customers, Retrieve customer."
url: https://docs.invoicefalcon.com/v3-reference/customers/
api: "API v3 reference"
---

# Customers

## The customer object

- `id` (integer): e.g. `32`
- `shopify_customer_id` (string): e.g. `gid://shopify/Customer/9001`
- `name` (string): e.g. `Zoe Quinn`
- `first_name` (string): e.g. `Zoe`
- `last_name` (string): e.g. `Quinn`
- `email` (string): e.g. `zoe@example.com`
- `phone` (string, nullable)
- `tax_number` (string): e.g. `DE123`
- `eori_number` (string, nullable)
- `tags` (array of strings)
- `edited_in_app` (boolean): e.g. `false`
- `default_address` (object)
  - `id` (integer): e.g. `587`
  - `kind` (string): e.g. `default_address`
  - `name` (string, nullable)
  - `first_name` (string, nullable)
  - `last_name` (string, nullable)
  - `company` (string): e.g. `Quinn GmbH`
  - `address1` (string): e.g. `1 Main St`
  - `address2` (string, nullable)
  - `city` (string): e.g. `Berlin`
  - `province` (string, nullable)
  - `zip` (string): e.g. `10115`
  - `country` (string): e.g. `Germany`
  - `country_code` (string): e.g. `DE`
  - `phone` (string, nullable)
  - `tax_number` (string, nullable)
  - `eori_number` (string, nullable)
- `created_at` (string): e.g. `2026-11-10T08:50:31Z`
- `updated_at` (string): e.g. `2026-11-10T08:50:31Z`
- `note` (string, nullable)
- `addresses` (array of objects)
  - `id` (integer): e.g. `587`
  - `kind` (string): e.g. `default_address`
  - `name` (string, nullable)
  - `first_name` (string, nullable)
  - `last_name` (string, nullable)
  - `company` (string): e.g. `Quinn GmbH`
  - `address1` (string): e.g. `1 Main St`
  - `address2` (string, nullable)
  - `city` (string): e.g. `Berlin`
  - `province` (string, nullable)
  - `zip` (string): e.g. `10115`
  - `country` (string): e.g. `Germany`
  - `country_code` (string): e.g. `DE`
  - `phone` (string, nullable)
  - `tax_number` (string, nullable)
  - `eori_number` (string, nullable)
- `documents` (object)
  - `count` (integer): e.g. `1`
  - `recent` (array of objects)
    - `id` (integer): e.g. `980191020`
    - `type` (string): e.g. `invoice`
    - `number` (string): e.g. `INV-9`
    - `shopify_order_id` (string): e.g. `gid://shopify/Order/1`
    - `created_at` (string): e.g. `2026-11-10T08:50:31Z`
    - `sent_at` (string): e.g. `2026-01-02T00:00:00Z`
    - `paid_at` (string, nullable)

```json
{
  "id": 32,
  "shopify_customer_id": "gid://shopify/Customer/9001",
  "name": "Zoe Quinn",
  "first_name": "Zoe",
  "last_name": "Quinn",
  "email": "zoe@example.com",
  "phone": null,
  "tax_number": "DE123",
  "eori_number": null,
  "tags": [
    "vip",
    "wholesale"
  ],
  "edited_in_app": false,
  "default_address": {
    "id": 587,
    "kind": "default_address",
    "name": null,
    "first_name": null,
    "last_name": null,
    "company": "Quinn GmbH",
    "address1": "1 Main St",
    "address2": null,
    "city": "Berlin",
    "province": null,
    "zip": "10115",
    "country": "Germany",
    "country_code": "DE",
    "phone": null,
    "tax_number": null,
    "eori_number": null
  },
  "created_at": "2026-11-10T08:50:31Z",
  "updated_at": "2026-11-10T08:50:31Z",
  "note": null,
  "addresses": [
    {
      "id": 587,
      "kind": "default_address",
      "name": null,
      "first_name": null,
      "last_name": null,
      "company": "Quinn GmbH",
      "address1": "1 Main St",
      "address2": null,
      "city": "Berlin",
      "province": null,
      "zip": "10115",
      "country": "Germany",
      "country_code": "DE",
      "phone": null,
      "tax_number": null,
      "eori_number": null
    }
  ],
  "documents": {
    "count": 1,
    "recent": [
      {
        "id": 980191020,
        "type": "invoice",
        "number": "INV-9",
        "shopify_order_id": "gid://shopify/Order/1",
        "created_at": "2026-11-10T08:50:31Z",
        "sent_at": "2026-01-02T00:00:00Z",
        "paid_at": null
      }
    ]
  }
}
```

## Endpoints

- `GET /customers`: [List customers](https://docs.invoicefalcon.com/v3-reference/customers/list-customers.md)
- `GET /customers/{id}`: [Retrieve customer](https://docs.invoicefalcon.com/v3-reference/customers/retrieve-customer.md)
