Caller ID and attestation
Which numbers you can call from, what Linq checks on every call, and how attestation affects how your calls are shown.
Outbound calling is in early access. Contact Linq to turn it on for your numbers.
Caller ID
Section titled “Caller ID”The caller ID on an outbound call must be a Linq number on your account. Put it
in the user part of the From header, in E.164: for example
+14155550100.
Linq checks the caller ID on every call. To pass the check, for each number you call from:
- Use a number on your account.
- Set it up for voice: assign a SIP profile to it (Assign numbers).
- Make sure it’s published. Assigning a SIP profile to a number that isn’t
published fails with
2033(API errors during setup). - Use SIP credentials from the same environment as the number. It’s the same
environment match as for your API key, which fails with
2006when you assign a SIP profile (API errors during setup).
If the check fails, Linq refuses the call with 403. The call doesn’t reach
the phone network.
You can’t send a different caller ID. Linq sends the number it checked, and
replaces any caller-identity headers your platform sends, such as
P-Asserted-Identity, with that number.
Call from the number people know
Section titled “Call from the number people know”Call people from the Linq number they already know, such as the number you text them from. People are more likely to ignore calls from numbers they don’t recognise, and their phones may silence them.
You set the caller ID on each call. If your account has many Linq numbers, look up the number that person already knows and send that one.
Attestation
Section titled “Attestation”Attestation is the STIR/SHAKEN rating that tells the called network how sure the carrier is that you may use the caller ID. There are three levels:
| Level | What it means |
|---|---|
| A (full) | The signing carrier knows the customer placing the call, and that they may use the caller ID. |
| B (partial) | The signing carrier knows the customer, but not that they may use the caller ID. |
| C (gateway) | The signing carrier knows only where the call entered its network. |
The called party’s carrier uses the level, with other signals, to decide how to show the call, for example as verified or with a warning label. A call with a low level may not reach the person.
Linq aims for attestation A or B on outbound calls. At first, calls may carry a lower level, including C; while they do, the called party’s carrier may show a warning or not put the call through.
For inbound calls, the caller’s carrier sets the attestation. Linq passes it to you unchanged. Caller ID can be spoofed. Don’t use the caller’s number alone to identify or authenticate a caller.