{"openapi":"3.1.0","x-gtm-lead-planning":{"availability":"contracts_only","version_header":"X-GTM-Answer-Version","default_version":1,"planning_version":2,"description":"Pending saved-plan contracts. No planner route, full-plan response or execution-choice handling is enabled.","tools":[{"name":"gtm_plan_leads","description":"Free quote only: show relay and all three volume, credit and time options, then ask for a selection. Live mailbox checks included; unchecked unavailable. No supplier calls or reservation.","inputSchema":{"type":"object","properties":{"intent":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"people"},"icp":{"type":"object","properties":{"titles":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"industries":{"description":"Like SaaS","type":"array","items":{"type":"string"}},"company_sizes":{"description":"Like 20-99","type":"array","items":{"type":"string"}},"keywords":{"description":"In company description","type":"array","items":{"type":"string"}}},"additionalProperties":false},"signal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"hiring"},"roles":{"type":"array","items":{"type":"string"}}},"required":["kind","roles"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"funding"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"lookalike"},"domains":{"type":"array","items":{"type":"string"}}},"required":["kind","domains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"engagers"},"post_urls":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["kind","post_urls"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"company"},"domains":{"type":"array","items":{"type":"string"}},"icp":{"type":"object","properties":{"titles":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"industries":{"description":"Like SaaS","type":"array","items":{"type":"string"}},"company_sizes":{"description":"Like 20-99","type":"array","items":{"type":"string"}},"keywords":{"description":"In company description","type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["kind","domains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"local"},"business_type":{"type":"string"},"location":{"type":"string"},"icp":{"type":"object","properties":{"titles":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"industries":{"description":"Like SaaS","type":"array","items":{"type":"string"}},"company_sizes":{"description":"Like 20-99","type":"array","items":{"type":"string"}},"keywords":{"description":"In company description","type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["kind","business_type","location"],"additionalProperties":false}]},"target":{"type":"integer"},"target_unit":{"default":"people_with_email","type":"string","enum":["people_with_email","companies"]},"contacts_per_company":{"type":"integer"},"quality":{"default":"checked","type":"string","const":"checked"},"extra_recheck":{"default":false,"type":"boolean"}},"required":["intent"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"gtm_find_leads","description":"Execute a saved plan choice after revalidating identity, expiry, prices, balance and agent cap. A choice is not proof of human consent. Explicit target and budget remain an authorized shortcut; ambiguous calls return a free plan.","inputSchema":{"anyOf":[{"type":"object","properties":{"plan_id":{"type":"string"},"option_id":{"type":"string"},"max_credits":{"type":"integer"},"idempotency_key":{"type":"string"}},"required":["plan_id","option_id","max_credits","idempotency_key"],"additionalProperties":false},{"type":"object","properties":{"titles":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"industries":{"description":"Like SaaS","type":"array","items":{"type":"string"}},"company_sizes":{"description":"Like 20-99","type":"array","items":{"type":"string"}},"keywords":{"description":"In company description","type":"array","items":{"type":"string"}},"hiring_roles":{"description":"Signal; a tool's name finds its users","type":"array","items":{"type":"string"}},"recently_funded":{"type":"boolean"},"like_companies":{"type":"array","items":{"type":"string"}},"post_urls":{"type":"array","items":{"type":"string"}},"target":{"description":"Ask the user","type":"integer"},"max_per_company":{"description":"Default 2","type":"integer"},"verify":{"type":"boolean"},"max_credits":{"type":"integer"},"idempotency_key":{"type":"string"},"dry_run":{"type":"boolean"}},"additionalProperties":false}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":true}}]},"info":{"title":"GTMMAXING API","version":"1.0.0","summary":"Contact enrichment, lead lists and GTM research, billed in prepaid credits.","description":"Every call is `POST /v1/agent/tools/{tool}` with a JSON body. Paid tools need `max_credits` and never spend more; `dry_run: true` quotes for free."},"x-service-info":{"categories":["data","sales"],"docs":{"homepage":"https://gtmmaxing.com","apiReference":"https://gtmmaxing.com/developers/","llms":"https://gtmmaxing.com/llms.txt"}},"servers":[{"url":"https://gtmmaxing.com"}],"externalDocs":{"url":"https://gtmmaxing.com/developers/"},"security":[{"apiKey":[]},{"oauth2":["gtm:read","gtm:run"]}],"tags":[{"name":"Catalog","description":"Discover tools."},{"name":"Free tools","description":"Results, account and catalog search."},{"name":"Paid tools","description":"Spend credits, up to max_credits."},{"name":"Pay per call","description":"No account: pay each found email or definitive verdict over MPP or x402. Unsuccessful calls are free."}],"paths":{"/v1/agent/tools":{"get":{"operationId":"listTools","summary":"List tools","description":"Public. Every tool with its JSON input schema; the same catalog the CLI uses.","security":[],"tags":["Catalog"],"responses":{"200":{"description":"Tool catalog","content":{"application/json":{"schema":{"type":"object","properties":{"tools":{"type":"array","items":{"type":"object"}}}}}}}}}},"/v1/agent/topups/options":{"get":{"operationId":"topupOptions","summary":"Ways to pay","tags":["Buy credits"],"description":"Networks, tokens and limits, whether the owner allows this agent to buy, and the `account` the wallet signs for.","responses":{"200":{"description":"Options","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing or invalid token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/topups":{"post":{"operationId":"createTopup","summary":"Buy credits from the agent's wallet","tags":["Buy credits"],"description":"Quotes a payment through Uniswap to USDC on Base. `signature` is the wallet's personal_sign of `GTMMAXING credit top-up\\nAccount: <account>\\nWallet: <wallet>\\nIssued: <issued_at>`, lowercased addresses and emails. `rail: auto` sends a payment that fits to the Token Jar and otherwise swaps.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"string"},"signature":{"type":"string"},"issued_at":{"type":"integer","description":"Milliseconds since the epoch"},"chain_id":{"type":"integer"},"token":{"type":"string","description":"Token address; the zero address is the native coin"},"amount":{"type":"string","description":"In the token's smallest unit"},"rail":{"type":"string","enum":["usdc","swap","jar","auto"]}},"required":["wallet","signature","issued_at","chain_id","token","amount"]}}}},"responses":{"200":{"description":"The payment so far. Do what `topup.action` says with your wallet, then call `next` with the transaction hash or signature; repeat until `status` is no longer `open`.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid, too small, too large or no route","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The owner has not switched on buying credits for this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/topups/{id}/next":{"post":{"operationId":"advanceTopup","summary":"Report a wallet step and get the next one","tags":["Buy credits"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"tx_hash":{"type":"string"},"signature":{"type":"string"}}}}}},"responses":{"200":{"description":"The payment so far. Do what `topup.action` says with your wallet, then call `next` with the transaction hash or signature; repeat until `status` is no longer `open`.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing or invalid token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The owner has not switched on buying credits for this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_watch":{"post":{"operationId":"watch","summary":"Watches","description":"5/change, headcount/tech-stack 15, job-change 40. Quote first.\n\nPaid: send `dry_run: true` for a free quote, then the same body with `max_credits` set to your budget and an `idempotency_key`.","tags":["Paid tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"enum":["create","list","show","changes","pause","resume","delete","webhook_set","webhook_show","webhook_rotate","webhook_remove","webhook_test"]},"url":{},"name":{},"companies":{"type":"array","items":{}},"signal":{"enum":["hiring","headcount","tech-stack","funding","topic","job-change"]},"role":{},"topic":{},"sources":{"type":"array","items":{"enum":["reddit","x"]}},"max_credits":{"type":"integer"},"quote_id":{},"watch_id":{},"since":{"type":"integer"},"offset":{"type":"integer"},"dry_run":{"type":"boolean"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_find_contacts":{"post":{"operationId":"findContacts","summary":"Find contacts","description":"Profiles/names/run_id: 1 cr/email; mailbox check included, 5 cr/phone, recheck 2. Misses free.\n\nPaid: send `dry_run: true` for a free quote, then the same body with `max_credits` set to your budget and an `idempotency_key`.","tags":["Paid tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."},{"name":"X-GTM-Answer-Version","in":"header","required":false,"schema":{"type":"string","enum":["1","2"],"default":"1"},"description":"2 includes structured credit estimates; 1 or an unknown version keeps all quantities in the original table and report."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"people":{"type":"array","items":{"type":"string"},"maxItems":100},"run_id":{"description":"People from a list run","type":"string"},"named":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"company":{"type":"string"}},"required":["name","company"],"additionalProperties":false}},"find":{"description":"Default [\"email\"]","type":"array","items":{"type":"string","enum":["email","phone"]}},"verify":{"description":"Extra recheck","type":"boolean"},"target":{"description":"Required for run_id","type":"integer"},"max_credits":{"type":"integer"},"idempotency_key":{},"dry_run":{"type":"boolean"}},"additionalProperties":false,"required":["max_credits"]}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_build_list":{"post":{"operationId":"buildList","summary":"Build a lead list","description":"People 2 cr/100; decision-makers 2 cr/domain; local businesses 1 cr. Empty free.\n\nPaid: send `dry_run: true` for a free quote, then the same body with `max_credits` set to your budget and an `idempotency_key`.","tags":["Paid tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titles":{"type":"array","items":{"type":"string"}},"company":{"description":"Company domain: decision-makers there","type":"string"},"companies":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"industries":{"type":"array","items":{"type":"string"}},"company_sizes":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"business_type":{"type":"string"},"page":{"type":"integer"},"limit":{"type":"integer"},"max_credits":{"type":"integer"},"idempotency_key":{},"dry_run":{"type":"boolean"}},"additionalProperties":false,"required":["max_credits"]}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_find_leads":{"post":{"operationId":"findLeads","summary":"Find leads","description":"Ask target; absent plans free; dry_run quotes. Run with max_credits.\n\nPaid: send `dry_run: true` for a free quote, then the same body with `max_credits` set to your budget and an `idempotency_key`.","tags":["Paid tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."},{"name":"X-GTM-Answer-Version","in":"header","required":false,"schema":{"type":"string","enum":["1","2"],"default":"1"},"description":"2 includes structured credit estimates; 1 or an unknown version keeps all quantities in the original table and report."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titles":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"industries":{"description":"Like SaaS","type":"array","items":{"type":"string"}},"company_sizes":{"description":"Like 20-99","type":"array","items":{"type":"string"}},"keywords":{"description":"In company description","type":"array","items":{"type":"string"}},"hiring_roles":{"description":"Signal; a tool's name finds its users","type":"array","items":{"type":"string"}},"recently_funded":{"type":"boolean"},"like_companies":{"type":"array","items":{"type":"string"}},"post_urls":{"type":"array","items":{"type":"string"}},"target":{"description":"Ask the user","type":"integer"},"max_per_company":{"description":"Default 2","type":"integer"},"verify":{"type":"boolean"},"max_credits":{"type":"integer"},"idempotency_key":{},"dry_run":{"type":"boolean"}},"additionalProperties":false,"required":["max_credits"]}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_research_company":{"post":{"operationId":"researchCompany","summary":"Research a company","description":"Domain profile, sales brief: up to 2 cr; misses free.\n\nPaid: send `dry_run: true` for a free quote, then the same body with `max_credits` set to your budget and an `idempotency_key`.","tags":["Paid tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"max_credits":{"type":"integer"},"idempotency_key":{},"dry_run":{"type":"boolean"}},"required":["company","max_credits"],"additionalProperties":false}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_find_signals":{"post":{"operationId":"findSignals","summary":"Find hiring signals","description":"Companies hiring a role, last 30 days. 1 cr/nonempty search.\n\nPaid: send `dry_run: true` for a free quote, then the same body with `max_credits` set to your budget and an `idempotency_key`.","tags":["Paid tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string"},"location":{"type":"string"},"company":{"type":"string"},"industries":{"type":"array","items":{"type":"string"}},"company_sizes":{"type":"array","items":{"type":"string"}},"page":{"type":"integer"},"limit":{"type":"integer"},"max_credits":{"type":"integer"},"idempotency_key":{},"dry_run":{"type":"boolean"}},"required":["role","max_credits"],"additionalProperties":false}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_results":{"post":{"operationId":"results","summary":"Get results","description":"Free rows, status, CSV.\n\nFree.","tags":["Free tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"run_id":{"type":"string"},"offset":{"type":"integer"},"format":{"type":"string","enum":["rows","csv"]}},"required":["run_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_tools":{"post":{"operationId":"tools","summary":"Other tools","description":"Search/describe capabilities free; run with max_credits.\n\nPaid: send `dry_run: true` for a free quote, then the same body with `max_credits` set to your budget and an `idempotency_key`.","tags":["Paid tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["search","describe","run"]},"query":{"type":"string"},"capability":{"type":"string","description":"From catalog search"},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"max_credits":{"type":"integer"},"idempotency_key":{},"dry_run":{"type":"boolean"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_workspace":{"post":{"operationId":"workspace","summary":"Workspace memory","description":"Free ICP, exclusions and seen-lead memory.\n\nFree.","tags":["Free tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["get","set_icp","exclude","forget_seen"]},"icp":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"domains":{"type":"array","items":{"type":"string"}},"profiles":{"type":"array","items":{"type":"string"}}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/tools/gtm_account":{"post":{"operationId":"account","summary":"Account","description":"Free balance, cap, spend, quote.\n\nFree.","tags":["Free tools"],"parameters":[{"name":"X-GTM-Source","in":"header","required":false,"schema":{"type":"string","maxLength":40},"description":"Name of your product or integration, used to attribute usage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote":{"type":"object","properties":{"capability":{"type":"string"},"count":{"type":"integer"}},"required":["capability","count"],"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"200":{"description":"An answer. Quotes and refusals are 200 answers, not HTTP errors: branch on `answer.status`. Send `Accept: text/plain` to get only the text.","content":{"application/json":{"schema":{"type":"object","required":["answer","text"],"properties":{"answer":{"$ref":"#/components/schemas/Answer"},"text":{"type":"string","description":"The same answer as compact text, ready for an LLM prompt."}}}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The body is not valid JSON (`invalid_json`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, wrong or revoked credential (`invalid_token`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential cannot spend credits (`insufficient_scope`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body over 64 KB (`request_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (`rate_limited`). Wait `Retry-After` seconds and resend the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/email-finder":{"post":{"operationId":"email-finder","summary":"Find a work email from a LinkedIn profile URL, handle, or name and company.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"profile":{"type":"string","minLength":1,"maxLength":2048}},"required":["profile"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"company":{"type":"string","minLength":1,"maxLength":100}},"required":["name","company"],"additionalProperties":false}]}}}},"x-payment-info":{"intent":"charge","method":"tempo","amount":"20000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Charged only when an email is found."},"x-mpp-price":{"amount":"20000","decimals":6,"currency":"0x20c000000000000000000000b9537d11c60e8b50"},"x-x402":{"x402Version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"20000","payTo":"0x81a55899A97F5ae90f2d0549A4069594a2A0E914"},"responses":{"200":{"description":"Result with Payment-Receipt (MPP) or PAYMENT-RESPONSE (x402) when paid. Finder misses and inconclusive verification results are free.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","enum":["found","not_found"]},"email":{"type":["string","null"]},"name":{"type":["string","null"]},"title":{"type":["string","null"]},"deliverability":{"anyOf":[{"type":"string","const":"verified"},{"type":"null"}]}},"required":["status","email","name","title","deliverability"],"additionalProperties":false}}},"headers":{"Payment-Receipt":{"schema":{"type":"string"},"description":"MPP receipt for a paid delivery"},"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement for a paid delivery, base64 JSON"}}},"202":{"description":"Work is pending. Repeat the identical request after Retry-After."},"400":{"description":"Invalid input"},"402":{"description":"Payment required. MPP clients use WWW-Authenticate and retry with Authorization: Payment. x402 clients read PAYMENT-REQUIRED and retry the identical body with PAYMENT-SIGNATURE. No found email is included."},"409":{"description":"Payment request mismatch, pending work, or payment needs reconciliation. Do not make another payment."},"429":{"description":"Daily unpaid-work limit reached"},"503":{"description":"Payments disabled or temporarily unavailable"}},"tags":["Pay per call"]}},"/mpp/email-verifier":{"post":{"operationId":"email-verifier","summary":"Check an email mailbox and return a verdict.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"],"additionalProperties":false}}}},"x-payment-info":{"intent":"charge","method":"tempo","amount":"40000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Charged only for a definitive verdict."},"x-mpp-price":{"amount":"40000","decimals":6,"currency":"0x20c000000000000000000000b9537d11c60e8b50"},"x-x402":{"x402Version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"40000","payTo":"0x81a55899A97F5ae90f2d0549A4069594a2A0E914"},"responses":{"200":{"description":"Result with Payment-Receipt (MPP) or PAYMENT-RESPONSE (x402) when paid. Finder misses and inconclusive verification results are free.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string"},"verdict":{"type":"string","enum":["valid","invalid","accept_all","unknown","webmail","disposable"]},"score":{"type":["number","null"]},"checkedAt":{"type":["string","null"]}},"required":["email","verdict","score","checkedAt"],"additionalProperties":false}}},"headers":{"Payment-Receipt":{"schema":{"type":"string"},"description":"MPP receipt for a paid delivery"},"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement for a paid delivery, base64 JSON"}}},"202":{"description":"Work is pending. Repeat the identical request after Retry-After."},"400":{"description":"Invalid input"},"402":{"description":"Payment required. MPP clients use WWW-Authenticate and retry with Authorization: Payment. x402 clients read PAYMENT-REQUIRED and retry the identical body with PAYMENT-SIGNATURE. No found email is included."},"409":{"description":"Payment request mismatch, pending work, or payment needs reconciliation. Do not make another payment."},"429":{"description":"Daily unpaid-work limit reached"},"503":{"description":"Payments disabled or temporarily unavailable"}},"tags":["Pay per call"]}}},"components":{"schemas":{"Answer":{"type":"object","properties":{"quality":{"type":"object","properties":{"requested":{"type":"integer","minimum":0,"maximum":9007199254740991},"returned":{"type":"integer","minimum":0,"maximum":9007199254740991},"dropped":{"type":"object","properties":{"duplicate":{"type":"integer","minimum":0,"maximum":9007199254740991},"already_found":{"type":"integer","minimum":0,"maximum":9007199254740991},"invalid_result":{"type":"integer","minimum":0,"maximum":9007199254740991},"identity":{"type":"integer","minimum":0,"maximum":9007199254740991},"invalid_mailbox":{"type":"integer","minimum":0,"maximum":9007199254740991},"off_topic":{"type":"integer","minimum":0,"maximum":9007199254740991},"no_email":{"type":"integer","minimum":0,"maximum":9007199254740991},"excluded":{"type":"integer","minimum":0,"maximum":9007199254740991},"stale":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false},"verified":{"type":"integer","minimum":0,"maximum":9007199254740991},"more":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["page"],"additionalProperties":false},"message":{"type":"string","maxLength":200}},"required":["returned"],"additionalProperties":false},"status":{"type":"string","enum":["completed","not_found","running","refused","quote","error"]},"summary":{"type":"string","minLength":1,"maxLength":200},"reason":{"type":"string","maxLength":40},"run_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"cost":{"type":"integer","minimum":0,"maximum":9007199254740991},"run_cost":{"type":"integer","minimum":0,"maximum":9007199254740991},"balance":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"quote":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"label":{"type":"string","minLength":1,"maxLength":24},"columns":{"maxItems":6,"type":"array","items":{"type":"string","maxLength":32}},"rows":{"maxItems":5,"type":"array","items":{"type":"array","items":{"type":["string","number","boolean","null"]}}},"next":{"type":"object","properties":{"tool":{"type":"string","maxLength":40},"args":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["tool","args"],"additionalProperties":false},"fields":{"maxItems":12,"type":"array","items":{"type":"string","maxLength":40}},"link":{"type":"string","maxLength":512},"top_up":{"type":"object","properties":{"url":{"type":"string","maxLength":256},"credits":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["url","credits"],"additionalProperties":false},"replayed":{"type":"boolean","const":true},"report":{"type":"string","maxLength":240},"estimate":{"type":"object","properties":{"target":{"anyOf":[{"type":"integer","minimum":1,"maximum":500},{"type":"null"}]},"credits":{"anyOf":[{"type":"array","prefixItems":[{"type":"integer","minimum":0,"maximum":100000},{"type":"integer","minimum":0,"maximum":100000}],"items":false,"minItems":2,"maxItems":2},{"type":"null"}]},"with_recheck":{"anyOf":[{"type":"array","prefixItems":[{"type":"integer","minimum":0,"maximum":100000},{"type":"integer","minimum":0,"maximum":100000}],"items":false,"minItems":2,"maxItems":2},{"type":"null"}]},"cap_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"affordable_target":{"type":"integer","minimum":0,"maximum":500},"affordable_with_recheck":{"type":"integer","minimum":0,"maximum":500},"email_credits":{"type":"number","const":1},"recheck_credits":{"type":"number","const":2}},"required":["target","credits","with_recheck","cap_remaining","affordable_target","affordable_with_recheck","email_credits","recheck_credits"],"additionalProperties":false},"progress":{"type":"object","properties":{"found":{"type":"integer","minimum":0,"maximum":9007199254740991},"target":{"type":"integer","minimum":1,"maximum":500},"spent":{"type":"integer","minimum":0,"maximum":100000},"budget_left":{"type":"integer","minimum":0,"maximum":100000},"state":{"type":"string","enum":["running","done","stopped"]},"stop":{"type":"string","enum":["sources_exhausted","budget_reached","agent_cap","out_of_credits","search_limit","agent_stopped","tool_unavailable"]}},"required":["found","target","spent","budget_left","state"],"additionalProperties":false}},"required":["status","summary","run_id","cost","balance","total","label","columns","rows","next"],"additionalProperties":false},"LeadPlanInput":{"type":"object","properties":{"intent":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"people"},"icp":{"type":"object","properties":{"titles":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"location":{"type":"string","minLength":1,"maxLength":100},"industries":{"description":"Like SaaS","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"company_sizes":{"description":"Like 20-99","minItems":1,"maxItems":9,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}},"keywords":{"description":"In company description","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}}},"additionalProperties":false},"signal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"hiring"},"roles":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["kind","roles"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"funding"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"lookalike"},"domains":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["kind","domains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"engagers"},"post_urls":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","maxLength":500,"format":"uri"}}},"required":["kind","post_urls"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"company"},"domains":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"icp":{"type":"object","properties":{"titles":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"location":{"type":"string","minLength":1,"maxLength":100},"industries":{"description":"Like SaaS","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"company_sizes":{"description":"Like 20-99","minItems":1,"maxItems":9,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}},"keywords":{"description":"In company description","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}}},"additionalProperties":false}},"required":["kind","domains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"local"},"business_type":{"type":"string","minLength":1,"maxLength":100},"location":{"type":"string","minLength":1,"maxLength":100},"icp":{"type":"object","properties":{"titles":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"location":{"type":"string","minLength":1,"maxLength":100},"industries":{"description":"Like SaaS","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"company_sizes":{"description":"Like 20-99","minItems":1,"maxItems":9,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}},"keywords":{"description":"In company description","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}}},"additionalProperties":false}},"required":["kind","business_type","location"],"additionalProperties":false}]},"target":{"type":"integer","minimum":1,"maximum":500},"target_unit":{"default":"people_with_email","type":"string","enum":["people_with_email","companies"]},"contacts_per_company":{"type":"integer","minimum":1,"maximum":5},"quality":{"default":"checked","type":"string","const":"checked"},"extra_recheck":{"default":false,"type":"boolean"}},"required":["intent"],"additionalProperties":false},"LeadPlanChoice":{"type":"object","properties":{"plan_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"option_id":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[A-Za-z0-9_-]+$"},"max_credits":{"type":"integer","minimum":0,"maximum":100000},"idempotency_key":{"type":"string","pattern":"^[\\x21-\\x7e]{8,128}$"}},"required":["plan_id","option_id","max_credits","idempotency_key"],"additionalProperties":false},"LeadPlanQuote":{"type":"object","properties":{"kind":{"type":"string","const":"lead_plan"},"version":{"type":"number","const":1},"status":{"type":"string","const":"quote"},"plan_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"expires_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"cost":{"type":"number","const":0},"requires_confirmation":{"type":"boolean","const":true},"target_unit":{"type":"string","enum":["people_with_email","companies"]},"contacts_per_company":{"type":"integer","minimum":1,"maximum":5},"recommended_option":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[A-Za-z0-9_-]+$"},"options":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[A-Za-z0-9_-]+$"},"target":{"type":"integer","minimum":1,"maximum":500},"quality":{"type":"string","const":"checked"},"extra_recheck":{"type":"boolean"},"estimated_credits":{"type":"integer","minimum":0,"maximum":100000},"max_credits":{"type":"integer","minimum":0,"maximum":100000},"estimated_results":{"type":"array","prefixItems":[{"type":"integer","minimum":0,"maximum":500},{"type":"integer","minimum":0,"maximum":500}],"items":false,"minItems":2,"maxItems":2},"eta":{"oneOf":[{"type":"object","properties":{"basis":{"type":"string","const":"unavailable"}},"required":["basis"],"additionalProperties":false},{"type":"object","properties":{"basis":{"type":"string","const":"measured"},"seconds":{"type":"array","prefixItems":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"integer","minimum":0,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2},"sample_size":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"confidence":{"type":"string","enum":["low","medium","high"]}},"required":["basis","seconds","sample_size","confidence"],"additionalProperties":false},{"type":"object","properties":{"basis":{"type":"string","const":"conservative_model"},"seconds":{"type":"array","prefixItems":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"integer","minimum":0,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2},"assumptions":{"type":"string","minLength":1,"maxLength":160},"confidence":{"type":"string","enum":["low","medium","high"]}},"required":["basis","seconds","assumptions","confidence"],"additionalProperties":false}]},"availability":{"type":"string","enum":["available","cap_change_required","insufficient_balance","source_unavailable","capacity_exceeded"]},"reason":{"type":"string","minLength":1,"maxLength":160}},"required":["id","target","quality","extra_recheck","estimated_credits","max_credits","estimated_results","eta","availability"],"additionalProperties":false}},"estimate_basis":{"type":"object","properties":{"method":{"type":"string","enum":["heuristic","measured","conservative_model"]},"sample_size":{"type":"integer","minimum":0,"maximum":9007199254740991},"confidence":{"type":"string","enum":["low","medium","high"]}},"required":["method","sample_size","confidence"],"additionalProperties":false},"quality_prices":{"type":"object","properties":{"checked":{"type":"object","properties":{"email_credits":{"type":"number","const":1},"mailbox_check_included":{"type":"boolean","const":true},"definitive_verdict_guaranteed":{"type":"boolean","const":false}},"required":["email_credits","mailbox_check_included","definitive_verdict_guaranteed"],"additionalProperties":false},"extra_recheck":{"type":"object","properties":{"optional":{"type":"boolean","const":true},"credits":{"type":"number","const":2}},"required":["optional","credits"],"additionalProperties":false},"unchecked":{"type":"object","properties":{"availability":{"type":"string","const":"not_offered_under_current_policy"},"email_credits":{"type":"null"}},"required":["availability","email_credits"],"additionalProperties":false}},"required":["checked","extra_recheck","unchecked"],"additionalProperties":false},"relay":{"type":"string","minLength":1,"maxLength":240},"next":{"type":"object","properties":{"tool":{"type":"string","const":"human"},"args":{"type":"object","properties":{"message":{"type":"string","const":"Show all options and obtain a selection and credit limit before executing."}},"required":["message"],"additionalProperties":false}},"required":["tool","args"],"additionalProperties":false},"affordable_target":{"type":"integer","minimum":0,"maximum":500},"top_up":{"type":"object","properties":{"url":{"type":"string","maxLength":256,"format":"uri"},"credits":{"type":"integer","minimum":0,"maximum":100000}},"required":["url","credits"],"additionalProperties":false}},"required":["kind","version","status","plan_id","created_at","expires_at","cost","requires_confirmation","target_unit","recommended_option","options","estimate_basis","quality_prices","relay","next"],"additionalProperties":false},"LeadPlanSnapshot":{"type":"object","properties":{"plan_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"expires_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"account_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"catalog_version":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"price_version":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"workspace_version":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"exclusion_version":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"request":{"type":"object","properties":{"intent":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"people"},"icp":{"type":"object","properties":{"titles":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"location":{"type":"string","minLength":1,"maxLength":100},"industries":{"description":"Like SaaS","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"company_sizes":{"description":"Like 20-99","minItems":1,"maxItems":9,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}},"keywords":{"description":"In company description","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}}},"additionalProperties":false},"signal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"hiring"},"roles":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["kind","roles"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"funding"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"lookalike"},"domains":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["kind","domains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"engagers"},"post_urls":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","maxLength":500,"format":"uri"}}},"required":["kind","post_urls"],"additionalProperties":false}]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"company"},"domains":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"icp":{"type":"object","properties":{"titles":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"location":{"type":"string","minLength":1,"maxLength":100},"industries":{"description":"Like SaaS","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"company_sizes":{"description":"Like 20-99","minItems":1,"maxItems":9,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}},"keywords":{"description":"In company description","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}}},"additionalProperties":false}},"required":["kind","domains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"local"},"business_type":{"type":"string","minLength":1,"maxLength":100},"location":{"type":"string","minLength":1,"maxLength":100},"icp":{"type":"object","properties":{"titles":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"location":{"type":"string","minLength":1,"maxLength":100},"industries":{"description":"Like SaaS","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"company_sizes":{"description":"Like 20-99","minItems":1,"maxItems":9,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}},"keywords":{"description":"In company description","minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}}},"additionalProperties":false}},"required":["kind","business_type","location"],"additionalProperties":false}]},"target":{"type":"integer","minimum":1,"maximum":500},"target_unit":{"default":"people_with_email","type":"string","enum":["people_with_email","companies"]},"contacts_per_company":{"type":"integer","minimum":1,"maximum":5},"quality":{"default":"checked","type":"string","const":"checked"},"extra_recheck":{"default":false,"type":"boolean"}},"required":["intent"],"additionalProperties":false},"source_family":{"type":"string","enum":["directory","company_signal","company","local","engagers"]},"source_bounds":{"type":"object","properties":{"max_pages":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"max_profiles":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"max_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"max_children":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["max_pages","max_profiles","max_seconds","max_children"],"additionalProperties":false},"quote":{"type":"object","properties":{"kind":{"type":"string","const":"lead_plan"},"version":{"type":"number","const":1},"status":{"type":"string","const":"quote"},"plan_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"expires_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"cost":{"type":"number","const":0},"requires_confirmation":{"type":"boolean","const":true},"target_unit":{"type":"string","enum":["people_with_email","companies"]},"contacts_per_company":{"type":"integer","minimum":1,"maximum":5},"recommended_option":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[A-Za-z0-9_-]+$"},"options":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[A-Za-z0-9_-]+$"},"target":{"type":"integer","minimum":1,"maximum":500},"quality":{"type":"string","const":"checked"},"extra_recheck":{"type":"boolean"},"estimated_credits":{"type":"integer","minimum":0,"maximum":100000},"max_credits":{"type":"integer","minimum":0,"maximum":100000},"estimated_results":{"type":"array","prefixItems":[{"type":"integer","minimum":0,"maximum":500},{"type":"integer","minimum":0,"maximum":500}],"items":false,"minItems":2,"maxItems":2},"eta":{"oneOf":[{"type":"object","properties":{"basis":{"type":"string","const":"unavailable"}},"required":["basis"],"additionalProperties":false},{"type":"object","properties":{"basis":{"type":"string","const":"measured"},"seconds":{"type":"array","prefixItems":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"integer","minimum":0,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2},"sample_size":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"confidence":{"type":"string","enum":["low","medium","high"]}},"required":["basis","seconds","sample_size","confidence"],"additionalProperties":false},{"type":"object","properties":{"basis":{"type":"string","const":"conservative_model"},"seconds":{"type":"array","prefixItems":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"integer","minimum":0,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2},"assumptions":{"type":"string","minLength":1,"maxLength":160},"confidence":{"type":"string","enum":["low","medium","high"]}},"required":["basis","seconds","assumptions","confidence"],"additionalProperties":false}]},"availability":{"type":"string","enum":["available","cap_change_required","insufficient_balance","source_unavailable","capacity_exceeded"]},"reason":{"type":"string","minLength":1,"maxLength":160}},"required":["id","target","quality","extra_recheck","estimated_credits","max_credits","estimated_results","eta","availability"],"additionalProperties":false}},"estimate_basis":{"type":"object","properties":{"method":{"type":"string","enum":["heuristic","measured","conservative_model"]},"sample_size":{"type":"integer","minimum":0,"maximum":9007199254740991},"confidence":{"type":"string","enum":["low","medium","high"]}},"required":["method","sample_size","confidence"],"additionalProperties":false},"quality_prices":{"type":"object","properties":{"checked":{"type":"object","properties":{"email_credits":{"type":"number","const":1},"mailbox_check_included":{"type":"boolean","const":true},"definitive_verdict_guaranteed":{"type":"boolean","const":false}},"required":["email_credits","mailbox_check_included","definitive_verdict_guaranteed"],"additionalProperties":false},"extra_recheck":{"type":"object","properties":{"optional":{"type":"boolean","const":true},"credits":{"type":"number","const":2}},"required":["optional","credits"],"additionalProperties":false},"unchecked":{"type":"object","properties":{"availability":{"type":"string","const":"not_offered_under_current_policy"},"email_credits":{"type":"null"}},"required":["availability","email_credits"],"additionalProperties":false}},"required":["checked","extra_recheck","unchecked"],"additionalProperties":false},"relay":{"type":"string","minLength":1,"maxLength":240},"next":{"type":"object","properties":{"tool":{"type":"string","const":"human"},"args":{"type":"object","properties":{"message":{"type":"string","const":"Show all options and obtain a selection and credit limit before executing."}},"required":["message"],"additionalProperties":false}},"required":["tool","args"],"additionalProperties":false},"affordable_target":{"type":"integer","minimum":0,"maximum":500},"top_up":{"type":"object","properties":{"url":{"type":"string","maxLength":256,"format":"uri"},"credits":{"type":"integer","minimum":0,"maximum":100000}},"required":["url","credits"],"additionalProperties":false}},"required":["kind","version","status","plan_id","created_at","expires_at","cost","requires_confirmation","target_unit","recommended_option","options","estimate_basis","quality_prices","relay","next"],"additionalProperties":false}},"required":["plan_id","created_at","expires_at","account_id","catalog_version","price_version","workspace_version","exclusion_version","request","source_family","source_bounds","quote"],"additionalProperties":false},"AgentResponseV2":{"oneOf":[{"$ref":"#/components/schemas/Answer"},{"$ref":"#/components/schemas/LeadPlanQuote"}]},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key from https://gtmmaxing.com/features/api-keys."},"oauth2":{"type":"oauth2","description":"For apps acting for their users. PKCE (S256) is required. Discovery: https://gtmmaxing.com/.well-known/oauth-authorization-server.","flows":{"authorizationCode":{"authorizationUrl":"https://gtmmaxing.com/oauth/authorize","tokenUrl":"https://gtmmaxing.com/oauth/token","refreshUrl":"https://gtmmaxing.com/oauth/token","scopes":{"gtm:read":"Read account, results and catalog","gtm:run":"Spend credits on paid tools, within max_credits"}}}}}}}