Quick Start
This section covers the minimum needed to make your first call for each signal. Full endpoint details are in “Endpoint reference” section.
Before you start: you need your API key. Contact your tyntec account manager to receive it. All requests require the apiKey header.
Step 1 — Check SIM Swap
Query whether the phone number’s SIM has changed within a lookback window (default 240 minutes, maximum 2400 minutes).
POST https://api.tyntec.com/network-signal/v1/sim-swap/check
Content-Type: application/json
apiKey: <your_api_key>
{
"phoneNumber": "+491234567890",
"maxAge": 240
}
Response:
{ "swapped": true }Action: if swapped=true, do not send an OTP. Require step-up authentication or block the action.
Step 2 — Check Call Forwarding
Query whether unconditional call forwarding is currently active on the line. No lookback window — this is a real-time status check.
POST https://api.tyntec.com/network-signal/v1/call-forwarding/unconditional/check
Content-Type: application/json
apiKey: <your_api_key>
{
"phoneNumber": "+491234567890"
}
Response:
{ "active": true }Action: if active=true, do not send an OTP via voice. The message will be received by the forwarding destination, not the legitimate user.
Step 3 — Check Device Swap
Query whether the subscriber’s handset has changed within a lookback window.
POST https://api.tyntec.com/network-signal/v1/device-swap/check
Content-Type: application/json
apiKey: <your_api_key>
{
"phoneNumber": "+491234567890",
"maxAge": 240
}
Response:
{ "swapped": true }Note: Device Swap alone is a lower-risk signal than SIM Swap. Use it as a compound signal alongside SIM Swap for higher confidence fraud detection.