> For the complete documentation index, see [llms.txt](https://docs.karrier.one/karrier-one-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.karrier.one/karrier-one-api/karrier-number-system-api/karrier-name-service.md).

# Karrier Name Service

The Karrier Name Service API allows you to perform forward and reverse lookups between phone numbers and wallet addresses. It supports both single and bulk queries, ensuring efficient integration for

## How It Works

There are four primary endpoints:

1. **Phone Lookup** – Get address details from a single phone number.
2. **Bulk Phone Lookup** – Look up multiple phone numbers at once.
3. **Address Lookup** – Get phone number and additional info from a single wallet address.
4. **Bulk Address Lookup** – Reverse lookup for multiple addresses.

All requests are made using `POST` with JSON payloads, and responses contain relevant mappings or error messages.

## 📱 Phone Lookup – Single

{% openapi src="/files/4zBayxS9nfElgm3yFKwA" path="/nameservice/phone-lookup" method="post" %}
[kns-api-swagger.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2FxyZZSK5cNA1RfsoAFdNT%2Fkns-api-swagger.json?alt=media\&token=51b156bd-e60e-4ddc-b707-02db1d5ee46e)
{% endopenapi %}

## 📞 Phone Lookup – Bulk

{% openapi src="/files/4zBayxS9nfElgm3yFKwA" path="/nameservice/phone-bulk-lookup" method="post" %}
[kns-api-swagger.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2FxyZZSK5cNA1RfsoAFdNT%2Fkns-api-swagger.json?alt=media\&token=51b156bd-e60e-4ddc-b707-02db1d5ee46e)
{% endopenapi %}

## 💳 Wallet Address Lookup – Single

{% openapi src="/files/4zBayxS9nfElgm3yFKwA" path="/nameservice/address-lookup" method="post" %}
[kns-api-swagger.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2FxyZZSK5cNA1RfsoAFdNT%2Fkns-api-swagger.json?alt=media\&token=51b156bd-e60e-4ddc-b707-02db1d5ee46e)
{% endopenapi %}

## 💳 Address Lookup – Bulk

{% openapi src="/files/4zBayxS9nfElgm3yFKwA" path="/nameservice/address-bulk-lookup" method="post" %}
[kns-api-swagger.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2FxyZZSK5cNA1RfsoAFdNT%2Fkns-api-swagger.json?alt=media\&token=51b156bd-e60e-4ddc-b707-02db1d5ee46e)
{% endopenapi %}

### Conclusion

That’s it! The KNS API makes it easy to map phone numbers to wallet addresses and vice versa. If you have any questions or need help, feel free to reach out to **<support@karrier.one>**.