# uid (/docs/query/uid)

**Category:** Neurons & registration

## Parameters [#parameters]

| Parameter     | Type    | Description                  |
| ------------- | ------- | ---------------------------- |
| `hotkey_ss58` | string  | Hotkey whose UID to look up. |
| `netuid`      | integer | Subnet to query.             |

## CLI [#cli]

```bash
btcli query uid --hotkey <ss58|name> --netuid <integer> --json
```

## Python [#python]

Namespace method (autocomplete, signature help):

```python
import bittensor as bt

sub = bt.Subtensor()
result = sub.neurons.uid(hotkey_ss58="5F...", netuid=1)
```

Or dispatch by name, as an agent would:

```python
result = sub.read("uid", hotkey_ss58="5F...", netuid=1)
```

Async is the same surface awaited: `async with bt.Subtensor() as client:`.

## On-chain implementation [#on-chain-implementation]

* Storage [`SubtensorModule.Uids`](/code/pallets/subtensor/src/lib.rs#L2430)

Every file is browsable under [/code](/code) exactly as built into the runtime.