Search for Results

post

https://api.commpeak.com/lookup/search_results

Search per-number lookup results across past tasks. Filter by phone number (exact, prefix or substring), task IDs, task creation date range, lookup type, validation outcome, number type, country, and ported / roaming flags. Paginate with limit and skip; set with_totals=1 to also get total, unique, invalid and mobile counts.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Filter payload for POST /lookup/search_results. All fields are optional — supply only the ones you want to filter on.

key

Exact-match phone number (E.164 without leading "+").

key_start

Phone-number prefix match (e.g. "1212" for New York).

key_contains

Substring match anywhere in the phone number.

job_ids

array | null

Restrict the search to results produced by these task ids.

keys

array | null

Restrict the search to this set of phone numbers.

search_from

Lower bound on task creation time (ISO 8601).

search_till

Upper bound on task creation time (ISO 8601).

search_date

Filter for a single calendar date (YYYY-MM-DD).

result

Filter by top-level result string (e.g. "Active", "valid").

request_type

Filter by lookup type id (1 = hlr, 2 = validate).

valid

Filter by validation outcome.

number_type

Filter by detected number type ("mobile", "fixed_line", etc.).

limit

Maximum number of rows to return (page size).

skip

Offset into the result set (for pagination).

with_totals

Set to 1 to include the aggregate counts (total, unique, invalid, mobile) in the response.

country

Filter by ISO 3166-1 alpha-2 country code (e.g. "US").

is_ported

Filter by port-status flag.

is_roaming

Filter by roaming-status flag.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful Response

404Not Found

422Validation Error