> ## Documentation Index
> Fetch the complete documentation index at: https://docs.partnero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get customer

> Retrieve a specific customer's details and tags in your affiliate program

## Endpoint

```
GET https://api.partnero.com/v1/customers/{key}
```

## Path parameters

| Parameter | Type   | Required | Description           |
| --------- | ------ | -------- | --------------------- |
| `key`     | string | Yes      | Customer's unique key |

## Request

```bash cURL theme={null}
curl --location 'https://api.partnero.com/v1/customers/customer_123' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "key": "customer_123",
      "partner": "partner_123",
      "deleted": false,
      "name": "Alice",
      "surname": "Brown",
      "email": "alice.brown@partnero.com",
      "status": "active",
      "created_at": "2025-05-02T16:12:39.000000Z",
      "updated_at": "2025-05-02T16:12:39.000000Z",
      "deleted_at": null,
      "tags": [
        {
          "value": "premium"
        }
      ]
    },
    "status": 1
  }
  ```
</ResponseExample>

### Response fields

<Accordion title="Customer — data">
  | Field        | Type         | Description                             |
  | ------------ | ------------ | --------------------------------------- |
  | `key`        | string       | Unique customer identifier              |
  | `email`      | string       | Customer's email address                |
  | `name`       | string       | Customer's first name                   |
  | `surname`    | string       | Customer's last name                    |
  | `partner`    | string       | Key of the referring partner            |
  | `status`     | string       | Customer status                         |
  | `deleted`    | boolean      | Whether customer is soft-deleted        |
  | `tags`       | array        | Customer tags (each with a `value` key) |
  | `created_at` | string       | ISO 8601 timestamp                      |
  | `updated_at` | string       | ISO 8601 timestamp                      |
  | `deleted_at` | string\|null | Deletion timestamp if deleted           |
</Accordion>

## Get customer transactions

Retrieve all transactions for a specific customer:

```
GET https://api.partnero.com/v1/customers/{key}/transactions
```

```bash cURL theme={null}
curl --location 'https://api.partnero.com/v1/customers/customer_123/transactions' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```