Bulk Device Lookup

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

The Bulk Device Lookup API allows you to look up the RCS capability of multiple mobile devices in a single request.

📘

Note:

Numbers are validated for E.164 format, deduplicated, and only valid unique numbers are sent in the request.

E.164 Validation and Normalization

The following points must be considered for E.164 validation and normalization:

  • Numbers without a + prefix are automatically normalized. For example. The number gets normalized from 917XXXXX2804 to +917XXXXX2804 automatically.
  • Numbers must have 7–15 digits after the + prefix, with the first digit being in the range of 1 to 9.
  • Empty strings, whitespace-only strings, and numbers not matching E.164 are filtered as invalid.
  • Duplicate numbers get removed after validation.
  • Only valid and unique numbers are sent in the request.

Limitations

The following are the limitations for the bulk device lookup:

  • After E.164 validation and deduplication, there must be at least 100 unique valid numbers. For lesser numbers, use the single lookup endpoint.
  • The current threshold for bulk device lookup ranges from 100 to 500 devices.

Prerequisites

  • After you sign up, your account will be on the trial version. You must complete the KYC to access all the features in kaleyra.io.
  • Before you get started, Create an API Key. To view the API Key and the SID, see View API Key and SID.
  • To send any RCS messages, you must configure the RCS channel in the Kaleyra platform. To configure the RCS channel in your account, please contact your local Kaleyra representative.
Path Params
string
required

Account SID (Security Identifier).

Body Params

List of phone numbers to look up.

The submitted list is validated for E.164 format and deduplicated.
Only valid unique numbers are sent to the provider.

At least 100 unique valid numbers and at most 500 unique valid
numbers are supported after validation and deduplication.

Request payload for bulk device lookup.

The deviceAddresses array must contain phone numbers in E.164 format.
After validation and deduplication, between 100 and 500 unique valid
numbers are supported.

deviceAddresses
array of strings
required
length between 1 and 500

List of phone numbers in E.164 format.

Numbers without a '+' prefix are automatically normalized.
Numbers must have 7–15 digits after the '+' prefix, with the
first digit being in the range 1–9.

Empty strings, whitespace-only strings, and numbers not matching
E.164 are filtered as invalid.

Duplicate numbers are removed after validation.

Only valid and unique numbers are sent to the provider.

Kaleyra requires a minimum of 100 and maximum of 500 unique
valid numbers after validation and deduplication.

deviceAddresses*
Headers
string
required

API key generated from the Kaleyra.io account.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json



© 2026 Kaleyra Inc. All rights reserved.
Trademarks, logos and service marks displayed on this site are registered and unregistered trademarks of Kaleyra Inc.