{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sacra","colors":{"primary":"#E8B84B","light":"#F0D078","dark":"#1B1B2F"},"logo":{"light":"https://mintcdn.com/sacra/4AD2bHxkd6mr-FOG/logo/logo_mark.87413ae1.svg?fit=max\u0026auto=format\u0026n=4AD2bHxkd6mr-FOG\u0026q=85\u0026s=9d6c71baa318948e123b6b2c12f8619f","dark":"https://mintcdn.com/sacra/4AD2bHxkd6mr-FOG/logo/logo_mark.87413ae1.svg?fit=max\u0026auto=format\u0026n=4AD2bHxkd6mr-FOG\u0026q=85\u0026s=9d6c71baa318948e123b6b2c12f8619f"},"favicon":"https://mintcdn.com/sacra/tovvBdzsm41UFEcj/favicon.ico?fit=max\u0026auto=format\u0026n=tovvBdzsm41UFEcj\u0026q=85\u0026s=eec26b72496ebb0c88aca6f21c21d763","api":{},"navbar":{"links":[{"href":"https://support.sacra.com/","label":"Support"}],"primary":{"type":"button","label":"Sign In","href":"https://sacra.com/login"}},"contextual":{"options":["copy","view","chatgpt","claude","grok","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Sacra","icon":"house","href":"https://sacra.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sacra","hasAudioNarration":false,"actualSubdomain":"sacra","customDomains":["docs.sacra.com"],"gitSource":{"type":"github","owner":"sacrainc","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aa2b09e2c5cf88b50b91891","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API reference","count":24},{"language":"default","tag":"Overview","count":12},{"language":"default","tag":"Changelog","count":8},{"language":"default","tag":"MCP","count":8},{"language":"default","tag":"Embeds","count":5},{"language":"default","tag":"Core concepts","count":5},{"language":"default","tag":"Guides","count":4},{"language":"default","tag":"Companies","count":3},{"language":"default","tag":"Documents","count":3},{"language":"default","tag":"Getting started","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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/categories/list-categories","slug":"/api-reference/categories/list-categories","pageMetadata":{"title":"List categories - Categories API","sidebarTitle":"List categories","openapi":"openapi.json GET /api/v1/categories/","description":"Returns categories for a given company, or a single category by slug.\n\n**Lookup modes:**\n- By `slug` — returns the single matching category\n- By `company_domain` or `company_id` — returns all categories for that company\n\nAt least one of `company_domain`, `company_id`, or `slug` is required.","href":"/api-reference/categories/list-categories"},"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 code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Returns categories for a given company, or a single category by slug.\"\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Lookup modes:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"By \", _jsx(_components.code, {\n children: \"slug\"\n }), \" — returns the single matching category\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"By \", _jsx(_components.code, {\n children: \"company_domain\"\n }), \" or \", _jsx(_components.code, {\n children: \"company_id\"\n }), \" — returns all categories for that company\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"At least one of \", _jsx(_components.code, {\n children: \"company_domain\"\n }), \", \", _jsx(_components.code, {\n children: \"company_id\"\n }), \", or \", _jsx(_components.code, {\n children: \"slug\"\n }), \" is required.\"]\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":"List categories - Categories API","sidebarTitle":"List categories","openapi":"openapi.json GET /api/v1/categories/","description":"Returns categories for a given company, or a single category by slug.\n\n**Lookup modes:**\n- By `slug` — returns the single matching category\n- By `company_domain` or `company_id` — returns all categories for that company\n\nAt least one of `company_domain`, `company_id`, or `slug` is required.","href":"/api-reference/categories/list-categories"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/sacra/78c72444da8ac86d/page-header-titles.js"],"openApiReferenceData":{"operation":{"operationId":"categories_retrieve","description":"Returns categories for a given company, or a single category by slug.\n\n**Lookup modes:**\n- By `slug` — returns the single matching category\n- By `company_domain` or `company_id` — returns all categories for that company\n\nAt least one of `company_domain`, `company_id`, or `slug` is required.","summary":"List categories","parameters":["8c9786c8-94e7-4308-9f3e-0755f41661af","f09a1511-b46c-4ca5-be15-98e93233dcf9","33781603-37e3-4672-9c87-e239efe58201"],"tags":["Categories"],"security":["72311203-a6f6-4195-aa82-d677ba3c0022"],"responses":{"200":"78fcdb88-c218-4cb9-acd0-6a0ca2512078","400":"142a8fe8-0c93-4d8c-b55e-18b1854d0824","404":"eed8e1e9-e8d5-4ac0-b723-14b4a2fa2484"},"method":"get","type":"path","servers":["f8864f90-66ba-412c-a6ef-99a1cd3b2030"],"path":"/api/v1/categories/","baseUrlOptions":["https://sacra.com"],"title":"List categories","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"8c9786c8-94e7-4308-9f3e-0755f41661af":{"in":"query","name":"company_domain","schema":{"type":"string","description":"Fully qualified company domain (e.g. `figma.com`). Required if `company_id` and `slug` are not given.","uniqueKey":"","typeLabel":"string"},"description":"Fully qualified company domain (e.g. `figma.com`). Required if `company_id` and `slug` are not given."},"f09a1511-b46c-4ca5-be15-98e93233dcf9":{"in":"query","name":"company_id","schema":{"type":"string","description":"Company ID (e.g. `101`). Required if `company_domain` and `slug` are not given.","uniqueKey":"","typeLabel":"string"},"description":"Company ID (e.g. `101`). Required if `company_domain` and `slug` are not given."},"33781603-37e3-4672-9c87-e239efe58201":{"in":"query","name":"slug","schema":{"type":"string","description":"Category slug to look up directly (e.g. `design`).","uniqueKey":"","typeLabel":"string"},"description":"Category slug to look up directly (e.g. `design`)."}},"responses":{"78fcdb88-c218-4cb9-acd0-6a0ca2512078":{"content":{"application/json":{"schema":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"categories.items.[INDEX].id","typeLabel":"integer"},"name":{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].name","typeLabel":"string"},"slug":{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].slug","typeLabel":"string"}},"required":["id","name","slug"],"uniqueKey":"categories.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"categories","typeLabel":"object[]"}},"required":["categories"],"uniqueKey":"","typeLabel":"object"},"examples":{"ByCompanyDomain":{"title":"ByCompanyDomain","value":{"categories":[{"id":31,"name":"design","slug":"design"},{"id":13,"name":"b2b","slug":"b2b"},{"id":32,"name":"online whiteboard","slug":"online-whiteboard"}]}},"BySlug":{"title":"BySlug","value":{"categories":[{"id":31,"name":"design","slug":"design"}]}}},"exampleType":"examples"}},"description":"","exampleType":"examples"},"142a8fe8-0c93-4d8c-b55e-18b1854d0824":{"content":{"text/plain":{"schema":{"type":"string","example":"Ensure company_domain is a valid URL.","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"Ensure company_domain is a valid URL."}},"exampleType":"generated"}},"description":"Missing required parameter or invalid domain.","exampleType":"generated"},"eed8e1e9-e8d5-4ac0-b723-14b4a2fa2484":{"content":{"text/plain":{"schema":{"type":"string","example":"Categories for requested company not found.","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"Categories for requested company not found."}},"exampleType":"generated"}},"description":"Category or company not found.","exampleType":"generated"}},"security":{"72311203-a6f6-4195-aa82-d677ba3c0022":{"SacraAPIAuthentication":{"type":"apiKey","in":"header","name":"Authorization","description":"Authenticate using one of two formats:\n\n- **Organization/user token:** `Token \u003cyour-token>`\n- **Stytch JWT:** `Bearer \u003cyour-jwt>`","scopes":[]}}},"servers":{"f8864f90-66ba-412c-a6ef-99a1cd3b2030":{"url":"https://sacra.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Authenticate using one of two formats:\n\n- **Organization/user token:** `Token \u003cyour-token>`\n- **Stytch JWT:** `Bearer \u003cyour-jwt>`","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Authenticate using one of two formats:\n\n- **Organization/user token:** `Token \u003cyour-token>`\n- **Stytch JWT:** `Bearer \u003cyour-jwt>`","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"SacraAPIAuthentication","name":"Authorization"}],"title":"SacraAPIAuthentication"}]},"originalFileLocation":"openapi.json"},"subdomain":"sacra","siteName":"Sacra","title":"List categories - Categories API - Sacra","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-12T18:23:18.002Z","originalFileLocation":"api-reference/categories/list-categories.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=\"system\"}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=\"Returns categories for a given company, or a single category by slug. Lookup modes: - By slug — returns the single matching category - By company_domain or company_id — returns all categories for that company At least one of company_domain, company_id, or slug is required.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sacra\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List categories - Categories API - Sacra\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns categories for a given company, or a single category by slug. Lookup modes: - By slug — returns the single matching category - By company_domain or company_id — returns all categories for that company At least one of company_domain, company_id, or slug is required.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sacra\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sacra.com/api-reference/categories/list-categories\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sacra.mintlify.site/_mintlify/api/og/v2?division=Categories\u0026amp;title=List+categories+-+Categories+API\u0026amp;description=Returns+categories+for+a+given+company%2C+or+a+single+category+by+slug.%0A%0A**Lookup+modes%3A**%0A-+By+%60slug%60+%E2%80%94+returns+the+single+matching+category%0A-+By+%60company_domain\u0026amp;theme=c0d6235411568b915c67f7f8\u0026amp;signature=3f79e536123b35d149e9abc7e81f634e40352140f0a8b3693b0b649769050e22\">\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=\"List categories - Categories API - Sacra\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns categories for a given company, or a single category by slug. Lookup modes: - By slug — returns the single matching category - By company_domain or company_id — returns all categories for that company At least one of company_domain, company_id, or slug is required.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sacra.mintlify.site/_mintlify/api/og/v2?division=Categories\u0026amp;title=List+categories+-+Categories+API\u0026amp;description=Returns+categories+for+a+given+company%2C+or+a+single+category+by+slug.%0A%0A**Lookup+modes%3A**%0A-+By+%60slug%60+%E2%80%94+returns+the+single+matching+category%0A-+By+%60company_domain\u0026amp;theme=c0d6235411568b915c67f7f8\u0026amp;signature=3f79e536123b35d149e9abc7e81f634e40352140f0a8b3693b0b649769050e22\">\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=\"/mintlify-assets/_mintlify/favicons/sacra/MzjuI4apH9dtLt6d/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sacra\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E8B84B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sacra.com/api-reference/categories/list-categories\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/categories/list-categories.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sacra.com/#organization\",\"name\":\"Sacra\",\"url\":\"https://docs.sacra.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sacra/4AD2bHxkd6mr-FOG/logo/logo_mark.87413ae1.svg?fit=max\u0026auto=format\u0026n=4AD2bHxkd6mr-FOG\u0026q=85\u0026s=9d6c71baa318948e123b6b2c12f8619f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sacra.com#website\",\"name\":\"Sacra\",\"url\":\"https://docs.sacra.com\",\"publisher\":{\"@id\":\"https://docs.sacra.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sacra.com/api-reference/categories/list-categories#webpage\",\"url\":\"https://docs.sacra.com/api-reference/categories/list-categories\",\"name\":\"List categories - Categories API\",\"description\":\"Returns categories for a given company, or a single category by slug. Lookup modes: - By slug — returns the single matching category - By company_domain or company_id — returns all categories for that company At least one of company_domain, company_id, or slug is required.\",\"dateModified\":\"2026-08-12T18:23:18.002Z\",\"isPartOf\":{\"@id\":\"https://docs.sacra.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sacra.com/api-reference/categories/list-categories#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sacra.com/api-reference/categories/list-categories#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sacra\",\"item\":\"https://docs.sacra.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List categories - Categories API\",\"item\":\"https://docs.sacra.com/api-reference/categories/list-categories\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sacra.com/api-reference/categories/list-categories#apireference\",\"headline\":\"List categories - Categories API\",\"name\":\"List categories - Categories API\",\"description\":\"Returns categories for a given company, or a single category by slug. Lookup modes: - By slug — returns the single matching category - By company_domain or company_id — returns all categories for that company At least one of company_domain, company_id, or slug is required.\",\"url\":\"https://docs.sacra.com/api-reference/categories/list-categories\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sacra.com/api-reference/categories/list-categories#webpage\"},\"dateModified\":\"2026-08-12T18:23:18.002Z\",\"publisher\":{\"@id\":\"https://docs.sacra.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sacra.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sacra\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sacra","nav":{"global":{"anchors":[{"anchor":"Sacra","icon":"house","href":"https://sacra.com"}]},"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"API reference","groups":[{"group":"API reference","icon":"book","pages":[{"title":"Introduction - API reference","sidebarTitle":"Introduction","href":"/api-reference/introduction"}]},{"group":"Companies","icon":"building","pages":[{"title":"List companies - Companies API","sidebarTitle":"List companies","openapi":"openapi.json GET /api/v1/companies/","href":"/api-reference/companies/list-companies"},{"title":"Get company detail - Companies API","sidebarTitle":"Get company detail","openapi":"openapi.json GET /api/v1/companies/{company_slug}/","href":"/api-reference/companies/get-a-company-detail"},{"title":"Rank companies - Companies API","sidebarTitle":"Rank companies","openapi":"openapi.json GET /api/v1/companies/rankings/","href":"/api-reference/companies/rank-companies"}]},{"group":"Documents","icon":"file-text","pages":[{"title":"List documents - Documents API","sidebarTitle":"List documents","openapi":"openapi.json GET /api/v1/documents/","href":"/api-reference/documents/list-documents"},{"title":"Get document detail - Documents API","sidebarTitle":"Get document detail","openapi":"openapi.json GET /api/v1/documents/{document_slug}/","href":"/api-reference/documents/get-a-document"},{"title":"Search documents and content - Documents API","sidebarTitle":"Search documents and content","openapi":"openapi.json POST /api/v1/search/","href":"/api-reference/documents/search"}]},{"group":"Events","icon":"calendar","pages":[{"title":"Get aggregated events - Events API","sidebarTitle":"Get aggregated events","openapi":"openapi.json GET /api/v1/events/","href":"/api-reference/events/get-aggregated-events"},{"title":"Get aggregated events (batch) - Events API","sidebarTitle":"Get aggregated events (batch)","openapi":"openapi.json POST /api/v1/events/","href":"/api-reference/events/get-aggregated-events-batch"}]},{"group":"News","icon":"newspaper","pages":[{"title":"Get company news - News API","sidebarTitle":"Get company news","openapi":"openapi.json GET /api/v1/news/company/","href":"/api-reference/news/get-company-news"},{"title":"Get company news (batch) - News API","sidebarTitle":"Get company news (batch)","openapi":"openapi.json POST /api/v1/news/company/","href":"/api-reference/news/get-company-news-batch"}]},{"group":"Filings","icon":"archive","pages":[{"title":"Get company filings - Filings API","sidebarTitle":"Get company filings","openapi":"openapi.json GET /api/v1/filings/","href":"/api-reference/filings/get-company-filings"},{"title":"Get company filings (batch) - Filings API","sidebarTitle":"Get company filings (batch)","openapi":"openapi.json POST /api/v1/filings/","href":"/api-reference/filings/get-company-filings-post"}]},{"group":"Metrics","icon":"bar-chart","pages":[{"title":"Get metric observations - Metrics API","sidebarTitle":"Get metric observations","openapi":"openapi.json GET /api/v1/metrics/","href":"/api-reference/metrics/get-metric-observations"},{"title":"Get metric observations (batch) - Metrics API","sidebarTitle":"Get metric observations (batch)","openapi":"openapi.json POST /api/v1/metrics/","href":"/api-reference/metrics/get-metric-observations-batch"}]},{"group":"Embeds","icon":"code","pages":[{"title":"Get a company data summary embed - Embeds API","sidebarTitle":"Get a company data summary embed","openapi":"openapi.json GET /api/v1/embed/company-data-summary/","href":"/api-reference/embeds/get-a-company-data-summary-embed"},{"title":"Get a company valuation chart embed - Embeds API","sidebarTitle":"Get a company valuation chart embed","openapi":"openapi.json GET /api/v1/embed/company-data-valuation-chart/","href":"/api-reference/embeds/get-a-company-valuation-chart-embed"},{"title":"Get a company valuation table embed - Embeds API","sidebarTitle":"Get a company valuation table embed","openapi":"openapi.json GET /api/v1/embed/company-data-valuation-table/","href":"/api-reference/embeds/get-a-company-valuation-table-embed"},{"title":"Get a document PDF embed - Embeds API","sidebarTitle":"Get a document PDF embed","openapi":"openapi.json GET /api/v1/embed/document-pdfs/","href":"/api-reference/embeds/get-a-document-pdf-embed"},{"title":"Create or retrieve a chart embed - Embeds API","sidebarTitle":"Create or retrieve a chart embed","openapi":"openapi.json PUT /api/v1/embed/charts/","description":"Creates a new chart (or retrieves an existing one) from one or more datasets and returns embeddable HTML. If a chart with the same name, description, and creator already exists, returns the existing embed with a 200. Otherwise creates a new chart and returns 201.","href":"/api-reference/embeds/create-or-retrieve-a-chart-embed"}]},{"group":"Categories","icon":"tag","pages":[{"title":"List categories - Categories API","sidebarTitle":"List categories","openapi":"openapi.json GET /api/v1/categories/","href":"/api-reference/categories/list-categories"},{"title":"List items in a category - Categories API","sidebarTitle":"List items in a category","openapi":"openapi.json GET /api/v1/categories/{category_slug}/items/","description":"Returns companies and documents belonging to a category, sorted by publication date.\n\nResults are a unified list of **companies** and **documents**, each identified by a `type` field. Use `limit` and `offset` for pagination.\n\nThe `meta` object varies by item type. For companies it includes `domain` and `logo`. For documents it includes `preview_image` and `document_type`.","href":"/api-reference/categories/list-items-in-a-category"}]},{"group":"Funding (legacy)","icon":"coins","pages":[{"title":"Get funding rounds for a company - Funding API (legacy)","sidebarTitle":"Get funding rounds for a company","openapi":"openapi.json GET /api/v1/funding-rounds/","href":"/api-reference/funding-legacy/get-funding-rounds-for-a-company"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp-overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"List categories - Categories API - Sacra","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}