Description
n8n-nodes-number-lookup-api
This is an n8n community node. It lets you use Sinch Number Lookup API in your n8n workflows.
Sinch Number Lookup API provides real-time phone number validation and verification services. With quick and easy access to Number Lookup, you can enhance your communications and keep your database clean. The API checks against first-party numbering sources and provides real-time feedback to improve communication by validating and verifying numbers, boosting delivery conversion rates, and saving money on marketing campaigns.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
Lookup
Performs a comprehensive number lookup operation. You can select one or more features to include in the lookup request:
- Line Type: Identify the type of phone line (mobile, landline, VoIP, etc.) including carrier information and porting status
- SIM Swap: Detect if the SIM card has been swapped recently (configurable time periods from 4 hours to 30 days)
- VoIP Detection: Check if the number is a VoIP (Voice over IP) number with probability scoring
- RND (Reassigned Number Database): Determine if the number has been reassigned to a new subscriber since your last contact date
Credentials
This node uses OAuth2 (Client Credentials) authentication. To set up credentials:
Prerequisites
1. Sign up for a Sinch account
2. Create a new project in the Sinch Dashboard
3. Navigate to APIs → Number Lookup to enable the API
4. Go to Settings → Access Keys to obtain your credentials
Setting up credentials in n8n
1. In n8n, create new credentials of type “Sinch Number Lookup Api OAuth2 API”
2. Fill in the following fields:
– Project ID: Your Sinch project ID (UUID format, e.g., 395fcbf6-20d6-4e76-8242-77106018e191)
– Client ID: Your access key ID from Sinch Dashboard
– Client Secret: Your access key secret from Sinch Dashboard
3. Click “Connect” to authenticate
The credentials use the Sinch OAuth2 token endpoint (https://auth.sinch.com/oauth2/token) with client credentials grant type.
Compatibility
This node has been tested with n8n v1.0+ and uses the n8n nodes API v1.
Usage
Basic Number Lookup
1. Add the Sinch Number Lookup Api node to your workflow
2. Configure your credentials
3. Enter your Project ID (the UUID of your Sinch project)
4. Enter a phone number in E.164 format (e.g., +48123321123)
– Must start with + followed by country code and number
– No spaces, dashes, or other formatting
5. Select one or more Features to query
6. Execute the node
Using the RND (Reassigned Number Database) Feature
When using the RND feature, you must provide a Contact Date:
1. Select “RND” from the Features list
2. A Contact Date field will appear
3. Enter the date when you last contacted this number
4. The API will check if the number was reassigned after that date
Example Workflow
Manual Trigger → Sinch Number Lookup Api → IF (check results)
Use the lookup results to:
Response Data
The node returns comprehensive information about the queried number:
{
"number": "+12312312312",
"countryCode": "US",
"line": {
"type": "Mobile",
"carrier": "T-Mobile USA",
"mobileCountryCode": "310",
"mobileNetworkCode": "260",
"ported": true,
"portingDate": "2023-01-15T00:00:00Z"
},
"simSwap": {
"swapped": false,
"swapPeriod": "SP24H"
},
"voIPDetection": {
"probability": "Low"
},
"rnd": {
"disconnected": false
},
"traceId": "84c1fd4063c38d9f3900d06e56542d48"
}
