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

# List Users

> List all users with pagination

# List Users

Returns a paginated list of users.

<ParamField query="page" type="number" default="1">
  Page number
</ParamField>

<ParamField query="limit" type="number" default="20">
  Items per page (max 100)
</ParamField>

<ParamField query="kycStatus" type="string">
  Filter by KYC status: `pending`, `in_progress`, `verified`
</ParamField>

## Request

```bash theme={null}
curl "https://api.stablepay.global/v2/users?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "usr_abc123",
      "name": "Rahul Kumar",
      "mobile": "+919876543210",
      "email": "rahul@example.com",
      "kycLevel": "basic",
      "kycStatus": "verified",
      "status": "active",
      "depositAddress": "0x742d35Cc...",
      "createdAt": "2025-06-15T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}
```