Caller Verification API
The Caller Verification API enables verification of phone call integrity and user registration by using JWT signatures and mapping phone numbers to object IDs.
How It Works
This API offers two primary endpoints:
Call Signature Verification – Verify a JWT signature between caller and callee numbers.
Object ID Lookup – Retrieve a KNS object ID associated with a phone number.
Both endpoints use POST with JSON payloads and require API key authorization.
📞 Call Signature Verification
post
Authorizations
Body
all ofOptional
Responses
200
Ok
application/json
400Error
application/json
post
/kns/call-signature-verificationPOST /kns/call-signature-verification HTTP/1.1
Host: kns-api.karrier.one
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 75
{
"origTN": "+14445551234",
"destTN": "+14445551234",
"jwt": "text",
"debug": true
}{
"success": true
}🆔 Object ID Lookup
post
Authorizations
Body
phoneNumberstring · E.164RequiredExample:
The user's phone number in E.164 format.
+14445551234Pattern: ^\+?[1-9]\d{5,14}$Responses
200
Ok
application/json
400Error
application/json
post
/kns/object-id-lookupPOST /kns/object-id-lookup HTTP/1.1
Host: kns-api.karrier.one
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 30
{
"phoneNumber": "+14445551234"
}{
"objectId": "0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82",
"registries": [
"0xa8c5cda072275d83ea87c6ee357edb344fa243aab071d552bdc4a7d69f741d82"
]
}Conclusion
The Caller Verification API makes verifying call authenticity and resolving phone numbers to KNS objects seamless. For questions or help, contact [email protected].
🔗 Reference
Last updated