---
title: "Retrieve customer"
description: "One customer with every address on file and the documents issued to them: how many, and the most recent five with their numbers and sent/paid times. Accepts the Invoice Falcon customer id (a number) or the Shopify custom"
url: https://docs.invoicefalcon.com/v3-reference/customers/retrieve-customer/
api: "API v3 reference"
method: GET
path: "/customers/{id}"
---

# Retrieve customer

`GET https://app.invoicefalcon.com/api/v3/external/customers/{id}`

One customer with every address on file and the documents issued to them: how many, and the most recent five with their numbers and sent/paid times. Accepts the Invoice Falcon customer id (a number) or the Shopify customer gid (gid://shopify/Customer/123). Read-only.

## Path parameters

- `id` (string, required): Invoice Falcon customer id (a number), or the Shopify customer gid gid://shopify/Customer/123.

## Returns

The [customer object](https://docs.invoicefalcon.com/v3-reference/customers/).

Rate limit: this call costs 1 point ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Example request

```sh
curl "https://app.invoicefalcon.com/api/v3/external/customers/32" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
```

## 200

The requested resource.

```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
      }
    ]
  }
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 404

The resource does not exist for this shop, or no action is registered at this path.

```json
{
  "errors": [
    "Resource not found"
  ],
  "code": "not_found"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

