> For the complete documentation index, see [llms.txt](https://docs.openvessel.io/integration/EZzgG67O9oXGl9CReheF/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openvessel.io/integration/EZzgG67O9oXGl9CReheF/game-api/users.md).

# Users

{% hint style="info" %} <mark style="color:red;">\*</mark> is a required field
{% endhint %}

## User Lookup

### Lookup all users who own the token in the collection

{% openapi src="/files/HajKA5xZvO5SYYbfx35H" path="/users/{fqGn}/{qCn}/" method="get" %}
[1009\_Vessel\_prod.json](https://1785276440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlS5g6RKJvRGb_KKP5m%2Fuploads%2FtIKhwzoW0fObLFwqU4WK%2F1009_Vessel_prod.json?alt=media\&token=a1353f5d-201e-4e43-8448-2468aa861158)
{% endopenapi %}

### Lookup all users who own the token

{% openapi src="/files/HajKA5xZvO5SYYbfx35H" path="/users/{fqGn}/{qCn}/{qTn}" method="get" %}
[1009\_Vessel\_prod.json](https://1785276440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlS5g6RKJvRGb_KKP5m%2Fuploads%2FtIKhwzoW0fObLFwqU4WK%2F1009_Vessel_prod.json?alt=media\&token=a1353f5d-201e-4e43-8448-2468aa861158)
{% endopenapi %}

## User Token Lookup

### Lookup all tokens in the game by the user

{% openapi src="/files/HajKA5xZvO5SYYbfx35H" path="/user/{address}/tokens/{fqGn}/" method="get" %}
[1009\_Vessel\_prod.json](https://1785276440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlS5g6RKJvRGb_KKP5m%2Fuploads%2FtIKhwzoW0fObLFwqU4WK%2F1009_Vessel_prod.json?alt=media\&token=a1353f5d-201e-4e43-8448-2468aa861158)
{% endopenapi %}

### Lookup all tokens in the collection by the user

{% openapi src="/files/HajKA5xZvO5SYYbfx35H" path="/user/{address}/tokens/{fqGn}/{qCn}/" method="get" %}
[1009\_Vessel\_prod.json](https://1785276440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlS5g6RKJvRGb_KKP5m%2Fuploads%2FtIKhwzoW0fObLFwqU4WK%2F1009_Vessel_prod.json?alt=media\&token=a1353f5d-201e-4e43-8448-2468aa861158)
{% endopenapi %}

### Lookup the details about the user token

{% openapi src="/files/HajKA5xZvO5SYYbfx35H" path="/user/{address}/tokens/{fqGn}/{qCn}/{qTn}" method="get" %}
[1009\_Vessel\_prod.json](https://1785276440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlS5g6RKJvRGb_KKP5m%2Fuploads%2FtIKhwzoW0fObLFwqU4WK%2F1009_Vessel_prod.json?alt=media\&token=a1353f5d-201e-4e43-8448-2468aa861158)
{% endopenapi %}

### Token Object

<table><thead><tr><th width="165">Name</th><th width="103">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>fqTn</code></td><td><code>string</code></td><td><a href="/pages/14mcBCWRrAg06tiT6561#qualified-names">Fully qualified</a> token name</td></tr><tr><td><code>totalSupply</code></td><td><code>number</code></td><td>Total number of minted tokens</td></tr><tr><td><code>amount</code></td><td><code>number</code></td><td>Number of tokens user owns</td></tr></tbody></table>