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

# User Role

## Endpoint

```
POST /info
```

## Request Body

| Parameter | Type   | Description                                                                              |
| --------- | ------ | ---------------------------------------------------------------------------------------- |
| `type`\*  | string | Must be `"userRole"`                                                                     |
| `user`\*  | string | Address to check (case-insensitive), e.g., `"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"` |

## Response

The response varies based on the address role:

### User Account

```json theme={null}
{
  "role": "user"
}
```

### API Wallet Agent

```json theme={null}
{
  "role": "agent",
  "data": {
    "user": "0x1234567890abcdef..."
  }
}
```

### Address Not Found

```json theme={null}
{
  "role": "missing"
}
```

### Response Fields

| Field       | Type   | Description                               |
| ----------- | ------ | ----------------------------------------- |
| `role`      | string | Role type ("user", "agent", or "missing") |
| `data.user` | string | Main user address (only for "agent" role) |

## Example Request

```bash theme={null}
curl -X POST https://api.notional.xyz/info \
  -H "Content-Type: application/json" \
  -d '{
    "type": "userRole",
    "user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  }'
```

## Error Responses

```json theme={null}
{
  "error": "Missing 'user' parameter"
}
```

**HTTP Status:** 400 Bad Request

## Notes

<Note>
  * Role values: `"user"`, `"agent"`, `"missing"` - Agents link to exactly one user via `data.user`
    field - Address lookup is case-insensitive
</Note>