Skip to main content
Use contact lookup before sending when you want to confirm that the recipient exists and can receive messages. Requires contacts.lookup scope.

​
Lookup By Phone

curl "https://{tenant}.sinjapp.org/api/v1/contacts/lookup?phone={recipient_phone}&sender_phone={sender_phone}" \
  -H "X-Api-Key: {tenant_api_key}" \
  -H "Accept: application/json"

​
Response

{
  "exists": true,
  "can_receive": true,
  "reason_code": "ok",
  "recipient_id": 123,
  "is_verified": true,
  "phone_verified_at": "2026-04-28T10:00:00Z"
}
If can_receive is false, do not send the message. Show the reason to your operator or retry after the recipient fixes their Sinjapp account state.