{
"error": {
"code": "invalid_api_key",
"message": "Provide a valid API credential."
}
}
{
"error": {
"code": "subscription_required",
"message": "An active or trialing subscription is required."
}
}
{
"error": {
"code": "company_not_found",
"message": "No deliverable company has that ID."
}
}
{
"error": {
"code": "invalid_search",
"message": "background must be a boolean"
}
}
{
"error": {
"code": "request_limit_reached",
"message": "The subscription request limit has been reached.",
"retry_at": "2026-09-25T05:00:00Z",
"retry_after_seconds": 60
}
}
Companies
Get company
Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries.
Examples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Jolts","description":"Company research for your AI agent. Connect with MCP or build with the HTTP API.","colors":{"primary":"#60B5FF","light":"#60B5FF","dark":"#1767AB"},"api":{"playground":{"display":"simple"},"examples":{"languages":["bash","python","javascript","ruby","php","go","java"]}},"appearance":{"default":"dark","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#17191A"}},"navbar":{"links":[{"href":"https://jolts.xyz/","label":"Website"},{"href":"https://jolts.xyz/skills","label":"Skills"}],"primary":{"type":"button","label":"Sign in","href":"https://app.jolts.xyz/session/new"}},"fonts":{"family":"system-ui"},"integrations":{"intercom":{"appId":"z6eerks2"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"jolts","hasAudioNarration":false,"actualSubdomain":"jolts","customDomains":["dev.jolts.xyz"],"gitSource":{"type":"github","owner":"the-s-anton","repo":"rails-addresses","deployBranch":"main","contentDirectory":"developer","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aba97f9e5024a36fdb3b695","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"MCP","count":12},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Set up your assistant","count":5},{"language":"default","tag":"Getting started","count":4},{"language":"default","tag":"Tool reference","count":4},{"language":"default","tag":"Companies","count":4},{"language":"default","tag":"MCP essentials","count":3},{"language":"default","tag":"Use cases","count":3},{"language":"default","tag":"Jolts data","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/companies/get-company","slug":"/api-reference/companies/get-company","pageMetadata":{"title":"Get company","description":"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries.\n\nExamples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/companies/{id}","href":"/api-reference/companies/get-company","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Examples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get company","description":"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries.\n\nExamples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/companies/{id}","href":"/api-reference/companies/get-company","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getCompany","tags":["Companies"],"summary":"Get company","description":"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries.\n\nExamples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.","parameters":["52e4015b-7dea-413f-a33d-89f9f2f08bc5","87b010b0-ef11-4f91-8916-8544809e1736"],"responses":{"200":"1e1f89f3-ea66-44fa-b383-ee46f81c0b33","202":"029dee2e-a3ce-4720-a093-6fccb9e1627f","401":"b7c91365-4082-496a-ae38-e0c1aff3039e","402":"42a04d10-61bc-4bf9-a376-fbe9945862d1","404":"e7663d5f-6756-468a-a695-0c69442b47f9","422":"94a8aa71-8622-4134-a064-159208f8ca3c","429":"c4be29e4-d1c7-4d0b-887a-db94c8dd1a35"},"method":"get","type":"path","servers":["6f411761-58f0-48de-b89b-5fb1bc643d98"],"security":["b2f82274-0a2a-4019-bb46-0d2410d39118"],"path":"/api/companies/{id}","baseUrlOptions":["https://app.jolts.xyz"],"title":"Get company","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","ruby","php","go","java"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"52e4015b-7dea-413f-a33d-89f9f2f08bc5":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"","typeLabel":"string"}},"87b010b0-ef11-4f91-8916-8544809e1736":{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"","typeLabel":"integer"}}},"responses":{"1e1f89f3-ea66-44fa-b383-ee46f81c0b33":{"description":"Current supported company details.","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"company.id","typeLabel":"integer"},"name":{"type":"string","isRequired":true,"uniqueKey":"company.name","typeLabel":"string"},"domains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"company.domains.items.[INDEX].id","typeLabel":"integer"},"hostname":{"type":"string","isRequired":true,"uniqueKey":"company.domains.items.[INDEX].hostname","typeLabel":"string"}},"required":["id","hostname"],"additionalProperties":false,"uniqueKey":"company.domains.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"company.domains","typeLabel":"object[]"},"observations":{"type":"array","items":{"type":"object","description":"One activity and its supporting sources. The example is fictional, not a live company result.","examples":[{"id":456,"kind":"facility_expansion","observed_fact":"Example Logistics announced a new distribution warehouse.","why_it_may_matter":"A new warehouse may need handling equipment; no purchasing decision is confirmed.","demand_class":"proxy","country":"CA","confidence":0.8,"occurred_at":"2026-09-20T00:00:00Z","observed_at":"2026-09-21T12:00:00Z","expires_at":null,"evidence":[{"source_uri":"https://logistics.example/news/warehouse","excerpt":"We are opening a new distribution warehouse.","occurred_at":"2026-09-20T00:00:00Z","observed_at":"2026-09-21T12:00:00Z"}]}],"properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].id","typeLabel":"integer"},"kind":{"type":"string","enum":["procurement_request","facility_expansion","funding_round","leadership_change","product_launch","partnership","technology_use","job_posting","company_profile"],"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"observed_fact":{"type":"string","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].observed_fact","typeLabel":"string"},"why_it_may_matter":{"type":"string","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].why_it_may_matter","typeLabel":"string"},"demand_class":{"type":"string","enum":["explicit_request","proxy","structural"],"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].demand_class","typeLabel":"enum\u003cstring>"},"country":{"type":"string","enum":["CA","US"],"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].country","typeLabel":"enum\u003cstring>"},"confidence":{"type":"number","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].confidence","typeLabel":"number"},"occurred_at":{"oneOf":[{"type":"string","format":"date-time","description":"Event time; may be null only for company_profile. Structural fit is not evidence of current buying intent.","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].occurred_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Event time; may be null only for company_profile. Structural fit is not evidence of current buying intent.","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].occurred_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].occurred_at","typeLabel":"string\u003cdate-time> | null"},"observed_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].observed_at","typeLabel":"string\u003cdate-time>"},"expires_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].expires_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].expires_at","typeLabel":"string\u003cdate-time> | null"},"evidence":{"type":"array","items":{"type":"object","properties":{"source_uri":{"type":"string","description":"Source reference supplied with the evidence. For company profiles this may be a company homepage, not the origin of each profile field or an independently verified citation.","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].evidence.items.[INDEX].source_uri","typeLabel":"string"},"excerpt":{"type":"string","description":"Retained supporting text. For company profiles this is a provider-reported description, not necessarily a quotation from source_uri.","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].evidence.items.[INDEX].excerpt","typeLabel":"string"},"occurred_at":{"oneOf":[{"type":"string","format":"date-time","description":"Source event time, or null for a structural company profile with no reported event date.","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].evidence.items.[INDEX].occurred_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Source event time, or null for a structural company profile with no reported event date.","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].evidence.items.[INDEX].occurred_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].evidence.items.[INDEX].occurred_at","typeLabel":"string\u003cdate-time> | null"},"observed_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"company.observations.items.[INDEX].evidence.items.[INDEX].observed_at","typeLabel":"string\u003cdate-time>"},"last_seen_at":{"type":"string","format":"date-time","description":"Latest retrieval of this unchanged source record; not a new event or independent verification.","uniqueKey":"company.observations.items.[INDEX].evidence.items.[INDEX].last_seen_at","typeLabel":"string\u003cdate-time>"}},"required":["source_uri","excerpt","occurred_at","observed_at"],"additionalProperties":false,"uniqueKey":"company.observations.items.[INDEX].evidence.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"company.observations.items.[INDEX].evidence","typeLabel":"object[]"},"categories":{"type":"array","maxItems":100,"description":"Source-reported NAICS 2022 sector codes; industry classification, not products or buying intent.","items":{"type":"string","enum":["11","21","22","23","31-33","42","44-45","48-49","51","52","53","54","55","56","61","62","71","72","81","92"],"uniqueKey":"company.observations.items.[INDEX].categories.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"company.observations.items.[INDEX].categories","typeLabel":"enum\u003cstring>[]"}},"required":["id","kind","observed_fact","why_it_may_matter","demand_class","country","confidence","occurred_at","observed_at","expires_at","evidence"],"additionalProperties":false,"uniqueKey":"company.observations.items.[INDEX]","typeLabel":"object"},"maxItems":3,"isRequired":true,"uniqueKey":"company.observations","typeLabel":"object[]"},"limitations":{"type":"array","items":{"type":"string","uniqueKey":"company.limitations.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"company.limitations","typeLabel":"string[]"}},"required":["id","name","domains","observations","limitations"],"additionalProperties":false,"isRequired":true,"uniqueKey":"company","typeLabel":"object"}},"required":["company"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"result":{"title":"result","value":{"company":{"id":23,"name":"Sequoia Freight","domains":[{"id":23,"hostname":"sequoia.example.test"}],"observations":[{"id":23,"kind":"procurement_request","observed_fact":"Issued a request for fleet charging equipment at a new depot.","why_it_may_matter":"This observed company activity may be relevant to the search objective; verify fit against the evidence.","demand_class":"explicit_request","country":"US","confidence":1,"occurred_at":"2026-09-18T00:00:00Z","observed_at":"2026-09-25T02:47:06Z","expires_at":null,"evidence":[{"source_uri":"https://sequoia.example.test/tenders/fleet-charging","excerpt":"Issued a request for fleet charging equipment at a new depot.","occurred_at":"2026-09-18T00:00:00Z","observed_at":"2026-09-25T02:47:06Z"}]}],"limitations":["limited_source_coverage"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"029dee2e-a3ce-4720-a093-6fccb9e1627f":{"description":"The same operation is already processing; poll its usage.","content":{"application/json":{"schema":{"type":"object","examples":[{"usage":{"id":789,"status":"pending","request_key":"first-company-search","request_units":0,"delivered_units":0,"fresh_evidence_units":0},"request_allowance":{"window_seconds":18000,"window_remaining":99,"weekly_remaining":499}}],"properties":{"usage":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"usage.id","typeLabel":"integer"},"status":{"type":"string","enum":["pending","processing","delivered","failed"],"isRequired":true,"uniqueKey":"usage.status","typeLabel":"enum\u003cstring>"},"request_key":{"type":"string","isRequired":true,"uniqueKey":"usage.request_key","typeLabel":"string"},"request_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.request_units","typeLabel":"integer"},"delivered_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.delivered_units","typeLabel":"integer"},"fresh_evidence_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.fresh_evidence_units","typeLabel":"integer"}},"required":["id","status","request_key","request_units","delivered_units","fresh_evidence_units"],"additionalProperties":false,"isRequired":true,"uniqueKey":"usage","typeLabel":"object"},"request_allowance":{"type":"object","properties":{"window_seconds":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_seconds","typeLabel":"integer"},"window_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_remaining","typeLabel":"integer"},"weekly_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.weekly_remaining","typeLabel":"integer"}},"required":["window_seconds","window_remaining","weekly_remaining"],"additionalProperties":false,"isRequired":true,"uniqueKey":"request_allowance","typeLabel":"object"}},"required":["usage","request_allowance"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"pending":{"title":"pending","value":{"usage":{"id":981239949,"status":"pending","request_key":"company","request_units":0,"delivered_units":0,"fresh_evidence_units":0},"request_allowance":{"window_seconds":10800,"window_remaining":198,"weekly_remaining":998}}}},"exampleType":"examples"}},"exampleType":"examples"},"b7c91365-4082-496a-ae38-e0c1aff3039e":{"description":"Missing or revoked API credential.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_at":{"type":"string","format":"date-time","description":"Advisory retry time for the reached capacity limit, based on usage at rejection. Other requests or completing reservations may change availability.","uniqueKey":"error.retry_at","typeLabel":"string\u003cdate-time>"},"retry_after_seconds":{"type":"integer","minimum":0,"description":"Seconds from rejection to retry_at. For stored failed operations, prefer the absolute retry_at timestamp.","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"usage":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"usage.id","typeLabel":"integer"},"status":{"type":"string","enum":["pending","processing","delivered","failed"],"isRequired":true,"uniqueKey":"usage.status","typeLabel":"enum\u003cstring>"},"request_key":{"type":"string","isRequired":true,"uniqueKey":"usage.request_key","typeLabel":"string"},"request_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.request_units","typeLabel":"integer"},"delivered_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.delivered_units","typeLabel":"integer"},"fresh_evidence_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.fresh_evidence_units","typeLabel":"integer"}},"required":["id","status","request_key","request_units","delivered_units","fresh_evidence_units"],"additionalProperties":false,"uniqueKey":"usage","typeLabel":"object"},"request_allowance":{"type":"object","properties":{"window_seconds":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_seconds","typeLabel":"integer"},"window_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_remaining","typeLabel":"integer"},"weekly_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.weekly_remaining","typeLabel":"integer"}},"required":["window_seconds","window_remaining","weekly_remaining"],"additionalProperties":false,"uniqueKey":"request_allowance","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":{"code":"invalid_api_key","message":"Provide a valid API credential."}}}},"exampleType":"examples"}},"exampleType":"examples"},"42a04d10-61bc-4bf9-a376-fbe9945862d1":{"description":"An active or trialing subscription is required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_at":{"type":"string","format":"date-time","description":"Advisory retry time for the reached capacity limit, based on usage at rejection. Other requests or completing reservations may change availability.","uniqueKey":"error.retry_at","typeLabel":"string\u003cdate-time>"},"retry_after_seconds":{"type":"integer","minimum":0,"description":"Seconds from rejection to retry_at. For stored failed operations, prefer the absolute retry_at timestamp.","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"usage":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"usage.id","typeLabel":"integer"},"status":{"type":"string","enum":["pending","processing","delivered","failed"],"isRequired":true,"uniqueKey":"usage.status","typeLabel":"enum\u003cstring>"},"request_key":{"type":"string","isRequired":true,"uniqueKey":"usage.request_key","typeLabel":"string"},"request_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.request_units","typeLabel":"integer"},"delivered_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.delivered_units","typeLabel":"integer"},"fresh_evidence_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.fresh_evidence_units","typeLabel":"integer"}},"required":["id","status","request_key","request_units","delivered_units","fresh_evidence_units"],"additionalProperties":false,"uniqueKey":"usage","typeLabel":"object"},"request_allowance":{"type":"object","properties":{"window_seconds":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_seconds","typeLabel":"integer"},"window_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_remaining","typeLabel":"integer"},"weekly_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.weekly_remaining","typeLabel":"integer"}},"required":["window_seconds","window_remaining","weekly_remaining"],"additionalProperties":false,"uniqueKey":"request_allowance","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":{"code":"subscription_required","message":"An active or trialing subscription is required."}}}},"exampleType":"examples"}},"exampleType":"examples"},"e7663d5f-6756-468a-a695-0c69442b47f9":{"description":"Unknown company or no currently deliverable evidence.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_at":{"type":"string","format":"date-time","description":"Advisory retry time for the reached capacity limit, based on usage at rejection. Other requests or completing reservations may change availability.","uniqueKey":"error.retry_at","typeLabel":"string\u003cdate-time>"},"retry_after_seconds":{"type":"integer","minimum":0,"description":"Seconds from rejection to retry_at. For stored failed operations, prefer the absolute retry_at timestamp.","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"usage":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"usage.id","typeLabel":"integer"},"status":{"type":"string","enum":["pending","processing","delivered","failed"],"isRequired":true,"uniqueKey":"usage.status","typeLabel":"enum\u003cstring>"},"request_key":{"type":"string","isRequired":true,"uniqueKey":"usage.request_key","typeLabel":"string"},"request_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.request_units","typeLabel":"integer"},"delivered_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.delivered_units","typeLabel":"integer"},"fresh_evidence_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.fresh_evidence_units","typeLabel":"integer"}},"required":["id","status","request_key","request_units","delivered_units","fresh_evidence_units"],"additionalProperties":false,"uniqueKey":"usage","typeLabel":"object"},"request_allowance":{"type":"object","properties":{"window_seconds":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_seconds","typeLabel":"integer"},"window_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_remaining","typeLabel":"integer"},"weekly_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.weekly_remaining","typeLabel":"integer"}},"required":["window_seconds","window_remaining","weekly_remaining"],"additionalProperties":false,"uniqueKey":"request_allowance","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":{"code":"company_not_found","message":"No deliverable company has that ID."}}}},"exampleType":"examples"}},"exampleType":"examples"},"94a8aa71-8622-4134-a064-159208f8ca3c":{"description":"Invalid identifier, missing request key, or conflicting retry.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_at":{"type":"string","format":"date-time","description":"Advisory retry time for the reached capacity limit, based on usage at rejection. Other requests or completing reservations may change availability.","uniqueKey":"error.retry_at","typeLabel":"string\u003cdate-time>"},"retry_after_seconds":{"type":"integer","minimum":0,"description":"Seconds from rejection to retry_at. For stored failed operations, prefer the absolute retry_at timestamp.","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"usage":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"usage.id","typeLabel":"integer"},"status":{"type":"string","enum":["pending","processing","delivered","failed"],"isRequired":true,"uniqueKey":"usage.status","typeLabel":"enum\u003cstring>"},"request_key":{"type":"string","isRequired":true,"uniqueKey":"usage.request_key","typeLabel":"string"},"request_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.request_units","typeLabel":"integer"},"delivered_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.delivered_units","typeLabel":"integer"},"fresh_evidence_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.fresh_evidence_units","typeLabel":"integer"}},"required":["id","status","request_key","request_units","delivered_units","fresh_evidence_units"],"additionalProperties":false,"uniqueKey":"usage","typeLabel":"object"},"request_allowance":{"type":"object","properties":{"window_seconds":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_seconds","typeLabel":"integer"},"window_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_remaining","typeLabel":"integer"},"weekly_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.weekly_remaining","typeLabel":"integer"}},"required":["window_seconds","window_remaining","weekly_remaining"],"additionalProperties":false,"uniqueKey":"request_allowance","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":{"code":"invalid_search","message":"background must be a boolean"}}}},"exampleType":"examples"}},"exampleType":"examples"},"c4be29e4-d1c7-4d0b-887a-db94c8dd1a35":{"description":"Subscription request or delivery capacity reached.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_at":{"type":"string","format":"date-time","description":"Advisory retry time for the reached capacity limit, based on usage at rejection. Other requests or completing reservations may change availability.","uniqueKey":"error.retry_at","typeLabel":"string\u003cdate-time>"},"retry_after_seconds":{"type":"integer","minimum":0,"description":"Seconds from rejection to retry_at. For stored failed operations, prefer the absolute retry_at timestamp.","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"usage":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"usage.id","typeLabel":"integer"},"status":{"type":"string","enum":["pending","processing","delivered","failed"],"isRequired":true,"uniqueKey":"usage.status","typeLabel":"enum\u003cstring>"},"request_key":{"type":"string","isRequired":true,"uniqueKey":"usage.request_key","typeLabel":"string"},"request_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.request_units","typeLabel":"integer"},"delivered_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.delivered_units","typeLabel":"integer"},"fresh_evidence_units":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"usage.fresh_evidence_units","typeLabel":"integer"}},"required":["id","status","request_key","request_units","delivered_units","fresh_evidence_units"],"additionalProperties":false,"uniqueKey":"usage","typeLabel":"object"},"request_allowance":{"type":"object","properties":{"window_seconds":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_seconds","typeLabel":"integer"},"window_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.window_remaining","typeLabel":"integer"},"weekly_remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"request_allowance.weekly_remaining","typeLabel":"integer"}},"required":["window_seconds","window_remaining","weekly_remaining"],"additionalProperties":false,"uniqueKey":"request_allowance","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":{"code":"request_limit_reached","message":"The subscription request limit has been reached.","retry_at":"2026-09-25T05:00:00Z","retry_after_seconds":60}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"b2f82274-0a2a-4019-bb46-0d2410d39118":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"6f411761-58f0-48de-b89b-5fb1bc643d98":{"url":"https://app.jolts.xyz","description":"Application API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"jolts","siteName":"Jolts","title":"Get company - Jolts","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-28T16:38:21.956Z","originalFileLocation":"api-reference/companies/get-company.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries. Examples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Jolts\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/jolts/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/jolts/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/jolts/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/jolts/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get company - Jolts\">\u003cmeta data-mint-head property=\"og:description\" content=\"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries. Examples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Jolts\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://dev.jolts.xyz/api-reference/companies/get-company\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://jolts.mintlify.app/_mintlify/api/og/v2?division=Companies\u0026amp;title=Get+company\u0026amp;description=Metered+known-company+lookup+using+the+same+operation+as+GET+%2Fapi%2Fcompanies+and+MCP+get_companies.+Requires+Idempotency-Key%3B+identical+retries+share+settlement+\u0026amp;theme=a2fd6fb06340dfbc7e091304\u0026amp;signature=778d96981cd82d7877968d2bf77eb21c99876c60dbfc3374c5f85d6702bc0ae9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get company - Jolts\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries. Examples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://jolts.mintlify.app/_mintlify/api/og/v2?division=Companies\u0026amp;title=Get+company\u0026amp;description=Metered+known-company+lookup+using+the+same+operation+as+GET+%2Fapi%2Fcompanies+and+MCP+get_companies.+Requires+Idempotency-Key%3B+identical+retries+share+settlement+\u0026amp;theme=a2fd6fb06340dfbc7e091304\u0026amp;signature=778d96981cd82d7877968d2bf77eb21c99876c60dbfc3374c5f85d6702bc0ae9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/jolts/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Jolts\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#60B5FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://dev.jolts.xyz/api-reference/companies/get-company\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/companies/get-company.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://dev.jolts.xyz/#organization\",\"name\":\"Jolts\",\"url\":\"https://dev.jolts.xyz\"},{\"@type\":\"WebSite\",\"@id\":\"https://dev.jolts.xyz#website\",\"name\":\"Jolts\",\"url\":\"https://dev.jolts.xyz\",\"publisher\":{\"@id\":\"https://dev.jolts.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://dev.jolts.xyz/api-reference/companies/get-company#webpage\",\"url\":\"https://dev.jolts.xyz/api-reference/companies/get-company\",\"name\":\"Get company\",\"description\":\"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries. Examples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.\",\"dateModified\":\"2026-09-28T16:38:21.956Z\",\"isPartOf\":{\"@id\":\"https://dev.jolts.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://dev.jolts.xyz/api-reference/companies/get-company#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://dev.jolts.xyz/api-reference/companies/get-company#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Companies\",\"item\":\"https://dev.jolts.xyz/api-reference/companies/search-companies\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get company\",\"item\":\"https://dev.jolts.xyz/api-reference/companies/get-company\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://dev.jolts.xyz/api-reference/companies/get-company#apireference\",\"headline\":\"Get company\",\"name\":\"Get company\",\"description\":\"Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries. Examples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.\",\"url\":\"https://dev.jolts.xyz/api-reference/companies/get-company\",\"mainEntityOfPage\":{\"@id\":\"https://dev.jolts.xyz/api-reference/companies/get-company#webpage\"},\"dateModified\":\"2026-09-28T16:38:21.956Z\",\"publisher\":{\"@id\":\"https://dev.jolts.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://dev.jolts.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Jolts\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Jolts","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Companies","pages":[{"title":"Search companies","description":"Build a prospect shortlist from company activity relevant to what you sell. Describe the need in query; use filters for exact constraints and exclude_domains to leave out existing customers. Natural-language planning does not broaden the supported evidence kinds or countries.\n\nEach company includes up to three observations with sources, timestamps, and an explanation of why the activity may matter. Ranking is not a buying probability. Coverage is partial, and an empty list does not prove no matching company exists.\n\nSet background to true to receive an operation ID, then poll `GET /api/usages/{id}`. Reuse the same Idempotency-Key only for identical retries. For the next page, keep query, filters and limit unchanged, pass next_cursor as cursor, and use a new key.\n\nSee [the quickstart](/quickstart), [filtering and pagination](/workflows), or [MCP tools](/mcp-tools).\n\nExamples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/companies/search","href":"/api-reference/companies/search-companies"},{"title":"Get company","deprecated":null,"version":null,"openapi":"/openapi.json get /api/companies/{id}","href":"/api-reference/companies/get-company"},{"title":"Get observations","description":"List observations recorded after `since` for up to 100 company domains, oldest first, with an opaque cursor for further pages. Reads the existing dataset only; no provider or AI calls run in the request. Domains without coverage are reported as not_found and queued for a scheduled refresh where a permitted source exists. Completed requests consume one request unit and one delivered unit per distinct company; identical retries do not settle again. Current evidence eligibility is rechecked on every read.\n\nExamples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/observations","href":"/api-reference/companies/get-observations"},{"title":"Get companies","deprecated":null,"version":null,"openapi":"/openapi.json get /api/companies","href":"/api-reference/companies/get-companies"}]},{"group":"Observations","pages":[{"title":"Search observations","deprecated":true,"version":null,"openapi":"/openapi.json post /api/observations/search","href":"/api-reference/observations/search-observations"},{"title":"Get observation","deprecated":true,"version":null,"openapi":"/openapi.json get /api/observations/{id}","href":"/api-reference/observations/get-observation"}]},{"group":"Operations","pages":[{"title":"Start observation search","deprecated":true,"version":null,"openapi":"/openapi.json post /api/usages","href":"/api-reference/operations/start-observation-search"},{"title":"Get operation","deprecated":null,"version":null,"openapi":"/openapi.json get /api/usages/{id}","href":"/api-reference/operations/get-operation"}]},{"group":"Account","pages":[{"title":"Get subscription usage","deprecated":null,"version":null,"openapi":"/openapi.json get /api/usage","href":"/api-reference/account/get-subscription-usage"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp-overview"}]}]},"title":"Get company - Jolts","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}