{"name":"Substation’s Business People Finder","version":"business-public-v1.4","purpose":"Substation’s Business People Finder lets you search a database of 47M+ companies and 811M+ business contacts for free. Find a verified work email or mobile number, or verify a list of business email addresses you already have.","coverage":{"companies":"47M+","business_contacts":"811M+","scope":"Database coverage. Contact details depend on the selected profile."},"services":{"free_search":"Search people by name, role, employer or location. Search companies by name, domain or location. People and company results include LinkedIn and company website when available.","business_email_lookup":{"request":"Follow enrichment_request on a person returned by free search.","price_usdc":"0.05","billing":"One work email reported valid by the provider. Charge only when delivered. An empty lookup is free."},"business_email_verification":{"request":"Use email_verification for one address, a list or a saved email purchase.","price_usdc":"0.01","max_entries":100,"maximum_list_usdc":"1.00","billing":"Charge per unique valid or invalid verdict. An inconclusive check is free. Replacement is a separate business email lookup."},"mobile_number_lookup":{"request":"Follow phone_enrichment_request on a person returned by free search.","price_usdc":"0.20","billing":"One mobile number for the selected person. Charge only when a number is found."}},"start":{"method":"POST","url":"https://substation.sh/business/sessions","body":{},"payment_required":false,"description":"Creates private, limited access automatically. No invitation, provider account, wallet or feedback is required to search. Keep the returned access private and reuse it."},"email_verification":{"purpose":"Check a business address you hold, a list you are authorized to use, or an address from a saved Substation purchase. A search or prior purchase is optional.","quote":{"method":"POST","url":"https://substation.sh/business/{session}/quotes","payment_required":false},"single":{"lookup_type":"verify_email","email":"person@example.com"},"list":{"lookup_type":"verify_email","emails":["one@example.com","two@example.com"]},"saved_purchase":"Follow verification_request on the purchased email result.","list_limits":"Send 1–100 entries per list, up to $1.00 USDC at the current verification price. Submit additional lists of up to 100 in the same active session. Each list has its own maximum. Previously verified addresses reuse their saved result. Verification is separate from the 3 contact lookups per session. Respect shared rate limits. Repeated entries point to the same job. Malformed entries are flagged before payment.","authorize":"Read maximum_usdc and the entries in input order. Use each unique open job’s x402 payment_request once with your authorized wallet. Wallets that expose signed authorizations can also submit them together. A list quote alone starts no checks. Run within shared limits. If a signed batch pauses, read job status, honor Retry-After and resume unfinished jobs from the original quote.","submit_signed_list":{"method":"POST","url":"https://substation.sh/business/{session}/verify-list","body":{"items":[{"job_id":"<job_id>","payment_signature":"<x402 signature for that job>"}]}},"verdicts":{"valid":"The receiving mail server confirmed the mailbox exists at the time of the check. Delivery of a particular message is not guaranteed.","invalid":"The verifier determined that the mailbox does not exist or is inactive. Mail sent there is likely to bounce. This does not establish that the person changed jobs or has another address.","accept_all":"The domain accepts mail for arbitrary addresses, so this particular mailbox could not be confirmed.","unknown":"The verifier could not determine mailbox status, for example when the receiving server did not answer or blocked the check.","malformed":"The address failed input validation. No mailbox check occurred."},"billing":{"unit":"USDC on Base","conclusive_verification":"0.01","replacement_found":"0.05","rule":"Only valid and invalid settle the quoted verification fee. Accept-all, unknown, malformed inputs, duplicates and provider failures add no charge. For duplicate rows read the original verdict. Always use the live quote and its matching payment requirements."},"replacement":{"when":"Only after a completed invalid verdict, if a new address is useful. Use free people search with known identity details and select the matching person. If identity is ambiguous, stop. A failed address alone does not identify a person.","quote_body":{"lookup_type":"email","candidate_id":"<matching search candidate_id>","replaces_verification_id":"<invalid verification job_id>"},"terms":"Request and authorize a separate business-email lookup. The full lookup price settles only for a different business email reported valid for the selected person. An empty result or the same address adds no charge. The earlier verification fee still applies."},"retrieval":"Use the original session’s result_request for the saved address, verdict, timestamp and receipt when charged. Reopening it is free. Resubmitting the list reuses its existing jobs. After an interruption check each job before paying again. For a fresh single-address check after a finished or expired verification, add its job ID as check_key."},"search_fields":{"type":"people or companies","person_name":"optional; people only","job_title":"optional; people only","company_name":"optional","company_domain":"optional bare domain","location":"optional","page":"1–10; default 1"},"free_results":{"people":"profile_url is the person’s LinkedIn. Each position can include a normalized job title, seniority, departments, start month and employer details. The person’s location can include a time zone.","companies":"website is the company website. A company’s profile_url is its LinkedIn. Description, specialties, industry, employee count and employee range are available when supplied. The same fields apply to employers inside people results.","missing_values":"Null means the source did not supply a usable value. It does not indicate a negative match.","example":{"description":"Selected fields from a fictional free people result.","result":{"name":"Example Person","profile_url":"https://www.linkedin.com/in/example-person","location":{"city":null,"state":null,"country":"United States","time_zone":"America/Chicago"},"primary_position":{"job_title":"Director of Product Design","normalized_job_title":"Product Design Director","seniority":"Director","departments":["Design"],"start_month":null,"company":{"name":"Example Studio","website":"https://example.org","profile_url":"https://www.linkedin.com/company/example-studio","industry":"Design","description":"Designs digital products.","specialties":["Product design"],"employee_count":null,"employee_range":"11-50"}},"email_status":"unknown","email_available":null}}},"workflow":["Create a free session, then use its returned search request with at least one relevant filter. Filters combine with AND; each page contains up to 25 results. Search never reveals email addresses or phones.","For single or list verification, use email_verification. A saved business email also includes a verification_request. Only a valid or invalid mailbox verdict settles the verification price. Reopening the original result is free.","Assess the profiles, source observations and match warnings. Provider-reported email availability is not an independent guarantee of current employment or deliverability.","For a business email, follow enrichment_request. For one mobile number, follow phone_enrichment_request. Each request selects a single contact detail. The returned quote and HTTP 402 challenge state the current amount, asset, network and recipient. Use only an existing authorized spending budget; a free search never authorizes payment.","Substation settles only after the requested detail is found. A mobile quote pays for one number for that person. No usable result means no Substation settlement. Wait at most one minute; Substation makes at most two provider attempts, each bounded to 30 seconds.","If delivery is interrupted, check the existing job status. A completed purchase can be retrieved free using the original session’s result_request; no new wallet call or payment signature is needed. Do not start another payment if settlement is uncertain."],"access":{"session_days":30,"searches_per_session":20,"enrichment_jobs_per_session":3,"maximum_verification_list_entries":100,"searches_per_network_per_day":20,"minimum_seconds_between_searches":5,"shared_limits_apply":true},"pricing":{"search":"free","enrichment":"The returned quote and matching x402 challenge set the amount for each job.","saved_result_retrieval":"free while original access remains active","protocol":"x402 v2 exact","network":"eip155:8453"},"limits":{"behavior":"Respect HTTP 429 and Retry-After. Quotas are shared; creating sessions cannot bypass them. Email and mobile lookups have separate allowances. Search and saved-result retrieval remain available when a lookup allowance is exhausted.","status_request":{"method":"GET","url":"https://substation.sh/business/status"}},"use_terms":"Professional use only. No bulk harvesting, onward database resale, or use for credit, housing, employment or insurance eligibility decisions. Honor privacy and opt-out requests. Do not publish session access or private results.","documentation":"https://substation.sh/openapi.json"}