# Karrier Name Service

## 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="<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>" 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="<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>" 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="<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>" 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="<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>" 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>**.