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

# User Lookups

> Retrieve the users (handles) looked up this month. Users are tracked when you pass the userId or userName fields to the analytics or history endpoints.

Retrieve the users (handles) looked up for the current month.
Users tracked when using the `userId` or `userName` fields for the analytics or history endpoints.

## Header Parameters

**Authorization** `string` *required*

[API Key](https://www.ayrshare.com/docs/apis/overview.md#authorization) of the Primary Profile.

Format: `Authorization: Bearer API_KEY`

```json 200: Current Month User Lookups theme={"system"}
{
    "x": [
        {
            "userId": "1322691",
            "userName": "neilpatel",
            "name": "Neil Patel"
        },
        {
            "userId": "20536157",
            "userName": "Google",
            "name": "Google"
        }
    ]
}
```

```json 403: Unauthorized theme={"system"}
{
  "action": "request",
  "status": "error",
  "code": 3,
  "message": "You do not have permission to access this resource. Please contact us to get access."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.