Skip to main content

Phone & Email Lookup

Overview​

Phone & Email Lookup finds profile information linked to a phone number or email address by querying multiple sources and presenting results in one view. You enter one or more phone numbers or email addresses, run a lookup, and review results grouped by source. Outputs include collapsible source sections, optional raw responses, and an exportable JSON file saved to a Workspace. Results vary by source coverage and require review before you treat them as verified identity data.

When to Use This Application​

  • You need quick enrichment for a phone number or email address during triage.
  • You need to compare results from multiple sources in one place instead of checking them one by one.
  • You need to identify linked identifiers (emails, addresses, usernames) for follow-up searches.
  • You need to export lookup results to a workspace for later review or sharing.
  • You launch from a person, phone number, or email entity and want fields pre-filled from existing context.

Before You Begin​

  1. Prepare the identifiers you want to look up
  2. Confirm you have write access to at least one Workspace if you plan to export results.
  3. Confirm outbound access to the configured lookup sources is available in your environment.

Supported input formats include:

Input typeFormat
Phone numberInclude the international prefix, such as +44, +1, or +33
Email addressUse standard format, such as name@domain.com

Step-by-Step Walkthrough​

Step 1 — Open the application​

Open Phone & Email Lookup from Octostar. If you launch the app from a person, phone number, or email entity, the sidebar fields are pre-populated with contact details already linked to that entity.

Step 2 — Enter phone numbers (optional)​

In the sidebar, use the Phone Numbers section. Enter one or more phone numbers:

  • Separate values using commas or new lines.
  • Include the international prefix for each number (for example +1, +44, +33).
  • Use spaces, hyphens, or dots if needed. Example formats:
  • +1 555-867-5309
  • +44.20.7946.0958
  • +33 6 12 34 56 78

Then select Lookup Phone Numbers.

The app validates formatting. If a number is missing the international prefix or is malformed, the app shows an error and does not start the lookup until you correct it.

Step 3 — Enter email addresses (optional)​

In the sidebar, use the Email Addresses section. Enter one or more email addresses:

  • Separate values using commas or new lines.
  • Use standard email format (for example name@domain.com).
  • Treat values as case-insensitive.

Then select Lookup Email Addresses.

The app validates each address and alerts you if any are invalid. After validation, it queries the available sources and displays results.

Step 4 — Review results by source​

Results appear in the main content area. Each source appears in its own collapsible section.

  • Expand or collapse a section to view results from that source.
  • Use source logos to identify where each profile comes from.
  • If a source returns multiple profiles for the same input, the app shows numbered entries.
  • Review profile images when available.

A Raw Data section appears at the bottom of each result when you need to inspect the unprocessed response. If a source has no result for an input, it does not appear.

Step 5 — Switch between previous lookups (optional)​

Use the sidebar history selectors to switch between lookups you ran in the current session:

  • Previous phone number searches
  • Previous email address searches

Switching history entries does not re-run the lookup.

Step 6 — Save results to a workspace​

Use the export controls in the sidebar.

  1. Select a destination Workspace from the Workspace dropdown. Only workspaces where you have write permission appear.
  2. Enter a folder path in Folder path. Default is Extracted/.
  3. Select Save JSON.

The app shows a confirmation message with the save location. The exported file contains the full structured lookup results.

Understanding the Output​

Phone & Email Lookup groups results by source so you can compare returned profiles more easily.

OutputDescription
Source sectionsEach data source appears as a collapsible section. A section can contain one or more profiles for the same input.
Profile contentDepending on source and input type, results may include identity details, account status, activity indicators, carrier/location details, and linked identifiers.
Raw DataUse this section when you need the complete response for audit or deeper inspection.

Coverage varies by source. A missing section does not indicate a failed lookup. It indicates no data returned from that source.

Saving and Exporting Results​

The app supports exporting lookup results as JSON. Save JSON:

    • What it does: exports the full lookup response in structured JSON format
  • Where it ends up: selected Workspace and folder path (default Extracted/)
  • Settings: Workspace selection and Folder path

Tips for Best Results​

  • Always include the full international prefix for phone numbers. Missing prefixes are the most common validation error.
  • Enter multiple phone numbers or emails at once using commas or new lines.
  • Use the session history selectors to switch between lookups without re-running queries.
  • Use Extracted/Cases/2026/-style folder paths to keep exports organized.
  • Treat results as leads. Verify identity claims against other evidence before acting on them.
  • If a lookup returns fewer sources than expected, rerun later. Source availability can vary.

Known Limitations​

LimitationExplanation
Coverage varies by sourceNot every source returns data for every input
Results may conflict across sourcesValidate before using the data in reports or decisions
External dependencies affect availabilityConnectivity or source outages can reduce coverage