Connect

Connect your application to the mobile network for real-time fraud detection and frictionless authentication. Query SIM swap, call forwarding, and device swap signals before every sensitive action — or go fully passwordless with Silent Authentication, which verifies users automatically in the background without sending a single OTP. Simple API calls, no user interaction required.

API Reference

Appendix A — cURL Examples

The following examples are based on the API reference. All endpoints use POST. Authentication requires the apiKey header.

A.1 POST /sim-swap/check

POST https://api.tyntec.com/network-signal/v1/sim-swap/check
Content-Type: application/json
Accept: application/json
apiKey: API_KEY

{
  "phoneNumber": "+491234567890",
  "maxAge": 240
}

200 Response:

{
  "swapped": true
}

A.2 POST /sim-swap/retrieve-date

POST https://api.tyntec.com/network-signal/v1/sim-swap/retrieve-date
Content-Type: application/json
Accept: application/json
apiKey: API_KEY

{
  "phoneNumber": "+491234567890"
}

200 Response:

{
  "latestSimChange": "2024-09-18T07:37:53.471829447Z"
}

A.3 POST /device-swap/check

POST https://api.tyntec.com/network-signal/v1/device-swap/check
Content-Type: application/json
Accept: application/json
apiKey: API_KEY

{
  "phoneNumber": "+491234567890",
  "maxAge": 240
}

200 Response:

{
  "swapped": true
}

A.4 POST /device-swap/retrieve-date

POST https://api.tyntec.com/network-signal/v1/device-swap/retrieve-date
Content-Type: application/json
Accept: application/json
apiKey: API_KEY

{
  "phoneNumber": "+491234567890"
}

200 Response:

{
  "latestDeviceChange": "2024-09-18T07:37:53.471829447Z"
}

A.5 POST /call-forwarding/unconditional/check

POST https://api.tyntec.com/network-signal/v1/call-forwarding/unconditional/check
Content-Type: application/json
Accept: application/json
apiKey: API_KEY

{
  "phoneNumber": "+491234567890"
}

200 Response:

{
  "active": true
}

Appendix B — Error Code Reference

Error response structure (from API reference):

{
  "status": 400,
  "code": "INVALID_ARGUMENT",
  "message": "Client specified an invalid argument, request body or query param."
}

 

Status / Code Message
200  OK Successful response.
400  INVALID_ARGUMENT Client specified an invalid argument, request body or query param.
400  OUT_OF_RANGE Client specified an invalid range.
401  UNAUTHENTICATED Request not authenticated due to missing, invalid, or expired credentials. A new authentication is required.
403  PERMISSION_DENIED Client does not have sufficient permissions to perform this action.
404  NOT_FOUND The specified resource is not found.
500  INTERNAL_SERVER_ERROR Request could not be processed.