# Caller Verification API

### How It Works

This API offers two primary endpoints:

1. **Call Signature Verification** – Verify a JWT signature between caller and callee numbers.
2. **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

{% 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="/kns/call-signature-verification" 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 %}

## 🆔 Object ID Lookup

{% 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="/kns/object-id-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

The Caller Verification API makes verifying call authenticity and resolving phone numbers to KNS objects seamless. For questions or help, contact <support@karrier.one>.

### 🔗 Reference

{% file 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>" %}
Karrier Number System OpenAPI Specification
{% endfile %}