{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"773261bf-17c4-4b1e-b73a-61fa620b13e8","name":"Signaliz API (Public Docs)","description":"# Signaliz API\n\nEverything you need to integrate with Signaliz across REST, SDK, CLI, Postman, and MCP.\n\nSignaliz is the GTM intelligence platform for AI-native revenue teams. Use it to discover companies and people, find and verify emails, detect buying signals, route customer-owned APIs through Nango, and run GTM Kernel workflows with campaign objects, provider routes, memory, feedback, and Brain learning loops.\n\n## Integration surfaces\n\n| Surface | When to use it | Install |\n| --- | --- | --- |\n| REST API | Direct HTTP from any language. | None. Base URL: `https://api.signaliz.com/functions/v1` |\n| TypeScript SDK | Node.js and browser apps with typed helpers. | `npm install @signaliz/sdk` (latest: 1.0.5) |\n| MCP Server | Claude Code, Claude Desktop, Cursor, Windsurf, Cline, and MCP-aware agents. | `npx -y @signaliz/mcp-server` (latest: 2.0.6) |\n| CLI | Terminal-first Ops and automation. | `npm install -g @signaliz/cli` (latest: 1.0.4) |\n\n# NPM\n\nYou can find our NPM Documentation here:\n\nSDK: [https://www.npmjs.com/package/@signaliz/sdk](https://www.npmjs.com/package/@signaliz/sdk)\n\nCLI: [https://www.npmjs.com/package/@signaliz/cli](https://www.npmjs.com/package/@signaliz/cli)\n\nMCP: [https://www.npmjs.com/package/@signaliz/mcp-server](https://www.npmjs.com/package/@signaliz/mcp-server)\n\n## GTM Kernel and Nango\n\nGTM Kernel gives agents a durable operating layer: campaign objects, provider links, memory search, feedback ingestion, Brain learning-cycle plans, and route activation. Nango-managed destination routes let agents use customer-owned CRM, sequencer, warehouse, and app APIs while credentials remain in Nango; Signaliz stores the workspace connection reference, approval boundary, and audit context.\n\n## MCP Server\n\nThe npm package is a stdio MCP bridge. Your MCP client talks to the local process, and the process securely calls the hosted Signaliz API with `SIGNALIZ_API_KEY`.\n\nClaude Code:\n\n``` bash\nclaude mcp add signaliz -e SIGNALIZ_API_KEY=sk_your_key -- npx -y @signaliz/mcp-server\n\n ```\n\nClaude Desktop, Cursor, Windsurf, or Cline:\n\n``` json\n{\n  \"mcpServers\": {\n    \"signaliz\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@signaliz/mcp-server\"],\n      \"env\": { \"SIGNALIZ_API_KEY\": \"sk_your_key\" }\n    }\n  }\n}\n\n ```\n\nOptional env override: `SIGNALIZ_API_URL`, defaulting to `https://api.signaliz.com/functions/v1`. Every MCP tool accepts `output_format` as `markdown` or `json`.\n\n## Pricing and limits\n\nPaid plans include API/MCP reads, companies, people, standard enrichment, GTM Kernel reads, and Ops workflows. Free is for exploration.\n\nFresh enrichment credits are used only when Signaliz creates, verifies, or fetches new premium data: fresh verified email discovery, live verification, fresh premium enrichment, and Signaliz-hosted AI. Available data, cache hits, standard company data, standard people data, and ordinary API/MCP reads do not consume fresh enrichment credits.\n\nLive email verification is 0.02 fresh enrichment credits when Signaliz verifies new premium data. Available or fresh-enough verification results return for 0 credits.\n\nFresh enrichment throughput by plan:\n\n| Plan | Fresh enrichments/min | API RPM | Burst RPM |\n| --- | --- | --- | --- |\n| Free | 60 | 1,000 | 1,500 |\n| Builder | 300 | 5,000 | 7,500 |\n| Team | 600 | 8,000 | 12,000 |\n| Agency | 1,000 | 10,000 | 15,000 |\n| Pay-As-You-Go | 1,000 | 5,000 | 7,500 |\n\nA 5,000/hour workspace safety cap protects the shared fresh-enrichment queue.\n\n## Capability index\n\nEmail and enrichment: `find_contacts_with_email`, `find_emails_with_verification`, `verify_email`, `enrich_company_signals`, `company_intelligence`, `execute_primitive`, `generic_http_request`, `custom_ai_prompt`.\n\nGTM Kernel and Brain: `gtm_campaign_build_plan`, `gtm_campaign_execution_status`, `gtm_campaign_learning_status`, `gtm_memory_search`, `gtm_brain_learning_cycle_plan`, `gtm_provider_route_activate`.\n\nBatch jobs: `find_and_verify_emails`, `verify_emails`, `enrich_company_signals_batch`, `batch_http_request`, `check_job_status`.\n\nDiscovery: `generate_leads`, `generate_local_leads`, `find_people_blitz`, `find_companies_blitz`.\n\nLists, systems, Ops Routines, approvals, app connections, Nango destination routes, GTM books/ICPs, budgets, blocklists, memory, and output sinks are available through the REST and MCP surfaces.\n\n## Async pattern\n\nBatch tools return a `job_id` immediately. Poll with `check_job_status`, or pass supported webhook callback fields to receive completion events.\n\n## Authentication\n\nUse `Authorization: Bearer sk_your_workspace_api_key` for REST calls. Never expose API keys in client-side code.\n\n## Error handling\n\n`429` responses include retry timing when API RPM or fresh enrichment throughput is exceeded. Retry transient `5xx` responses with exponential backoff.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"38230717","team":15193805,"collectionId":"773261bf-17c4-4b1e-b73a-61fa620b13e8","publishedId":"2sBXqGr25M","public":true,"publicUrl":"https://apidocs.signaliz.com","privateUrl":"https://go.postman.co/documentation/38230717-773261bf-17c4-4b1e-b73a-61fa620b13e8","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":"Connect any model, agent, workflow, or GTM motion to your ICP, Signals, and verified contact data. AI has found an engine in GTM via API, MCP, CLI, or wherever we need to meet you."},{"name":"title","value":"Signaliz API"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.11.6","publishDate":"2026-05-29T01:31:33.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Signaliz API","description":"Connect any model, agent, workflow, or GTM motion to your ICP, Signals, and verified contact data. AI has found an engine in GTM via API, MCP, CLI, or wherever we need to meet you."},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"Signaliz — Production","id":"24fbcd70-e08e-4b0f-be7c-c549ee87e89e","owner":"38230717","values":[{"enabled":true,"key":"base_url","value":"https://api.signaliz.com","type":"default","description":"Production API base URL for all Signaliz requests."},{"enabled":true,"key":"baseUrl","value":"https://api.signaliz.com","type":"default","description":"Alias of base_url — matches the collection variable naming so requests resolve automatically."},{"enabled":true,"key":"sk_api_key","value":"sk_replace_with_your_workspace_key","type":"secret","description":"Workspace API key from Signaliz Settings → API Keys. Starts with sk_. Never commit or expose client-side."},{"enabled":true,"key":"bearerToken","value":"sk_replace_with_your_workspace_key","type":"secret","description":"Alias of sk_api_key — matches the collection Bearer auth variable so {{bearerToken}} resolves automatically. Keep both in sync."},{"enabled":true,"key":"webhook_url","value":"","type":"default","description":"Optional — your webhook endpoint for async delivery (find-verified-email-v2, lead-generation-v2, find-people-v2, find-companies-v2)."},{"enabled":true,"key":"contact_id","value":"","type":"default","description":"Optional pass-through identifier returned in webhook payloads for request tracking."},{"enabled":true,"key":"default_model","value":"google/gemini-2.5-flash","type":"default","description":"Default OpenRouter model ID for custom-ai-prompt and company-signal-enrichment endpoints. Must be enabled in Settings → AI Models."}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/4b08d57267eae7acb66a908413b20e6582118c93d6ba1e0b61258a1da96612b8","favicon":"https://signaliz.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Signaliz — Production","value":"38230717-24fbcd70-e08e-4b0f-be7c-c549ee87e89e"}],"canonicalUrl":"https://apidocs.signaliz.com/view/metadata/2sBXqGr25M"}