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

# List Customers

> List all customers

Get a list of all customers for the merchant.

<ParamField path="page" type="integer">
  Page number
</ParamField>

<ParamField path="limit" type="integer">
  Items per page
</ParamField>

<ParamField path="search" type="string">
  Search by email
</ParamField>

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data.customers" type="array">
  Array of customer objects
</ResponseField>

<ResponseField name="data.pagination" type="object">
  Pagination information
</ResponseField>

## Example Request

```bash theme={null}
curl -X GET "https://api.transaction.gg/merchant/customer/list?page=1&limit=10&search=john" \
  -H "Authorization: Bearer jwt_token"
```

## Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "customers": [
      {
        "id": "cus_V6n6SN2KnsIFCuQU",
        "email": "customer@example.com",
        "metadata": {
          "name": "John Doe",
          "phone": "+1234567890"
        },
        "createdAt": "2024-01-01T00:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 1
    }
  }
}
```

## Error Responses

<ResponseExample name="Unauthorized">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "status": 401,
      "code": "UNAUTHORISED",
      "message": "Invalid or missing authentication"
    },
    "data": null
  }
  ```
</ResponseExample>