Data model

Field-level dictionary for StoreInspect API response objects.

API responses use public response models with opaque IDs. Do not infer hidden IDs, ordering, or non-public state from public IDs.

Fields marked nullable can return null when StoreInspect does not have reliable data for that value.

Store object

Returned by store search, store lookup, and domain enrichment.

Field	Type	Description
id	string	Opaque StoreInspect store ID.
object	string	Always store.
domain	string	Normalized store hostname without a URL scheme or path.
name	string	Store or company name.
category	string or null	StoreInspect category label. Use the taxonomy endpoint for current values.
country	string or null	Two-letter country code inferred for the store.
traffic_tier	string or null	Estimated monthly website-traffic range.
revenue_tier	string or null	Estimated monthly online-revenue range. This is an estimate, not reported revenue.
shopify_plus	boolean	Whether StoreInspect detects Shopify Plus.
lead_fit_score	number or null	StoreInspect’s 0-100 lead-fit score based on available store signals.
technologies	object	Detected apps, pixels, and theme information.
contacts_summary	object	Aggregate contact coverage for the store.

Technologies

Field	Type	Description
apps	string[]	Names of detected Shopify apps and ecommerce technologies.
pixels	string[]	Names of detected analytics, advertising, and tracking technologies.
theme.name	string or null	Detected Shopify theme name when available.
theme.type	string or null	Theme classification, such as free, paid, or custom.

Contact summary

Field	Type	Description
total	integer	Number of contact records associated with the store.
has_revealable_contacts	boolean	Whether at least one associated contact can currently be revealed.
verified_email_count	integer	Number of contacts with an email that can be returned on reveal.
roles	string[]	Contact-role values represented among the store’s contacts.

Contact preview object

Returned by contact search and optional contact previews in domain enrichment. Preview objects help select contacts without exposing private contact channels.

Field	Type	Description
id	string	Opaque StoreInspect contact ID used by the reveal endpoint.
object	string	Always contact_preview.
first_name	string or null	Contact’s first name when available.
last_name_obfuscated	string or null	Masked last name shown before reveal.
role	string or null	Normalized decision-maker role. Use the taxonomy endpoint for current values.
seniority	string	One of executive, decision_maker, or other.
title	string or null	Contact’s job title when available.
has_verified_email	boolean	Whether reveal can return at least one email. Returned email statuses can be verified, matched, or found.
has_phone	boolean	Whether reveal can return a phone number.
has_linkedin	boolean	Whether reveal can return a LinkedIn profile URL.
revealed	boolean	Whether this account has already revealed the contact.
store	object	Store context for the contact.

Preview store context

Field	Type	Description
id	string	Opaque StoreInspect store ID.
domain	string	Normalized store hostname.
name	string	Store or company name.
category	string or null	StoreInspect category label.
traffic_tier	string or null	Estimated monthly website-traffic range.
technologies.apps	string[]	Detected app names.
technologies.pixels	string[]	Detected pixel and tracking-technology names.

Revealed contact object

Returned by POST /contacts/reveal after the contact is newly revealed or retrieved from the account’s existing reveals.

Field	Type	Description
id	string	Opaque StoreInspect contact ID.
object	string	Always contact.
full_name	string or null	Contact’s full name.
first_name	string or null	Contact’s first name.
last_name	string or null	Contact’s last name.
title	string or null	Contact’s job title.
role	string or null	Normalized decision-maker role.
seniority	string	One of executive, decision_maker, or other.
linkedin_url	string or null	LinkedIn profile URL when available and exportable.
reveal_status	string	newly_revealed or already_revealed.
charged	boolean	Whether this request spent one contact credit for the contact.
emails	object[]	Exportable email channels.
phones	object[]	Available phone channels.
store	object	Store ID, domain, and name associated with the contact.
revealed_at	date-time string	ISO 8601 timestamp for the account’s reveal.

Email channel

Field	Type	Description
email	string	Exportable email address.
status	string	Email verification or deliverability status.
type	string	Email classification supplied with the contact channel.
is_primary	boolean	Whether this is the contact’s primary returned email.

Reveal responses exclude guessed, catch-all, bounced, suppressed, and otherwise non-exportable emails.

Phone channel

Field	Type	Description
phone	string	Phone number as returned by StoreInspect.
type	string	Phone classification supplied with the contact channel.
is_primary	boolean	Whether this is the contact’s primary returned phone number.

Response envelopes

Field	Type	Description
object	string	Response object type, such as list, store_enrichment_result, or contact_reveal_result.
data	object[]	Result objects for the request.
has_more	boolean	Whether another page is available for a search response.
next_cursor	string or null	Opaque cursor for the next page. Pass it back unchanged.
found	integer	Number of requested domains found in an enrichment response.
not_found	integer	Number of requested domains not found in an enrichment response.
credits.spent	integer	Contact credits spent by a reveal request.
credits.remaining	integer	Contact credits remaining after a reveal request.
request_id	string	Request identifier for support and debugging.

Domain enrichment result

Each item returned by POST /stores/enrich preserves the requested domain and reports whether it was found.

Field	Type	Description
domain	string	Normalized requested domain.
status	string	found or not_found.
store	Store or null	Store object when found, otherwise null.
contact_previews	ContactPreview[]	Optional contact previews when requested through include.

For exact request schemas, limits, and endpoint examples, use the API Reference or the OpenAPI document.