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:
Phone Lookup – Get address details from a single phone number.
Bulk Phone Lookup – Look up multiple phone numbers at once.
Address Lookup – Get phone number and additional info from a single wallet address.
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
The user's phone number in E.164 format.
+14445551234Pattern: ^\+?[1-9]\d{5,14}$Ok
POST /nameservice/phone-lookup HTTP/1.1
Host: kns-api.karrier.one
Content-Type: application/json
Accept: */*
Content-Length: 30
{
"phoneNumber": "+14445551234"
}{
"address": "0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82",
"defaultNS": true,
"error": "text"
}📞 Phone Lookup – Bulk
The user's phone number in E.164 format
Ok
POST /nameservice/phone-bulk-lookup HTTP/1.1
Host: kns-api.karrier.one
Content-Type: application/json
Accept: */*
Content-Length: 25
{
"phoneNumbers": [
"text"
]
}[
{
"address": "0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82",
"defaultNS": true,
"error": "text"
}
]💳 Wallet Address Lookup – Single
The address to reverse lookup
0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82Pattern: ^0x[0-9a-fA-F]{64}$Ok
POST /nameservice/address-lookup HTTP/1.1
Host: kns-api.karrier.one
Content-Type: application/json
Accept: */*
Content-Length: 80
{
"address": "0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82"
}{
"phoneNumber": "+14445551234",
"suins": true,
"error": "text"
}💳 Address Lookup – Bulk
The SUI addresses to reverse lookup
Ok
POST /nameservice/address-bulk-lookup HTTP/1.1
Host: kns-api.karrier.one
Content-Type: application/json
Accept: */*
Content-Length: 22
{
"addresses": [
"text"
]
}[
{
"phoneNumber": "+14445551234",
"suins": true,
"error": "text"
}
]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 [email protected].
Last updated