# Kamata > Verify emails and phone numbers, find verified work emails, phones and LinkedIn profiles, and enrich people and companies, from an MCP client or the REST API. ## MCP server - Endpoint: https://api.kamata.ai/v1/mcp (streamable HTTP, POST, JSON responses, one JSON-RPC message per request) - Auth: OAuth 2.1 + PKCE, discovered from the 401 WWW-Authenticate header (scopes mcp:read, mcp:write), or Authorization: Bearer sk_live_… (an API key with mcp:read, mcp:write, data:read, data:write) - Claude Code: claude mcp add --transport http kamata https://api.kamata.ai/v1/mcp - Cursor / generic: {"mcpServers":{"kamata":{"url":"https://api.kamata.ai/v1/mcp"}}} - Paid calls run at once; only one that would pass what the plan has left, or a very large one, returns a cost preview first: repeat with confirm: true after the user agrees. - A tool waits for its answers in the call (up to 45 s); pending items finish in the background. A list over 50 returns a handle: call check_results with it once, not on a timer. - inferred: true = a match, not a measurement. is_sample: true = sample data, never real. Never guess an email that came back null. - Docs: https://api.kamata.ai/docs/mcp ## Tools on every plan - find_contacts(icp?, count?, titles?, industries?, locations?, sizes?, yc?, funded?, people?, want?, confirm?, max_lookups?, wait_seconds?): Find contacts (verified emails and phones). Write (mcp:write). Find a work email: 1 credit, only when a verified email is found; Verify an email: 1 credit, per check; Find a phone number: 12 credits, only when a phone is found; Check a phone number (mobile, landline or VoIP): 1 credit, per check (a number checked in the last 90 days is free) - verify_phone(phones, confirm?, wait_seconds?): Verify phone numbers. Write (mcp:write). Check a phone number (mobile, landline or VoIP): 1 credit, per check (a number checked in the last 90 days is free) - verify_emails(emails, confirm?, wait_seconds?): Check email addresses. Write (mcp:write). Verify an email: 1 credit, per check; Cache hits and answers code can give (role inboxes, throwaway domains, no mail server) are free. - verify_phones(phones, default_country?, line_type?, confirm?, wait_seconds?): Check phone numbers. Write (mcp:write). Check a phone number (mobile, landline or VoIP): 1 credit, per check (a number checked in the last 90 days is free); Only with line_type: true; the numbering-plan check is free. - check_results(handle, cursor?, limit?): Check results. Read (mcp:read). Free: no credits. - enrich_people(people, want?, confirm?, wait_seconds?): Find emails for a list of people. Write (mcp:write). Find a work email: 1 credit, only when a verified email is found; Verify an email: 1 credit, per check; Find a phone number: 12 credits, only when a phone is found; Match an email to a LinkedIn profile: 20 credits, only when a profile is found; Each person is charged only for what is found. - enrich_companies(companies, confirm?, wait_seconds?): Company details for a list. Write (mcp:write). Enrich a company (industry, headcount, revenue, funding, location): 2 credits, only when a new company detail is found - process_file(csv?, xlsx_base64?, source_format?, file_name?, task, want?, default_country?, confirm?, wait_seconds?): Process a CSV or Excel file. Write (mcp:write). Verify an email: 1 credit, per check; Check a phone number (mobile, landline or VoIP): 1 credit, per check (a number checked in the last 90 days is free); Find a work email: 1 credit, only when a verified email is found; Find a phone number: 12 credits, only when a phone is found; Match an email to a LinkedIn profile: 20 credits, only when a profile is found; Enrich a company (industry, headcount, revenue, funding, location): 2 credits, only when a new company detail is found; The same prices as the task it runs. - lookup_phone(phone, level?, default_country?, confirm?, wait_seconds?): Look up a phone number. Write (mcp:write). Look up a phone number (valid, mobile / landline / VoIP, carrier, ported): 1 credit, per number looked up (the same number again within 90 days is free); Look up a phone number with its listed caller name: 2 credits, per number looked up, name or not (the same number again within 90 days is free); Look up a phone number with its name and business / person: 6 credits, per number looked up, name or not (the same number again within 90 days is free); Look up who a phone number belongs to (caller identity): 12 credits, per number looked up, match or not (the same number again within 90 days is free); The level asked for; levels not switched on are not available yet. - lookup_phones(phones, level?, default_country?, max_credits?, confirm?, wait_seconds?): Look up a list of phone numbers. Write (mcp:write). Look up a phone number (valid, mobile / landline / VoIP, carrier, ported): 1 credit, per number looked up (the same number again within 90 days is free); Look up a phone number with its listed caller name: 2 credits, per number looked up, name or not (the same number again within 90 days is free); Look up a phone number with its name and business / person: 6 credits, per number looked up, name or not (the same number again within 90 days is free); Look up who a phone number belongs to (caller identity): 12 credits, per number looked up, match or not (the same number again within 90 days is free); Invalid numbers, duplicates and repeats within 90 days are free. - reverse_phone(phone, level?, default_country?, accept_use?, confirm?, wait_seconds?): Who is behind a phone number. Write (mcp:write). Look up a phone number with its listed caller name: 2 credits, per number looked up, name or not (the same number again within 90 days is free); Look up a phone number with its name and business / person: 6 credits, per number looked up, name or not (the same number again within 90 days is free); Look up who a phone number belongs to (caller identity): 12 credits, per number looked up, match or not (the same number again within 90 days is free) - reverse_phones(phones, level?, default_country?, max_credits?, accept_use?, confirm?, wait_seconds?): Who is behind a list of phone numbers. Write (mcp:write). Look up a phone number with its listed caller name: 2 credits, per number looked up, name or not (the same number again within 90 days is free); Look up a phone number with its name and business / person: 6 credits, per number looked up, name or not (the same number again within 90 days is free); Look up who a phone number belongs to (caller identity): 12 credits, per number looked up, match or not (the same number again within 90 days is free) - phone_status(lookup_id?, batch_id?, cursor?, limit?): Phone results. Read (mcp:read). Free: no credits. - job_status(job_id): Job status. Read (mcp:read). Free: no credits. - credits(): Credits left. Read (mcp:read). Free: no credits. - search_jobs(q?, titles?, functions?, seniorities?, technologies?, country?, states?, cities?, remote?, salary_min_usd?, posted_since?, status?, company_domains?, limit?, cursor?, confirm?): Search job posts. Read (mcp:read). List a job post: 1 credit, per job post returned (a page with none is free); Our own jobs dataset: no vendor is called. - company_hiring(domain, technologies?): Company hiring. Read (mcp:read). A company's hiring or job-post technologies: 1 credit, per company with data returned (none on record is free); Our own jobs dataset: no vendor is called. The technologies list is charged separately, only when it has rows. - find_email(items, confirm?, wait_seconds?): Find emails. Write (mcp:write). Find a work email: 1 credit, only when a verified email is found - find_phone(items, confirm?, wait_seconds?): Find phone numbers. Write (mcp:write). Find a phone number: 12 credits, only when a phone is found - verify_email(emails, confirm?, wait_seconds?): Check email addresses. Write (mcp:write). Verify an email: 1 credit, per check; A repeat of the same check within 7 days is free. - match_linkedin(emails, confirm?, wait_seconds?): Match emails to LinkedIn profiles. Write (mcp:write). Match an email to a LinkedIn profile: 20 credits, only when a profile is found - account(): Signed-in account. Read (mcp:read). Free: no credits. - sign_out(): Sign out. Read (mcp:read). Free: no credits. ## Tools on outbound plans - search_leads(status?, signal_kind?, company?, min_fit?, since_days?, limit?): Search leads. Read (mcp:read). Free: no credits. - get_lead(lead_id): Get a lead. Read (mcp:read). Free: no credits. - list_signals(kind?, company?, since_days?, limit?): Signals behind your leads. Read (mcp:read). Free: no credits. - list_replies(intent?, since_days?, limit?): List replies. Read (mcp:read). Free: no credits. - reply_stats(group_by?, since_days?): Reply numbers. Read (mcp:read). Free: no credits. - benchmarks(signal_kind?, since_days?): Reply-rate benchmarks. Read (mcp:read). Free: no credits. - similar_companies(company, limit?): Find lookalike companies. Read (mcp:read). Free: no credits. - list_agent_plays(agent_id?): List an agent's plays. Read (mcp:read). Free: no credits. - search_signals(kind?, source?, industry?, location?, size?, since_days?, text?, limit?, target_group_id?): Search buying signals. Read (mcp:read). Free: no credits. - find_companies(count?, live?, confirm?, max_lookups?, target_group_id?, icp?, industries?, sizes?, locations?, technologies?, signal_types?, q?, yc?, funded?, since_days?, limit?, cursor?): Find companies. Read (mcp:read). Stored results are free. A live search runs only after its cost preview is confirmed (confirm: true) and uses the plan's monthly lookups, never credits. - find_people(count?, live?, confirm?, max_lookups?, icp?, company?, target_group_id?, titles?, seniority?, departments?, industries?, sizes?, locations?, signal_types?, since_days?, yc?, funded?, limit?, cursor?): Find people. Read (mcp:read). Stored results are free. A live search runs only after its cost preview is confirmed (confirm: true) and uses the plan's monthly lookups, never credits. - company_profile(domain?, company_id?): Company profile. Read (mcp:read). Free: no credits. - enrich_company(domain?, company_id?): Enrich a company. Read (mcp:read). Free: no credits. - enrich_person(person_id): Enrich a person. Read (mcp:read). Free: no credits. - target_groups(agent_id?, include_suggested?): List target groups. Read (mcp:read). Free: no credits. - whats_working(agent_id, target_group_id): What's working. Read (mcp:read). Free: no credits. - get_site_profile(domain, include_gone?): Site profile. Read (mcp:read). Free: no credits. - find_companies_by_technology(technologies?, match?, not?, categories?, parent_categories?, channels?, status?, since?, country?, regions?, limit?, cursor?, confirm?): Find companies by technology. Read (mcp:read). List a company using a technology: 1 credit, per company returned (a page with no companies is free); Our own crawl data: no vendor is called. - results(period?, agent_id?): Results. Read (mcp:read). Free: no credits. - list_lists(): List lists. Read (mcp:read). Free: no credits. - search(query): Search. Read (mcp:read). Free: no credits. - fetch(id): Fetch. Read (mcp:read). Free: no credits. - add_to_agent(agent_id, items): Add companies to an agent. Write (mcp:write). No credits; the plan's own limits apply. - watch_companies(domains, agent_id?): Watch companies. Write (mcp:write). No credits; the plan's own limits apply. - build_list(name, color?, lead_ids?): Create a list. Write (mcp:write). No credits; the plan's own limits apply. - add_to_list(list_id, lead_ids, remove?): Add leads to a list. Write (mcp:write). No credits; the plan's own limits apply. - draft_email(lead_id, tone?, instruction?, wait_seconds?): Draft an email. Write (mcp:write). No credits; the plan's own limits apply. - approve_draft(lead_id): Approve a draft. Write (mcp:write). No credits; the plan's own limits apply. - reject_draft(lead_id, reason?): Reject a draft. Write (mcp:write). No credits; the plan's own limits apply. - set_agent_play(agent_id, play_id, pinned?, paused?): Pin or pause a play. Write (mcp:write). No credits; the plan's own limits apply. - create_agent(sentence?, website?, name?): Create an agent. Write (mcp:write). No credits; the plan's own limits apply. - update_agent_targeting(agent_id, industries?, sizes?, locations?, titles?, signal_kinds?, daily_volume?, offer?): Change an agent's targeting. Write (mcp:write). No credits; the plan's own limits apply. - web_search(q?, intent?, company_id?, domain?, limit?): Search our web index and news. Read (mcp:read). Free: no credits. - company_news(company_id?, domain?, since?, limit?): Recent news about a company. Read (mcp:read). Free: no credits. - company_competitors(company_id?, domain?, limit?, include_inferred?): A company's competitors. Read (mcp:read). Free: no credits. - refresh_web_search(intent, q?, company_id?, domain?): Refresh news, competitors or search. Write (mcp:write). No credits; the plan's own limits apply. - list_reddit_matches(intent?, limit?): Reddit posts asking for what you sell. Read (mcp:read). Free: no credits. - browse_signal_library(agent_id?, category?, q?): Browse the signal library. Read (mcp:read). Free: no credits. - list_signal_ideas(agent_id?): List signal ideas. Read (mcp:read). Free: no credits. - list_custom_signals(source?, status?, agent_id?): List your signals. Read (mcp:read). Free: no credits. - get_custom_signal(custom_signal_id, verdict?, limit?, cursor?): Get a signal. Read (mcp:read). Free: no credits. - get_signal_tryout(tryout_id): Get a tried sentence. Read (mcp:read). Free: no credits. - list_signal_alerts(custom_signal_id?, limit?, cursor?): List signal alerts. Read (mcp:read). Free: no credits. - signal_alert_status(): Check where signal alerts can go. Read (mcp:read). Free: no credits. - list_signal_searches(): List signal searches. Read (mcp:read). Free: no credits. - get_signal_search_results(search_id, status?, limit?, cursor?): Signal search results. Read (mcp:read). Free: no credits. - signal_search_options(signals?, filters?): Signal search options. Read (mcp:read). Free: no credits. - turn_on_library_signal(key, params?, agent_id?, priority?, auto_lead?, leads_per_day?, context?): Turn on a library signal. Write (mcp:write). No credits; the plan's own limits apply. - create_custom_signal(description?, descriptions?, agent_id?, auto_lead?, leads_per_day?, context?, priority?, scope?, list_ids?): Create a custom signal. Write (mcp:write). No credits; the plan's own limits apply. - try_signals(sentences, context?): Try signals before saving. Write (mcp:write). No credits; the plan's own limits apply. - turn_on_signal_tryout(tryout_id, priority?, auto_lead?, leads_per_day?, agent_id?, scope?, list_ids?): Turn on a tried sentence. Write (mcp:write). No credits; the plan's own limits apply. - update_custom_signal(custom_signal_id, name?, description?, context?, priority?, params?, auto_lead?, leads_per_day?, agent_id?): Change a signal. Write (mcp:write). No credits; the plan's own limits apply. - improve_custom_signal(custom_signal_id, issue, note?): Improve a signal. Write (mcp:write). No credits; the plan's own limits apply. - pause_custom_signal(custom_signal_id): Pause a signal. Write (mcp:write). No credits; the plan's own limits apply. - resume_custom_signal(custom_signal_id): Turn a signal on. Write (mcp:write). No credits; the plan's own limits apply. - delete_custom_signal(custom_signal_id): Remove a signal. Write (mcp:write). No credits; the plan's own limits apply. - rate_signal_match(custom_signal_id, match_id, verdict, reason?): Rate a signal match. Write (mcp:write). No credits; the plan's own limits apply. - set_signal_alerts(custom_signal_id, muted?, deliver?): Set where a signal sends its matches. Write (mcp:write). No credits; the plan's own limits apply. - retry_signal_alerts(channel): Retry failed signal alerts. Write (mcp:write). No credits; the plan's own limits apply. - refresh_signal_ideas(): Refresh signal ideas. Write (mcp:write). No credits; the plan's own limits apply. - add_signal_idea(idea_id, agent_id?, priority?, dismiss?): Add or dismiss a signal idea. Write (mcp:write). No credits; the plan's own limits apply. - create_signal_search(name, signals, filters?, agent_id?, enabled?): Create a signal search. Write (mcp:write). No credits; the plan's own limits apply. - update_signal_search(search_id, name?, signals?, filters?, agent_id?, enabled?): Change a signal search. Write (mcp:write). No credits; the plan's own limits apply. - run_signal_search(search_id): Run a signal search now. Write (mcp:write). No credits; the plan's own limits apply. - delete_signal_search(search_id): Delete a signal search. Write (mcp:write). No credits; the plan's own limits apply. - reject_search_result(search_id, result_id, reason?, note?): Reject a search result. Write (mcp:write). No credits; the plan's own limits apply. - add_search_results_to_agent(search_id, result_ids, agent_id): Add search results to an agent. Write (mcp:write). No credits; the plan's own limits apply. - workspace_overview(): Account overview. Read (mcp:read). Free: no credits. - get_reply(reply_id): Read a reply. Read (mcp:read). Free: no credits. - forward_reply(reply_id, to, note?): Forward a reply to a teammate. Write (mcp:write). No credits; the plan's own limits apply. - mark_replies(reply_ids, action, until?, label?): Mark replies. Write (mcp:write). No credits; the plan's own limits apply. - list_exclusions(q?, limit?, cursor?): Don't contact list. Read (mcp:read). Free: no credits. - check_exclusions(values): Check the Don't contact list. Read (mcp:read). Free: no credits. - add_exclusions(domains?, emails?, reason?): Add to Don't contact. Write (mcp:write). No credits; the plan's own limits apply. - remove_exclusion(exclusion_id): Remove from Don't contact. Write (mcp:write). No credits; the plan's own limits apply. - update_mailbox(mailbox_id, display_name?, daily_cap?, signature?): Change a mailbox. Write (mcp:write). No credits; the plan's own limits apply. - pause_mailbox(mailbox_id): Pause a mailbox. Write (mcp:write). No credits; the plan's own limits apply. - resume_mailbox(mailbox_id): Resume a mailbox. Write (mcp:write). No credits; the plan's own limits apply. - pause_agent(agent_id): Pause an agent. Write (mcp:write). No credits; the plan's own limits apply. - resume_agent(agent_id): Resume an agent. Write (mcp:write). No credits; the plan's own limits apply. - duplicate_agent(agent_id, name?): Duplicate an agent. Write (mcp:write). No credits; the plan's own limits apply. - list_webhooks(): Webhooks. Read (mcp:read). Free: no credits. - create_webhook(url, events?, description?): Add a webhook. Write (mcp:write). No credits; the plan's own limits apply. - test_webhook(webhook_id): Test a webhook. Write (mcp:write). No credits; the plan's own limits apply. - list_saved_searches(kind?): Saved searches. Read (mcp:read). Free: no credits. - save_search(name, kind, filters): Save a search. Write (mcp:write). No credits; the plan's own limits apply. - contact_support(message): Message the support team. Write (mcp:write). No credits; the plan's own limits apply. - list_account_lists(): List your account lists. Read (mcp:read). Free: no credits. - list_accounts(list_id?, q?, limit?, cursor?): List accounts. Read (mcp:read). Free: no credits. - get_account(account_id): Get an account. Read (mcp:read). Free: no credits. - create_account_list(name): Create an account list. Write (mcp:write). No credits; the plan's own limits apply. - add_accounts(list_id, domains): Add accounts to a list. Write (mcp:write). No credits; the plan's own limits apply. - set_account_list_signals(list_id, signals): Set a list's signals. Write (mcp:write). No credits; the plan's own limits apply. - correct_account_domain(account_id, domain): Correct an account's domain. Write (mcp:write). No credits; the plan's own limits apply. - rank_accounts(list_id?, tab?, q?, limit?, cursor?): Rank accounts by score. Read (mcp:read). Free: no credits. - make_account_lead(account_id): Make a lead from an account. Write (mcp:write). No credits; the plan's own limits apply. - test_signals_on_history(list_id?, tryout_id?): Test signals on the last 12 months. Write (mcp:write). No credits; the plan's own limits apply. - get_signal_history_test(list_id?, tryout_id?): Get a signal history test. Read (mcp:read). Free: no credits. - list_signal_history_deals(custom_signal_id?, tryout_id?, outcome?, list_id?): List the deals a signal came before. Read (mcp:read). Free: no credits. - add_won_lost_deals(deals): Add won and lost deals. Write (mcp:write). No credits; the plan's own limits apply. - list_won_lost_deals(limit?): List won and lost deals. Read (mcp:read). Free: no credits. - list_suggested_accounts(list_id?, limit?, cursor?): List suggested accounts. Read (mcp:read). Free: no credits. - watch_suggested_accounts(list_id, ids?, top?): Watch suggested accounts. Write (mcp:write). No credits; the plan's own limits apply. - reject_suggested_account(account_id, reason, note?): Reject a suggested account. Write (mcp:write). No credits; the plan's own limits apply. - set_account_suggestions(list_id, on?, filters?): Set how a list finds accounts. Write (mcp:write). No credits; the plan's own limits apply. - rate_account_answer(account_id, custom_signal_id, verdict, reason?): Rate an account answer. Write (mcp:write). No credits; the plan's own limits apply. - daily_priorities(limit?): Show my daily priorities. Read (mcp:read). Free: no credits. - account_overview(domain): Give me an account overview. Read (mcp:read). Free: no credits. - crm_account_sync_status(): Account signals in your CRM. Read (mcp:read). Free: no credits. - set_crm_account_sync(integration_id, on?, create_companies?, fields?): Write account signals to the CRM. Write (mcp:write). No credits; the plan's own limits apply. - list_signal_rules(): List signal rules. Read (mcp:read). Free: no credits. - get_signal_rule(rule_id): Get a signal rule. Read (mcp:read). Free: no credits. - create_signal_rule(name, match, window_days?, actions?, score_boost?, agent_id?, status?): Create a signal rule. Write (mcp:write). No credits; the plan's own limits apply. - update_signal_rule(rule_id, name?, match?, window_days?, actions?, score_boost?, agent_id?, status?): Change a signal rule. Write (mcp:write). No credits; the plan's own limits apply. - delete_signal_rule(rule_id): Delete a signal rule. Write (mcp:write). No credits; the plan's own limits apply. - list_signal_sets(): List signal sets. Read (mcp:read). Free: no credits. - create_signal_set(name, signals?): Make a signal set. Write (mcp:write). No credits; the plan's own limits apply. - update_signal_set(set_id, name?, signals?): Change a signal set. Write (mcp:write). No credits; the plan's own limits apply. - delete_signal_set(set_id): Delete a signal set. Write (mcp:write). No credits; the plan's own limits apply. - use_signal_set(list_id, signal_set_id): Pick a list's signal set. Write (mcp:write). No credits; the plan's own limits apply. - list_signal_results(custom_signal_id?): Signal results: leads and meetings. Read (mcp:read). Free: no credits. - launch_campaign(request, count?, website?, wait_seconds?): Launch a campaign. Write (mcp:write). No credits; the plan's own limits apply. - approve_campaign(campaign_id, version, approval_token?): Start the approved campaign. Write (mcp:write). No credits; the plan's own limits apply. - campaign_card(campaign_id): Campaign. Read (mcp:read). Free: no credits. - show_sequence(agent_id): Sequence. Read (mcp:read). Free: no credits. - list_inboxes(): Inboxes. Read (mcp:read). Free: no credits. - reply_card(message_id?): Reply. Read (mcp:read). Free: no credits. - save_reply_draft(message_id, draft): Save the edited answer. Write (mcp:write). No credits; the plan's own limits apply. - send_reply(message_id, approval_token): Send the answer. Write (mcp:write). No credits; the plan's own limits apply. ## REST API - Base: https://api.kamata.ai/v1, JSON. Auth: Authorization: Bearer sk_live_… (created by a workspace admin in the app; API keys and the MCP server are on every plan). - POST /v1/verify/email [data:write]: Verify one email address. { email, wait_s?: 0–25 (default 5) } - POST /v1/verify/emails [data:write]: Verify up to 5,000 email addresses. { items: string[], wait_s?, webhook_url? } - POST /v1/verify/phone [data:write]: Check one phone number. { phone, default_country?, checks?: ["format" | "line_type"], wait_s? } - POST /v1/verify/phones [data:write]: Check up to 5,000 phone numbers. { items, default_country?, checks?, wait_s?, webhook_url? } - POST /v1/phone/lookup [data:write]: Look up one phone number. { phone, level?: "validate" | "name" | "enhanced" | "identity", default_country?, wait_s? } - POST /v1/phone/lookups [data:write]: Look up up to 5,000 phone numbers. { items, level?, default_country?, max_credits?, wait_s? } - POST /v1/phone/reverse [data:write]: Who is behind one phone number. { phone, level?: "name" | "enhanced" | "identity", accept_use?, default_country?, wait_s? } - POST /v1/phone/reverses [data:write]: Who is behind up to 5,000 phone numbers. { items, level?, accept_use?, default_country?, max_credits?, wait_s? } - GET /v1/phone/lookup/:id [data:read]: One phone lookup: status, result and cost - GET /v1/phone/lookups/:id [data:read]: A phone lookup list: progress and a page of results. ?cursor=&limit=1–1000 - GET /v1/phone/lookups/:id/export [data:read]: A phone lookup list as CSV - GET /v1/phone/levels [data:read]: Which lookup levels are available, and their credits - POST /v1/verify/upload [data:write]: Verify a CSV or .xlsx file (≤ 5,000 rows). multipart `file` (+ kind?: emails | phones, default_country?, checks?, webhook_url?, wait_s?), or JSON { csv | xlsx_base64, file_name?, kind? }, or a raw text/csv body - GET /v1/verify/batches/:id [data:read]: Batch progress and a page of results. ?cursor=&limit=1–1000 - GET /v1/verify/batches/:id/export [data:read]: Batch results as a file - POST /v1/verify/batches/:id/download-link [data:read]: A one-hour download link to the results - POST /v1/enrich/people [data:write]: Enrich up to 5,000 people. { items: (string | {full_name | first_name + last_name, company | domain} | {email} | {linkedin_url})[], want?: ("email" | "phone" | "linkedin")[], wait_s?, webhook_url? } - POST /v1/enrich/companies [data:write]: Enrich up to 5,000 companies. { items: (string | {domain} | {name})[], wait_s?, webhook_url? } - POST /v1/enrich/upload [data:write]: Enrich a CSV or .xlsx file. as /v1/verify/upload, with kind?: people | companies and want? - GET /v1/enrich/batches/:id [data:read]: Same as /v1/verify/batches/:id - GET /v1/enrich/batches/:id/export [data:read]: Same as /v1/verify/batches/:id/export - POST /v1/enrich/batches/:id/download-link [data:read]: Same as /v1/verify/batches/:id/download-link - POST /v1/data/verify-email [data:write]: Verify one email as a lookup job. { email } - POST /v1/data/find-email [data:write]: Find a verified work email. { person: {linkedin_url} | {full_name, domain} | {first_name, last_name, domain} } - POST /v1/data/find-phone [data:write]: Find a direct phone. { person: {linkedin_url} | {email} } - POST /v1/data/match-linkedin [data:write]: Email to LinkedIn profile. { email } - POST /v1/data/verify-phone [data:write]: Check a phone line (mobile, landline, VoIP). { phone } (with country code; 10 digits read as US) - POST /v1/data/find-contacts [data:write]: Run find_contacts as a job. { args } (the find_contacts tool arguments) - GET /v1/data/find-contacts/:id [data:read]: A find_contacts job - GET /v1/data/lookups [data:read]: Your lookups, newest first. ?limit=1–200 (default 50)&cursor= - GET /v1/data/lookups/:id [data:read]: One lookup and its result - GET /v1/data/credits [data:read]: Credits left this month and the price per action - GET /v1/data/tech/sites [data:read]: Companies whose websites use a technology (our own crawl: page code, headers, DNS, files). ?tech=magento,stripe&match=any|all¬=&category=&parent_category=&channel=&status=current|gone|any&since=YYYY-MM-DD&country=US®ion=FL&limit=1–100&cursor= - GET /v1/data/tech/catalog [data:read]: The technology catalog: parent categories, categories, every technology and how many sites use it now. ?category=&parent_category=&q= - GET /v1/data/jobs [data:read]: Job posts from companies' own public job boards and careers pages (our own dataset), newest first. ?q=&title=&function=sales,marketing&seniority=&tech=snowflake&country=US&state=TX&city=&remote=true|false&salary_min=&posted_since=YYYY-MM-DD&status=open|closed|any&company_domain=&company_id=&limit=1–100&cursor= - GET /v1/data/jobs/:id [data:read]: One job post with its full description - GET /v1/data/companies/:domain/hiring [data:read]: What a company is hiring for: open posts, posts in the last 30 days, by function and seniority, its newest posts and the boards we read - GET /v1/data/companies/:domain/technographics [data:read]: Technologies named in a company's job posts (inferred) and, as a separate list, seen on its website. ?source=jobs|site|all - GET /v1/credits [data:read]: The credit wallet: included, rolled over, bought, used, left - GET /v1/credits/usage [data:read]: This month's credits by person, API key and connected app, by action, and per day - PATCH /v1/credits [admin session]: Set the monthly cap for automatic credit packs. { auto_buy_cap_usd: number | null } - Errors: { error, message, issues? }. 400 bad input, 401 bad key, 402 credits_exhausted | plan_limit, 403 scope, 404 not found (or another workspace's id), 429 rate limited (retry-after). - Batch webhooks: webhook_url → POST {event: verify.batch.completed | enrich.batch.completed, data}; x-webhook-signature: t=,v1=.")>. - Email risk grades: A = valid, with replies on record; A = valid, delivered to at least twice without a bounce; B = valid; C = catch_all; D = role (info@, sales@ …); D = unknown; F = invalid; F = disposable; F = a hard bounce on record; F = the person left the company; F = opted out; B = on your exclusion list. Send only to A and B. - Docs: https://api.kamata.ai/docs/api ## Credits - Verify an email: 1 credit, per check - Find a work email: 1 credit, only when a verified email is found - Find a phone number: 12 credits, only when a phone is found - Match an email to a LinkedIn profile: 20 credits, only when a profile is found - Check a phone number (mobile, landline or VoIP): 1 credit, per check (a number checked in the last 90 days is free) - Enrich a company (industry, headcount, revenue, funding, location): 2 credits, only when a new company detail is found - List a company using a technology: 1 credit, per company returned (a page with no companies is free) - List a job post: 1 credit, per job post returned (a page with none is free) - A company's hiring or job-post technologies: 1 credit, per company with data returned (none on record is free) - Watched-company signal delivered: 5 credits, per signal credit a delivered signal uses (none while monitors find nothing) - Check where a past champion works now: 5 credits, per check (each champion at most once a month) - Look up a phone number (valid, mobile / landline / VoIP, carrier, ported): 1 credit, per number looked up (the same number again within 90 days is free) - Look up a phone number with its listed caller name: 2 credits, per number looked up, name or not (the same number again within 90 days is free) - Look up a phone number with its name and business / person: 6 credits, per number looked up, name or not (the same number again within 90 days is free) - Look up who a phone number belongs to (caller identity): 12 credits, per number looked up, match or not (the same number again within 90 days is free) ## Docs - [Overview and quickstart](https://api.kamata.ai/docs) - [REST API reference](https://api.kamata.ai/docs/api): every endpoint grouped by area - [MCP server](https://api.kamata.ai/docs/mcp): install steps and every tool - [OpenAPI 3.1](https://api.kamata.ai/openapi.json) - [llms-full.txt](https://api.kamata.ai/docs/llms-full.txt): everything in one file - [Plans and pricing](https://www.kamata.ai/pricing/) Site: https://www.kamata.ai