# Get tenant customer details

`GET /public/api/v1.1/Tenants/{tenantId}/Customers/{customerId}`

User API · Customers · base URL `https://user-api.ancon.io` · auth: `Access-Token` header · docs: https://ancon.dev/api/user/customers/get-tenant-customer-details-v1.1

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `tenantId` | string (uuid) | yes |  |
| `customerId` | string (uuid) | yes |  |

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `correlationId` | string | no | Correlation Id for the request |

## Responses

| Status | Description |
| --- | --- |
| 200 | OK |
| 401 | Unauthorized |
| 404 | Not Found |

### 200 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `customer` | object or null | no |  |
| `customer.id` | string (uuid) | no |  |
| `customer.created` | string (date-time) | no |  |
| `customer.modified` | string (date-time) | no |  |
| `customer.identityUserId` | string (uuid) | no |  |
| `customer.firstName` | string or null | no |  |
| `customer.lastName` | string or null | no |  |
| `customer.email` | string or null | no |  |
| `customer.dateOfBirth` | string (date-time) | no |  |
| `customer.gender` | integer (int32) | no | Allowed values: `0`, `1`, `2`, `3`. |
| `customer.telephoneNumber` | string or null | no |  |
| `customer.languageCode` | string or null | no |  |
| `customer.isDeleted` | boolean | no |  |
| `customer.isDisabled` | boolean | no |  |
| `customer.addresses` | array<object> or null | no |  |
| `customer.addresses[].id` | string (uuid) | no |  |
| `customer.addresses[].addressType` | integer (int32) | no | Allowed values: `0`, `1`, `2`. |
| `customer.addresses[].title` | string or null | no |  |
| `customer.addresses[].street` | string or null | no |  |
| `customer.addresses[].zipCode` | string or null | no |  |
| `customer.addresses[].city` | string or null | no |  |
| `customer.addresses[].state` | string or null | no |  |
| `customer.addresses[].country` | string or null | no |  |
| `customer.addresses[].location` | object or null | no |  |
| `customer.addresses[].location.latitude` | number (double) | no |  |
| `customer.addresses[].location.longitude` | number (double) | no |  |
| `customer.addresses[].note` | string or null | no |  |
| `customer.saleAllTime` | array<object> or null | no |  |
| `customer.saleAllTime[].id` | string (uuid) | no |  |
| `customer.saleAllTime[].outletId` | string (uuid) | no |  |
| `customer.saleAllTime[].tenantId` | string (uuid) | no |  |
| `customer.saleAllTime[].totalSpent` | object or null | no |  |
| `customer.saleAllTime[].totalSpent.amount` | number (double) | no |  |
| `customer.saleAllTime[].totalSpent.currency` | string or null | no |  |
| `customer.saleAllTime[].totalOnlineOrders` | integer (int32) | no |  |
| `customer.saleAllTime[].totalPosOrders` | integer (int32) | no |  |
| `customer.saleAllTime[].firstOrder` | string (date-time) or null | no |  |
| `customer.saleAllTime[].lastOrder` | string (date-time) or null | no |  |
| `customer.saleAllTime[].customerOrderFormatSales` | array<object> or null | no |  |
| `customer.saleAllTime[].customerOrderFormatSales[].orderFormat` | integer (int32) | no | Allowed values: `0`, `1`, `2`, `4`, `8`, `16`, `32`, `64`, `128`, `159`, `191`. |
| `customer.saleAllTime[].customerOrderFormatSales[].orderCount` | integer (int32) | no |  |
| `customer.saleAllTime[].customerOrderFormatSales[].totalAmount` | object or null | no |  |
| `customer.saleAllTime[].customerOrderFormatSales[].totalAmount.amount` | number (double) | no |  |
| `customer.saleAllTime[].customerOrderFormatSales[].totalAmount.currency` | string or null | no |  |
| `customer.guestGroups` | array<object> or null | no |  |
| `customer.guestGroups[].tenantId` | string (uuid) | no |  |
| `customer.guestGroups[].guestGroupId` | string (uuid) | no |  |
| `guestGroup` | object or null | no |  |
| `guestGroup.id` | string (uuid) | no |  |
| `guestGroup.name` | string or null | no |  |

#### Example

```json
{
  "customer": {
    "id": "eb9893d5-2c82-4f78-be18-f3e120a7c376",
    "created": "2026-10-23T14:33:35.4737184Z",
    "modified": "2026-10-23T14:33:35.4737184Z",
    "identityUserId": "a4f519b2-13ff-46e0-9b55-e719530d3418",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john@smith.com",
    "dateOfBirth": "1999-10-23T14:33:35.4737191Z",
    "gender": 1,
    "telephoneNumber": "+1 555-123456",
    "languageCode": "en-US",
    "isDeleted": false,
    "isDisabled": false,
    "addresses": [
      {
        "id": "20f87097-c804-4ed1-9cad-4939b54990c5",
        "addressType": 1,
        "title": "Microsoft Corporation",
        "street": "One Microsoft Way",
        "zipCode": "98052-6399",
        "city": "Redmond",
        "state": "Washington",
        "country": "United States of America",
        "location": {
          "latitude": 47.6370891183,
          "longitude": -122.123736172
        },
        "note": "Watch out for Steve Ballmer's ghost."
      },
      {
        "id": "278c6f94-6294-48c3-bad8-5ec36fe0871c",
        "addressType": 1,
        "title": "Google HQ",
        "street": "1600 Amphitheatre Pkwy",
        "zipCode": "94043",
        "city": "Mountain View",
        "state": "CA",
        "country": "United States",
        "location": {
          "latitude": 37.42204695516293,
          "longitude": -122.08549661991442
        },
        "note": "Yes, Google is my second work."
      },
      {
        "id": "07d3bd45-21bf-46c5-b1a2-b3e5632257ef",
        "addressType": 0,
        "title": "The Mansion",
        "street": "The street 1",
        "zipCode": "123 45",
        "city": "Under the Sea",
        "state": null,
        "country": null,
        "location": {
          "latitude": 31.19669,
          "longitude": -38.84766
        },
        "note": "btw, I live under the ocean."
      }
    ],
    "saleAllTime": [
      {
        "id": "c90450e2-bb22-42b1-886a-967ad9636ed0",
        "outletId": "30fcad95-c17f-43a1-953e-eb17fa69df34",
        "tenantId": "cf1e4390-0321-4210-a478-e44e4ac941eb",
        "totalSpent": {
          "amount": 5345,
          "currency": "USD"
        },
        "totalOnlineOrders": 23,
        "totalPosOrders": 105,
        "firstOrder": "2024-10-24T14:33:35.4737112Z",
        "lastOrder": "2025-10-24T14:33:35.4737125Z",
        "customerOrderFormatSales": [
          {
            "orderFormat": 1,
            "orderCount": 105,
            "totalAmount": {
              "amount": 4000,
              "currency": "SEK"
            }
          },
          {
            "orderFormat": 8,
            "orderCount": 23,
            "totalAmount": {
              "amount": 1345,
              "currency": "SEK"
            }
          }
        ]
      },
      {
        "id": "3acba8fa-e10a-4a70-b150-f1fcf01d3ee6",
        "outletId": "888a881e-3759-4ca5-8e42-bcd338dc6ace",
        "tenantId": "cf1e4390-0321-4210-a478-e44e4ac941eb",
        "totalSpent": {
          "amount": 180547,
          "currency": "USD"
        },
        "totalOnlineOrders": 524,
        "totalPosOrders": 1051,
        "firstOrder": "2024-10-25T14:33:35.473715Z",
        "lastOrder": "2025-10-25T14:33:35.4737151Z",
        "customerOrderFormatSales": [
          {
            "orderFormat": 1,
            "orderCount": 551,
            "totalAmount": {
              "amount": 50000,
              "currency": "SEK"
            }
          },
          {
            "orderFormat": 4,
            "orderCount": 500,
            "totalAmount": {
              "amount": 50000,
              "currency": "SEK"
            }
          },
          {
            "orderFormat": 8,
            "orderCount": 23,
            "totalAmount": {
              "amount": 80547,
              "currency": "SEK"
            }
          }
        ]
      },
      {
        "id": "7b175c56-c041-4de3-ad1d-4dcf3958bbe3",
        "outletId": "f2add6e3-860f-469d-945a-1909c8ff4a13",
        "tenantId": "cf1e4390-0321-4210-a478-e44e4ac941eb",
        "totalSpent": {
          "amount": 154,
          "currency": "USD"
        },
        "totalOnlineOrders": 6,
        "totalPosOrders": 0,
        "firstOrder": "2024-10-26T14:33:35.4737168Z",
        "lastOrder": "2025-10-26T14:33:35.4737169Z",
        "customerOrderFormatSales": [
          {
            "orderFormat": 1,
            "orderCount": 6,
            "totalAmount": {
              "amount": 154,
              "currency": "USD"
            }
          }
        ]
      }
    ],
    "guestGroups": null
  },
  "guestGroup": {
    "id": "395b7b8b-f4b5-4e6b-8c7a-a8e3d7c6d547",
    "name": "VIP Guests"
  }
}
```

### 404 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `message` | string or null | no |  |
| `errorCode` | string (uuid) | no |  |

#### Example (from schema)

```json
{
  "message": "string",
  "errorCode": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
```

## Example request

```bash
curl -X GET "https://user-api.ancon.io/public/api/v1.1/Tenants/{tenantId}/Customers/{customerId}" \
  -H "Access-Token: $ANCON_TOKEN"
```