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

post

Body

phoneNumberstring · E.164Required

The user's phone number in E.164 format.

Example: [phone]Pattern: ^\+?[1-9]\d{5,14}$

Responses

200

Ok

application/json

addressstring · string · min: 66 · max: 66Required

The wallet address

Example: 0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82Pattern: ^0x[0-9a-fA-F]{64}$

defaultNSbooleanRequired

Whether the this is the default entry for the address

errorstringOptional

400Error

application/json

post/nameservice/phone-lookup

POST /nameservice/phone-lookup HTTP/1.1
Host: kns-api.karrier.one
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "phoneNumber": "[phone]"
}

{
  "address": "0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82",
  "defaultNS": true,
  "error": "text"
}

📞 Phone Lookup – Bulk

post

Body

phoneNumbersstring[]Required

The user's phone number in E.164 format

Responses

200

Ok

application/json

addressstring · string · min: 66 · max: 66Required

The wallet address

Example: 0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82Pattern: ^0x[0-9a-fA-F]{64}$

defaultNSbooleanRequired

Whether the this is the default entry for the address

errorstringOptional

400Error

application/json

post/nameservice/phone-bulk-lookup

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

post

Body

addressstring · string · min: 66 · max: 66Required

The address to reverse lookup

Example: 0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82Pattern: ^0x[0-9a-fA-F]{64}$

Responses

200

Ok

application/json

phoneNumberstring · E.164Required

The user's phone number in E.164 format.

Example: [phone]Pattern: ^\+?[1-9]\d{5,14}$

suinsbooleanRequired

Whether the address has SUINS enabled

errorstringOptional

400Error

application/json

post/nameservice/address-lookup

POST /nameservice/address-lookup HTTP/1.1
Host: kns-api.karrier.one
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "address": "0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82"
}

{
  "phoneNumber": "[phone]",
  "suins": true,
  "error": "text"
}

💳 Address Lookup – Bulk

post

Body

addressesstring[]Required

The SUI addresses to reverse lookup

Responses

200

Ok

application/json

phoneNumberstring · E.164Required

The user's phone number in E.164 format.

Example: [phone]Pattern: ^\+?[1-9]\d{5,14}$

suinsbooleanRequired

Whether the address has SUINS enabled

errorstringOptional

400Error

application/json

post/nameservice/address-bulk-lookup

POST /nameservice/address-bulk-lookup HTTP/1.1
Host: kns-api.karrier.one
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "addresses": [
    "text"
  ]
}

[
  {
    "phoneNumber": "[phone]",
    "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 [e-mail].