LeadMagic

Add a non-empty plaintext email list to one owned suppression list; LeadMagic stores only normalized SHA-256 hashes. Use the exact list_id captured in the same create lifecycle and only addresses intentionally owned by that workflow.

Create a persistent credit budget that caps spend for one LeadMagic scope. Record the returned id so the owned budget can be updated or deleted later.

Create an owned suppression list from a unique list_id and non-empty plaintext email list. LeadMagic hashes emails server-side. Capture the returned list_id, use only that exact ID for subsequent reads or mutations, and always delete the owned list at the end of the lifecycle.

Synchronously export up to 5,000 matching jobs. At least one search filter is required. This route is credit-metered, but LeadMagic does not publish an exact rate. The limit defaults to 1 and bounds result count, not guaranteed credit exposure; use credits_consumed as finalized spend.

Permanently delete one credit budget. This is an irreversible teardown action: use only the exact budget ID captured from Create Credit Budget in the same owned lifecycle, and never delete a budget discovered by listing workspace data.

Permanently delete an entire suppression list and its stored hashes. This is an irreversible teardown action: use only the exact list_id captured from Create Email Suppression List in the same owned lifecycle, never a pre-existing list.

Check whether a person has changed jobs relative to an expected company. A resolved check costs 3 credits; PROFILE_NOT_FOUND costs 0 credits.

Download all result rows for an owned bulk job as a CSV file. Use only a jobId captured from the same submission chain. The streamed download is offloaded and fails if it exceeds the documented 50 MiB bulk source-size bound.

Call POST /v1/companies/company-search to enrich one company from its domain, name, or business profile identifier. A successful enriched-company result costs 1 credit; use credits_consumed as the finalized spend.

Call the distinct documented POST /v3/companies/enrich alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does not state an exact alias-specific charge, so use credits_consumed as finalized spend.

Find competitors from a company domain, profile, or name. A successful competitor list costs 5 credits.

Find up to 10 employees at one company, returning names, titles, locations, and professional profile URLs. Provider documentation conflicts between 0.05 and 1 credit per returned employee, so treat 1 credit per result as the exposure bound and use credits_consumed as finalized spend.

Call POST /v1/jobs/jobs-finder to find jobs with the LeadMagic V1 filters. Each returned job costs 1 credit; an empty result costs 0 credits. per_page is capped at 50.

Find similar companies from a seed domain, name, or description. The OpenAPI contract documents a flat 5-credit charge for a non-empty result and no charge when empty; another provider surface says 1 credit, so use credits_consumed as the finalized spend.

Find one person's mobile phone number from a professional profile URL or known email. A found mobile number costs 5 credits; no result is free. Exactly one person is processed per call.

Find one person's personal email addresses from a professional profile URL or identifier. A successful result costs 2 credits. Personal email addresses are sensitive personal data; use this tool only for a lawful, authorized purpose.

Find one person by job title at a specified company. A successful match costs 2 credits; rely on credits_consumed as finalized spend. The response can contain personal identity and professional profile data.

Find one person's work email from their name and company domain or name. A found valid email costs 1 credit; no result is free. Exactly one person is processed per call.

Find one person's work email from a professional profile URL or slug. LeadMagic's published sources conflict on whether a successful result costs 1 or 5 credits; treat 5 credits as the maximum documented exposure and use credits_consumed as finalized spend.

Return the connected workspace's available credits, API-key permission summary, current rate limits, and today's usage. This read is free.

Get documented lifetime account request, credit, product, success, and latency statistics, optionally restricted to a date range. This free analytics route was not individually live-probed during the build.

Get LeadMagic credit consumption history with a daily breakdown.

Get documented daily request, credit, latency, and error metrics for the last 1 to 90 days. This free analytics route was not individually live-probed during the build.

Get the documented per-product request and credit breakdown for one date. This free analytics route was not individually live-probed during the build.

Get per-product LeadMagic usage with request, credit, and success metrics.

Get daily LeadMagic usage with request, credit, and chargeable-rate totals.

Get full details for a specific B2B ad from its library URL, detail path, or numeric ID. A successful full-details lookup costs exactly 2 credits; use credits_consumed as finalized spend.

Find one person's professional profile from a supplied work or personal email. A found complete profile costs 10 credits. Email addresses and matched profile data are personal data; submit and use them only for a lawful, authorized purpose.

Retrieve one person's professional profile, including employment, education, certifications, and honors, from a profile URL or slug. A found full profile costs 1 credit. Returned profile data is personal data; use it only for a lawful, authorized purpose.

Read status, progress, cost, and metadata for a mixed-product batch by its exact batch identifier. A missing synthetic identifier safely returns not found and does not mutate or spend credits.

Read aggregate usage and success metrics for a batch campaign. A syntactically valid missing identifier can be used for a safe, non-mutating not-found check.

Read aggregate batch usage and success metrics for one client UUID. An all-zero missing UUID is safe for a non-mutating not-found check.

Return the current bulk submission limits and supported operational features in a stable agent-facing shape. Service-internal host and deployment metadata are intentionally omitted.

Read status, progress, timestamps, and finalized credit usage for one bulk job. Pass a jobId captured from the same owned submission workflow; do not inspect an unrelated workspace job.

Return LeadMagic's compact progress snapshot for frequent polling of one bulk job owned by the connected workspace. This read does not start, stop, or restart processing.

Call POST /v1/companies/company-funding to get complete funding history and related company intelligence by domain or name. A successful funding result costs 4 credits.

Call the distinct documented POST /v3/companies/company-funding alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does not state an exact alias-specific charge, so use credits_consumed as finalized spend.

Call the distinct documented POST /v3/companies/funding alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does not state an exact alias-specific charge, so use credits_consumed as finalized spend.

Get a company's technology stack from its domain. A successful stack result costs 1 credit; use credits_consumed as finalized spend.

Check the connected LeadMagic workspace's current credit balance for free.

Read current limits, remaining credits, and exceeded state for every LeadMagic credit budget. This does not reserve or consume credits.

Validate the connected LeadMagic API key and check credit-service authentication status. This medium-confidence docs-only read has an undocumented response schema and billing behavior and was not live-probed.

Return one offset-controlled page of details and irreversible SHA-256 email hashes for one owned suppression list. Use only the exact list_id captured in the same create lifecycle, never auto-fetch pages, and continue only with the returned next_offset. Hashes cannot be converted back to plaintext emails.

Return the free job search dataset statistics through LeadMagic's exact job-board integration alias route.

Return the free filter catalogs used by job search, including countries, regions, job types, industries, company types, and seniority values. This helper consumes 0 credits.

Return free public coverage, freshness, and capability statistics for the LeadMagic Jobs Search index.

Return free cached coverage, capabilities, and top dimensions for selected LeadMagic search products. Requested product sections may be absent when unavailable. This helper costs 0 credits.

List existing organization-scoped client records used to segment batch work. This read does not create or modify clients.

List delivery webhooks configured for one batch client. This read does not create, change, or invoke webhooks.

List one bounded page of mixed-product batches for the connected organization. Continue only with the returned next_offset; this tool never auto-fetches additional pages.

Return one offset-controlled page of failed rows and error details for a bulk job owned by the connected workspace. This is read-only and never retries or restarts failed rows.

Return the append-only event log, newest first, for one bulk job owned by the connected workspace. Reading events does not alter the job lifecycle.

Return one bounded offset page of row-level JSON results for an owned bulk job. Use only a jobId captured from the same submission chain and pass next_offset back explicitly to continue; this tool never auto-fetches all rows.

Return one bounded offset page of bulk jobs owned by the connected account, newest first. Use next_offset to continue; this action never auto-fetches pages.

List all persistent credit budgets configured for the connected LeadMagic workspace, including identifiers needed for owned-budget lifecycle operations.

Read all suppression-list summaries for the connected workspace. This tool is for discovery only: never pass an ID from this result to a mutation or deletion; lifecycle writes must use the exact ID captured from a list created by that workflow.

List organization-level external enrichment provider configurations. LeadMagic redacts stored credentials from this read.

List the company type IDs accepted by the legacy V1 Jobs Finder API. No route-specific charge is documented; reported finalized spend should be treated as authoritative.

List the free country codes accepted by the legacy V1 Jobs Finder API. Use V3 catalogs or locations for V3 job search.

List the industry IDs accepted by the legacy V1 Jobs Finder API. No route-specific charge is documented; reported finalized spend should be treated as authoritative.