The Companies API enables you to perform the following:
Search by organisation ID: Returns the list of companies associated with the organisation.
Search by company ID: Returns details of the specific company.
Rate Limits
The API has a rate limit of 600 requests per minute.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pleo Docs","colors":{"primary":"#FEB6FE","light":"#FEB6FE","dark":"#131414"},"logo":{"light":"https://mintcdn.com/pleo-61d4d38b/0im2PqYmwpP-taWp/logo/pleo-developers-light.svg?fit=max\u0026auto=format\u0026n=0im2PqYmwpP-taWp\u0026q=85\u0026s=c000128fc6805d6e5d279ec0fdc06880","dark":"https://mintcdn.com/pleo-61d4d38b/0im2PqYmwpP-taWp/logo/pleo-developers-dark.svg?fit=max\u0026auto=format\u0026n=0im2PqYmwpP-taWp\u0026q=85\u0026s=4bb015d539b87030ea9e8b2f6e9bcacf"},"favicon":"https://mintcdn.com/pleo-61d4d38b/earhx-WV21nRUBYy/favicon.ico?fit=max\u0026auto=format\u0026n=earhx-WV21nRUBYy\u0026q=85\u0026s=d2072fecca8a5747cb9f15e5a0b405f8","background":{"color":{"light":"#fff","dark":"#212222"}},"navbar":{"links":[{"href":"https://status.pleo.io/","label":"Status"},{"href":"https://help.pleo.io/en/support/home","label":"Support"},{"href":"https://www.pleo.io/en/integrations","label":"Pre-Built"},{"href":"https://www.pleo.io/en/explore-product","label":"Products"},{"href":"https://blog.pleo.io/en","label":"Blog"}],"primary":{"type":"button","label":"Demo","href":"https://www.pleo.io/en/demo"}},"footer":{"socials":{"x":"https://www.twitter.com/pleo","youtube":"https://www.youtube.com/channel/UCQQitvQIlEgIxNyLlOgilXQ","linkedin":"https://www.linkedin.com/company/pleo-company"}},"fonts":{"heading":{"family":"Pleo Scandi Gellix Headline","weight":545,"source":"fonts/PleoScandiGellix-Headline.woff2","format":"woff2"},"body":{"family":"Pleo Scandi Gellix Text","weight":450,"source":"fonts/PleoScandiGellix-Text.woff2","format":"woff2"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pleo-61d4d38b","hasAudioNarration":false,"actualSubdomain":"pleo-61d4d38b","customDomains":["developers.pleo.io"],"gitSource":{"type":"github","owner":"pleo-io","repo":"external-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af7209ea071dcdd90fe653a","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"API Reference","count":199},{"language":"default","tag":"Build with Pleo","count":108},{"language":"default","tag":"AS/ERP","count":86},{"language":"default","tag":"How-to's","count":69},{"language":"default","tag":"Integration Design","count":59},{"language":"default","tag":"PLEO.IO API (DEPRECATED)","count":54},{"language":"default","tag":"Exports","count":52},{"language":"default","tag":"Expenses","count":46},{"language":"default","tag":"Imports","count":42},{"language":"default","tag":"Authentication and Authorisation","count":32}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"Pleo Scandi Gellix Headline\";src:url(\"/fonts/PleoScandiGellix-HeadlineItalic.woff2\") format(\"woff2\");font-weight:545;font-style:italic;font-display:swap}@font-face{font-family:\"Pleo Scandi Gellix Text\";src:url(\"/fonts/PleoScandiGellix-TextItalic.woff2\") format(\"woff2\");font-weight:450;font-style:italic;font-display:swap}html{font-synthesis:none}html:not(.dark) strong,html:not(.dark) b{color:#131414}#navbar .border-b{border-bottom-width:0!important}html:not(.dark) .eyebrow:not(:empty){display:inline-flex;align-items:center;background-color:#EEF4F4!important;color:#131414!important;padding:2px 10px;border-radius:9999px}header#navbar.is-center~* .eyebrow{display:none!important}html:not(.dark) #sidebar a[aria-current=\"page\"].bg-primary\\/10{background-color:#EEF4F4!important;color:#131414!important}html:not(.dark) #sidebar a:not([aria-current=\"page\"]){color:#6B7070!important}html:not(.dark) #table-of-contents li[data-active]>a{background-color:#FAFCFC!important;color:#131414!important;border-radius:0.5rem}html:not(.dark) [data-component-part=\"accordion-button\"]:hover{background-color:#EEF4F4!important}html.dark strong,html.dark b{color:#FAFCFC}html:not(.dark) .prose{color:#6B7070!important}html:not(.dark) [role=\"menuitemradio\"][aria-checked=\"true\"]{background-color:#FEB6FE!important;color:#131414!important}html:not(.dark) [role=\"menuitemradio\"][aria-checked=\"true\"] svg{color:#131414!important}html:not(.dark) [role=\"menuitemradio\"]:hover{background-color:#FAFCFC!important;color:#131414!important}html:not(.dark) [role=\"menuitemradio\"]:hover svg{color:#131414!important}html:not(.dark) a.nav-dropdown-item[aria-current=\"location\"]{background-color:#FEB6FE!important}html:not(.dark) a.nav-dropdown-item[aria-current=\"location\"] .nav-dropdown-item-title,html:not(.dark) a.nav-dropdown-item[aria-current=\"location\"] svg{color:#131414!important}html:not(.dark) a.nav-dropdown-item[aria-current=\"location\"] .nav-dropdown-item-icon svg{background-color:#131414!important}html:not(.dark) a.nav-dropdown-item:hover{background-color:#FAFCFC!important}html:not(.dark) a.nav-dropdown-item:hover .nav-dropdown-item-title,html:not(.dark) a.nav-dropdown-item:hover svg{color:#131414!important}html:not(.dark) a.nav-dropdown-item:hover .nav-dropdown-item-icon svg{background-color:#131414!important}html:not(.dark) .nav-dropdown-trigger .nav-dropdown-item-icon svg{background-color:#131414!important}html.dark .prose{color:#EEF4F4!important}html:not(.dark) li[data-active-nav-item=\"true\"]>a{background-color:#EEF4F4!important;color:#131414!important}html.dark li[data-active-nav-item=\"true\"]>a{background-color:#131414!important;color:#FEB6FE!important}html:not(.dark) [data-component-part=\"update-label\"]{background-color:#EEF4F4!important;color:#131414!important}[data-component-part=\"update-description\"]{color:#FEB6FE!important}.sidebar-group-header,.sidebar-group-header .sidebar-title{font-weight:450!important}html:not(.dark) .sidebar-group-header,html:not(.dark) .sidebar-group-header .sidebar-title{color:#131414!important}html.dark .sidebar-group-header,html.dark .sidebar-group-header .sidebar-title{color:#FAFCFC!important}h1,h2,h3,h4,h5,h6{font-weight:545!important}html:not(.dark) li:not([data-active-nav-item=\"true\"])>a:hover{background-color:#FAFCFC!important}html.dark li:not([data-active-nav-item=\"true\"])>a:hover{background-color:#212222!important}#navigation-items,#navigation-items *:not(.method-nav-pill *){font-size:15px!important}.prose:not(.prose-sm){font-size:17px!important}:root{--recommended-title: #131414;--recommended-bg: #FAFCFC;--callout-note-accent: #6B7070;--callout-note-border: #EEF4F4;--callout-note-shadow: rgb(238, 244, 244, 0.3);--callout-remember-accent: #FEB6FE;--callout-remember-shadow: rgb(254, 182, 254, 0.3);--callout-recommended-accent: #227F47;--callout-recommended-shadow: rgb(34, 127, 71, 0.3);--callout-explorative-accent: #407CD6;--callout-explorative-shadow: rgb(64, 124, 214, 0.3);--callout-warning-accent: #F0E556;--callout-warning-icon: #DBC713;--callout-warning-shadow: rgb(240, 229, 86, 0.75);--callout-danger-accent: #F15A71;--callout-danger-shadow: rgb(241, 90, 113, 0.75)}html.dark{--recommended-title: #FAFCFC;--recommended-bg: #252e34;--callout-note-accent: #EEF4F4;--callout-note-border: #EEF4F4;--callout-note-shadow: rgb(238, 244, 244, 0.3);--callout-remember-accent: #FEB6FE;--callout-remember-shadow: rgb(254, 182, 254, 0.3);--callout-recommended-accent: #21C663;--callout-recommended-shadow: rgb(33, 198, 99, 0.3);--callout-explorative-accent: #A8D9FF;--callout-explorative-shadow: rgb(168, 217, 255, 0.3);--callout-warning-accent: #F0E556;--callout-warning-icon: #F0E556;--callout-warning-shadow: rgb(240, 229, 86, 0.75);--callout-danger-accent: #FF90A1;--callout-danger-shadow: rgb(255, 144, 161, 0.75)}.callout-box{background-color:var(--recommended-bg);border-radius:10px;padding:18px 22px;margin-bottom:20px;border-left:4px solid}.callout-row{display:flex;align-items:flex-start;gap:14px}.callout-icon{font-size:22px;line-height:1;flex-shrink:0}.callout-badge{display:flex;align-items:center;justify-content:center;width:32px;height:32px;border-radius:50%;border:2px solid;flex-shrink:0}.callout-title{font-size:16px;font-weight:600;color:var(--recommended-title);margin-bottom:6px}.callout-body{font-size:14px;line-height:1.65}.callout-icon svg,.callout-badge svg{color:#131414!important}html.dark .callout-icon svg,html.dark .callout-badge svg{color:#FAFCFC!important}.callout-note{border-left-color:var(--callout-note-border)}.callout-note .callout-icon svg{color:var(--callout-note-accent)}.callout-remember{border-left-color:var(--callout-remember-accent)}.callout-remember .callout-icon svg,html.dark .callout-remember .callout-icon svg{color:var(--callout-remember-accent)!important}.callout-recommended{border-left-color:var(--callout-recommended-accent)}.callout-recommended .callout-icon svg,html.dark .callout-recommended .callout-icon svg{color:var(--callout-recommended-accent)!important}.callout-explorative{border-left-color:var(--callout-explorative-accent)}.callout-explorative .callout-icon svg,html.dark .callout-explorative .callout-icon svg{color:var(--callout-explorative-accent)!important}.callout-warning{border-left-color:var(--callout-warning-accent)}.callout-warning .callout-badge{border-color:var(--callout-warning-accent)}.callout-warning .callout-badge svg{color:var(--callout-warning-icon)}.callout-danger{border-left-color:var(--callout-danger-accent)}.callout-danger .callout-badge{border-color:var(--callout-danger-accent)}.callout-danger .callout-badge svg{color:var(--callout-danger-accent)}.btn-primary,.btn-secondary{display:inline-flex;align-items:center;justify-content:center;border-radius:9999px;padding:0.75rem 1.5rem;font-size:0.875rem;font-weight:500;border:none;text-decoration:none!important;transition:background-color 0.15s ease, color 0.15s ease}.btn-primary{background-color:#FEB6FE!important;color:#131414!important}.btn-primary:hover{background-color:#2E3030!important;color:#FAFCFC!important}html.dark .btn-primary:hover{border:1px solid #6B7070!important}.btn-secondary{background-color:#131414!important;color:#FAFCFC!important}.btn-secondary:hover{background-color:#2E3030!important;color:#FAFCFC!important}html.dark .btn-secondary{border:1px solid #6B7070!important}html:not(.dark) [data-component-part=\"field-name\"]{color:#131414!important}html:not(.dark) [role=\"tab\"].text-primary{color:#131414!important}html:not(.dark) [data-component-part=\"tab-button\"][data-active=\"true\"]{color:#131414!important;background-color:#EEF4F4;padding-left:10px;padding-right:10px;margin-right:-10px;border-radius:9999px;border-bottom-color:transparent!important}html:not(.dark) button[aria-label=\"Select language\"] div:hover{color:#131414!important}html:not(.dark) .method-pill.text-green-700,html:not(.dark) .method-nav-pill .text-green-700{background-color:rgb(34, 127, 71, 0.14)!important;color:#227F47!important}html.dark .method-pill.text-green-400,html.dark .method-nav-pill .text-green-400{background-color:rgb(33, 198, 99, 0.16)!important;color:#21C663!important}html:not(.dark) .method-pill.text-blue-700,html:not(.dark) .method-nav-pill .text-blue-700{background-color:rgb(64, 124, 214, 0.14)!important;color:#407CD6!important}html.dark .method-pill.text-blue-400,html.dark .method-nav-pill .text-blue-400{background-color:rgb(168, 217, 255, 0.16)!important;color:#A8D9FF!important}html:not(.dark) .method-pill.text-yellow-700,html:not(.dark) .method-nav-pill .text-yellow-700{background-color:rgb(219, 199, 19, 0.14)!important;color:#DBC713!important}html.dark .method-pill.text-yellow-400,html.dark .method-nav-pill .text-yellow-400{background-color:rgb(240, 229, 86, 0.18)!important;color:#F0E556!important}html:not(.dark) .method-pill.text-red-700,html:not(.dark) .method-nav-pill .text-red-700{background-color:rgb(241, 90, 113, 0.14)!important;color:#F15A71!important}html.dark .method-pill.text-red-400,html.dark .method-nav-pill .text-red-400{background-color:rgb(255, 144, 161, 0.16)!important;color:#FF90A1!important}html:not(.dark) [data-component-part=\"field-required-pill\"]{background-color:rgb(241, 90, 113, 0.12)!important;color:#F15A71!important}html:not(.dark) .method-nav-pill .bg-\\[\\#2AB673\\]{background-color:rgb(34, 127, 71, 0.14)!important;color:#227F47!important}html.dark .method-nav-pill .bg-\\[\\#2AB673\\]{background-color:rgb(33, 198, 99, 0.16)!important;color:#21C663!important}html:not(.dark) .method-nav-pill .bg-\\[\\#3064E3\\]{background-color:rgb(64, 124, 214, 0.14)!important;color:#407CD6!important}html.dark .method-nav-pill .bg-\\[\\#3064E3\\]{background-color:rgb(168, 217, 255, 0.16)!important;color:#A8D9FF!important}html:not(.dark) .method-nav-pill .bg-\\[\\#C28C30\\]{background-color:rgb(219, 199, 19, 0.14)!important;color:#DBC713!important}html.dark .method-nav-pill .bg-\\[\\#C28C30\\]{background-color:rgb(240, 229, 86, 0.18)!important;color:#F0E556!important}html:not(.dark) .method-nav-pill .bg-\\[\\#CB3A32\\]{background-color:rgb(241, 90, 113, 0.14)!important;color:#F15A71!important}html.dark .method-nav-pill .bg-\\[\\#CB3A32\\]{background-color:rgb(255, 144, 161, 0.16)!important;color:#FF90A1!important}html.dark [data-component-part=\"field-required-pill\"]{background-color:rgb(255, 144, 161, 0.14)!important;color:#FF90A1!important}.tryit-button.bg-\\[\\#2AB673\\],.tryit-button.bg-\\[\\#3064E3\\],.tryit-button.bg-\\[\\#C28C30\\],.tryit-button.bg-\\[\\#CB3A32\\]{background-color:#FEB6FE!important;color:#131414!important}.tryit-button:hover{opacity:1!important;background-color:#2E3030!important;color:#FAFCFC!important}.tryit-button svg.bg-white{background-color:#131414!important}.tryit-button:hover svg.bg-white{background-color:#FAFCFC!important}.card,.code-block,.code-block>div{border-radius:4px!important}.card,.code-block{transition:box-shadow 0.15s ease}.card:not(:hover){border-color:transparent!important}html:not(.dark) .card{background-color:#FAFCFC!important}html.dark .card{background-color:#2E3030!important}.card:hover{box-shadow:none!important}html.dark img[src*=\"/images/current/icons/\"]{filter:invert(1) brightness(1.5)}.card:hover img[src*=\"/images/current/icons/\"]{filter:invert(97%) sepia(73%) saturate(4507%) hue-rotate(231deg) brightness(108%) contrast(99%)!important}.callout-box{border-radius:4px!important}nav [class*=\"font-medium\"],nav [class*=\"font-semibold\"],aside [class*=\"font-medium\"],aside [class*=\"font-semibold\"],#table-of-contents [class*=\"font-medium\"],#table-of-contents [class*=\"font-semibold\"]{font-weight:450!important}nav a,#navbar a,aside a,#table-of-contents a{text-shadow:none!important}html:not(.dark) #navbar .nav-tabs-item.text-gray-800{color:#131414!important}.prose{counter-reset:step}.prose h3:is([id^=\"0\"],[id^=\"1\"],[id^=\"2\"],[id^=\"3\"],[id^=\"4\"],[id^=\"5\"],[id^=\"6\"],[id^=\"7\"],[id^=\"8\"],[id^=\"9\"]){counter-increment:step}.prose h3:is([id^=\"0\"],[id^=\"1\"],[id^=\"2\"],[id^=\"3\"],[id^=\"4\"],[id^=\"5\"],[id^=\"6\"],[id^=\"7\"],[id^=\"8\"],[id^=\"9\"])~ol{counter-reset:substep;list-style:none;margin-left:0;padding-left:0}.prose h3:is([id^=\"0\"],[id^=\"1\"],[id^=\"2\"],[id^=\"3\"],[id^=\"4\"],[id^=\"5\"],[id^=\"6\"],[id^=\"7\"],[id^=\"8\"],[id^=\"9\"])~ol>li{counter-increment:substep;position:relative;padding-left:2.75em}.prose h3:is([id^=\"0\"],[id^=\"1\"],[id^=\"2\"],[id^=\"3\"],[id^=\"4\"],[id^=\"5\"],[id^=\"6\"],[id^=\"7\"],[id^=\"8\"],[id^=\"9\"])~ol>li::before{content:counter(step) \".\" counter(substep) \". \";position:absolute;left:0;font-weight:450}[data-component-part=\"update-content\"] div[style*=\"margin-left\"]{position:relative}[data-component-part=\"update-content\"] div[style*=\"margin-left\"] img{position:absolute;top:0;left:0}[data-component-part=\"update-content\"] div[style*=\"margin-left\"] img[src*=\"-dark.svg\"]{display:none}html.dark [data-component-part=\"update-content\"] div[style*=\"margin-left\"] img[src*=\"-light.svg\"]{display:none}html.dark [data-component-part=\"update-content\"] div[style*=\"margin-left\"] img[src*=\"-dark.svg\"]{display:block}[data-component-part=\"update-content\"] div[style*=\"margin-left\"]>span{display:block;padding-left:22px}@media (min-width: 1024px){.update-container>.lg\\:w-\\[160px\\]{width:170px}}#content-area:has(.fit-tables) [data-component-part=\"scroll-area-content\"]{min-width:0!important;width:100%}#content-area:has(.fit-tables) table{table-layout:fixed;width:100%}#content-area:has(.fit-tables) table th:nth-child(1),#content-area:has(.fit-tables) table td:nth-child(1){width:19%}#content-area:has(.fit-tables) table th:nth-child(2),#content-area:has(.fit-tables) table td:nth-child(2),#content-area:has(.fit-tables) table th:nth-child(3),#content-area:has(.fit-tables) table td:nth-child(3){width:22%}#content-area:has(.fit-tables) table th:nth-child(4),#content-area:has(.fit-tables) table td:nth-child(4){width:13%}#content-area:has(.fit-tables) table th:nth-child(5),#content-area:has(.fit-tables) table td:nth-child(5){width:22%}#content-area:has(.fit-tables) table td,#content-area:has(.fit-tables) table th{min-width:0!important;overflow-wrap:break-word}"}],"page":{"pagePath":"reference/companies/companies-api-overview","slug":"/reference/companies/companies-api-overview","pageMetadata":{"title":"Company API Overview","description":null,"href":"/reference/companies/companies-api-overview"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`The Companies API enables you to perform the following:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Search by organisation ID: Returns the list of companies associated with the organisation.`}),`\n`,_jsx(_components.li,{children:`Search by company ID: Returns details of the specific company.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limits`,children:`Rate Limits`}),`\n`,_jsx(_components.p,{children:`The API has a rate limit of 600 requests per minute.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Company API Overview","description":null,"href":"/reference/companies/companies-api-overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":1,"children":[]},{"title":"Rate Limits","slug":"rate-limits","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/pleo-61d4d38b/0f802cd5fc8e586f/scripts/sidebar-api-filter.js"],"subdomain":"pleo-61d4d38b","siteName":"Pleo Docs","title":"Company API Overview - Pleo Docs","contextualStarterQuestions":[{"_id":"6af58a8dc8eba22f265168c8","deploymentId":"68c825a5227dcad6bb288ea7","questionText":"What's the rate limit?","status":"active","generatedBy":"contextual","path":"reference/companies/companies-api-overview","createdAt":"2026-11-12T09:44:45.663Z","updatedAt":"2026-11-12T09:44:45.663Z","__v":0},{"_id":"6af58a8dc8eba22f265168c9","deploymentId":"68c825a5227dcad6bb288ea7","questionText":"How do I find company details?","status":"active","generatedBy":"contextual","path":"reference/companies/companies-api-overview","createdAt":"2026-11-12T09:44:45.663Z","updatedAt":"2026-11-12T09:44:45.663Z","__v":0},{"_id":"6af58a8dc8eba22f265168c7","deploymentId":"68c825a5227dcad6bb288ea7","questionText":"How do I search by org ID?","status":"active","generatedBy":"contextual","path":"reference/companies/companies-api-overview","createdAt":"2026-11-12T09:44:45.663Z","updatedAt":"2026-11-12T09:44:45.663Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T09:44:35.151Z","originalFileLocation":"reference/companies/companies-api-overview.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=\"application-name\" content=\"Pleo Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Company API Overview - Pleo Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pleo Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.pleo.io/reference/companies/companies-api-overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pleo-61d4d38b.mintlify.site/_mintlify/api/og/v2?division=COMPANIES+API\u0026amp;title=Company+API+Overview\u0026amp;theme=b23a86b4c8a936794c05bd1a\u0026amp;signature=76b71cc19f8a0d5a5e20af56abbe55d2f27f842b94a9dfebf918192015fe3bf8\">\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=\"Company API Overview - Pleo Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pleo-61d4d38b.mintlify.site/_mintlify/api/og/v2?division=COMPANIES+API\u0026amp;title=Company+API+Overview\u0026amp;theme=b23a86b4c8a936794c05bd1a\u0026amp;signature=76b71cc19f8a0d5a5e20af56abbe55d2f27f842b94a9dfebf918192015fe3bf8\">\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/pleo-61d4d38b/zKRuSzeccuPGu0vR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pleo Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FEB6FE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.pleo.io/reference/companies/companies-api-overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/companies/companies-api-overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.pleo.io/#organization\",\"name\":\"Pleo Docs\",\"url\":\"https://developers.pleo.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pleo-61d4d38b/0im2PqYmwpP-taWp/logo/pleo-developers-light.svg?fit=max\u0026auto=format\u0026n=0im2PqYmwpP-taWp\u0026q=85\u0026s=c000128fc6805d6e5d279ec0fdc06880\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.pleo.io#website\",\"name\":\"Pleo Docs\",\"url\":\"https://developers.pleo.io\",\"publisher\":{\"@id\":\"https://developers.pleo.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.pleo.io/reference/companies/companies-api-overview#webpage\",\"url\":\"https://developers.pleo.io/reference/companies/companies-api-overview\",\"name\":\"Company API Overview\",\"dateModified\":\"2026-11-12T09:44:35.151Z\",\"isPartOf\":{\"@id\":\"https://developers.pleo.io#website\"},\"breadcrumb\":{\"@id\":\"https://developers.pleo.io/reference/companies/companies-api-overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.pleo.io/reference/companies/companies-api-overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Pleo Docs\",\"item\":\"https://developers.pleo.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Company API Overview\",\"item\":\"https://developers.pleo.io/reference/companies/companies-api-overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.pleo.io/reference/companies/companies-api-overview#article\",\"headline\":\"Company API Overview\",\"name\":\"Company API Overview\",\"url\":\"https://developers.pleo.io/reference/companies/companies-api-overview\",\"mainEntityOfPage\":{\"@id\":\"https://developers.pleo.io/reference/companies/companies-api-overview#webpage\"},\"dateModified\":\"2026-11-12T09:44:35.151Z\",\"publisher\":{\"@id\":\"https://developers.pleo.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.pleo.io#website\"}}]}\u003c/script>","agentPointerHref":"/reference/companies/companies-api-overview.md","siteName":"Pleo Docs","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Build with Pleo","pages":[{"title":"Build with Pleo","href":"/docs/current/getting-started/what-is-pleo"}]},{"tab":"AS/ERP","pages":[{"title":"AS/ERP","href":"/docs/current/getting-started/accounting-integrations-quickstart"}]},{"tab":"API Reference","groups":[{"group":"ABOUT THE PLEO API","pages":[{"title":"Introduction","href":"/reference/api-introduction"},{"title":"Authentication","url":"/docs/authentication-authorisation-introduction","href":"/reference/authentication"},{"title":"Metadata","href":"/reference/metadata-1"},{"title":"Request IDs","href":"/reference/request-ids-1"},{"title":"Pagination","href":"/reference/pagination"},{"title":"API Response Codes | Errors","href":"/reference/api-response-codes-errors-1"}]},{"group":"ACCOUNTING ENTRIES API","pages":[{"title":"Overview","href":"/reference/accounting-entries/accounting-entry-overview"},{"title":"Scopes","href":"/reference/accounting-entries/scopes"},{"group":"Accounting Entries API v1","pages":[{"openapi":"get /v1/accounting-entries/{accountingEntryId}","title":"Fetch a single accounting entry by id. ","href":"/reference/accounting-entries/v1/get-accounting-entry-by-id"},{"openapi":"post /v1/accounting-entries:search","title":"Fetch accounting entries based on filters. ","href":"/reference/accounting-entries/v1/search-accounting-entries"},{"openapi":"get /v1/accounting-entries/{accountingEntryId}/receipts","title":"Get all receipts of an accounting entry.","href":"/reference/accounting-entries/v1/get-all-receipts"},{"openapi":"get /v1/accounting-entries/{accountingEntryId}/receipts/{receiptId}","title":"Returns a receipt with time-bound access to the receipt file.","href":"/reference/accounting-entries/v1/get-receipt-file"},{"openapi":"post /v1/accounting-entries/receipts:search","title":"Apply filters to search for specific accounting entry receipts.","href":"/reference/accounting-entries/v1/search-receipts-by-post"}]}]},{"group":"APP MARKETPLACE API","pages":[{"title":"Overview","href":"/reference/marketplace/marketplace-overview"},{"title":"Migrating from /completions to /me:activate","href":"/reference/marketplace/installations-completions-migration"},{"group":"Installations","pages":[{"openapi":"put /v1/installations/completions","deprecated":true,"title":"Complete the installation of a client","href":"/reference/installations/complete-the-installation-of-a-client"},{"openapi":"get /v1/installations/me","title":"Get client installation","href":"/reference/installations/get-client-installation"},{"openapi":"put /v1/installations/me","title":"Update a client installation","href":"/reference/installations/update-a-client-installation"},{"openapi":"post /v1/installations/me","title":"Create a client installation","href":"/reference/installations/create-a-client-installation"},{"openapi":"delete /v1/installations/me","title":"Delete client's installation","href":"/reference/installations/delete-clients-installation"},{"openapi":"post /v1/installations/me:activate","title":"Activate the installation for a client","href":"/reference/installations/activate-the-installation-for-a-client"}]},{"group":"External Clients","pages":[{"openapi":"get /v1/introspect","title":"Introspect the details of the current authentication.","href":"/reference/external-clients/introspect-the-details-of-the-current-authentication"}]}]},{"group":"BOOKKEEPING CATEGORIES API","pages":[{"title":"Overview","href":"/reference/categories/bookkeeping-categories-api-overview"},{"title":"Scopes","href":"/reference/categories/bookkeeping-categories-api-scopes"},{"group":"Categories","pages":[{"openapi":"post /v1/bookkeeping-categories","title":"Create a new bookkeeping category","href":"/reference/bookkeeping-categories/create-a-new-bookkeeping-category"},{"openapi":"get /v1/bookkeeping-categories/{categoryId}","title":"Retrieve a bookkeeping category by its ID","href":"/reference/bookkeeping-categories/retrieve-a-bookkeeping-category-by-its-id"},{"openapi":"put /v1/bookkeeping-categories/{categoryId}","title":"Update a bookkeeping category","href":"/reference/bookkeeping-categories/update-a-bookkeeping-category"},{"openapi":"delete /v1/bookkeeping-categories/{categoryId}","title":"Delete a bookkeeping category","href":"/reference/bookkeeping-categories/delete-a-bookkeeping-category"},{"openapi":"post /v1/bookkeeping-categories:search","title":"Fetch a list of bookkeeping categories","href":"/reference/bookkeeping-categories/fetch-a-list-of-bookkeeping-categories"}]},{"group":"Category groups","pages":[{"openapi":"post /v1/bookkeeping-category-groups","title":"Create a new bookkeeping category group","href":"/reference/bookkeeping-category-groups/create-a-new-bookkeeping-category-group"},{"openapi":"get /v1/bookkeeping-category-groups/{categoryGroupId}","title":"Retrieve a bookkeeping category group by its ID","href":"/reference/bookkeeping-category-groups/retrieve-a-bookkeeping-category-group-by-its-id"},{"openapi":"put /v1/bookkeeping-category-groups/{categoryGroupId}","title":"Update a bookkeeping category group","href":"/reference/bookkeeping-category-groups/update-a-bookkeeping-category-group"},{"openapi":"delete /v1/bookkeeping-category-groups/{categoryGroupId}","title":"Delete a bookkeeping category group","href":"/reference/bookkeeping-category-groups/delete-a-bookkeeping-category-group"},{"openapi":"post /v1/bookkeeping-category-groups:search","title":"Fetch a list of bookkeeping category groups","href":"/reference/bookkeeping-category-groups/fetch-a-list-of-bookkeeping-category-groups"}]},{"group":"Category aggregations","pages":[{"openapi":"get /v1/bookkeeping-category-aggregations","title":"Get aggregated bookkeeping category groups","href":"/reference/bookkeeping-category-aggregations/get-aggregated-bookkeeping-category-groups"}]}]},{"group":"CHART OF ACCOUNTS API","pages":[{"title":"Overview","href":"/reference/accounts/chart-of-accounts-api-overview"},{"title":"Scopes","href":"/reference/accounts/chart-of-accounts-api-scopes"},{"group":"Accounts","pages":[{"openapi":"post /v1/chart-of-accounts","title":"Create a new account","href":"/reference/accounts/create-a-new-account"},{"openapi":"get /v1/chart-of-accounts/{accountId}","title":"Retrieve an account in Pleo by its ID","href":"/reference/accounts/retrieve-an-account-in-pleo-by-its-id"},{"openapi":"put /v1/chart-of-accounts/{accountId}","title":"Update an account","href":"/reference/accounts/update-an-account"},{"openapi":"delete /v1/chart-of-accounts/{accountId}","title":"Delete an account","href":"/reference/accounts/delete-an-account"},{"openapi":"post /v1/chart-of-accounts:search","title":"Fetch a list of accounts","href":"/reference/accounts/fetch-a-list-of-accounts"},{"openapi":"post /v1/chart-of-accounts/batch","title":"Create multiple accounts in a single request","description":"\nCreates multiple bookkeeping accounts in a single batch operation.\nThis endpoint validates each account in the batch and returns both successfully created accounts and failed items with their failure reasons.\nAccounts that pass validation will be created, while invalid accounts will be returned in the failed list.\n","href":"/reference/accounts/create-multiple-accounts-in-a-single-request"}]}]},{"group":"COMPANIES API","pages":[{"title":"Company API Overview","href":"/reference/companies/companies-api-overview"},{"title":"Scopes","description":"The following table specifies the scope required to access the Companies API endpoints:","href":"/reference/companies/companies-api-scopes"},{"group":"Companies","pages":[{"openapi":"get /v1/companies","title":"Search for Companies","href":"/reference/companies/search-for-companies"},{"openapi":"get /v1/companies/{companyId}","title":"Search for a Specific Company","href":"/reference/companies/search-for-a-specific-company"}]}]},{"group":"COMPANY BALANCE API","pages":[{"title":"Overview","href":"/reference/company-balance/company-balance-api-overview"},{"title":"Scopes","href":"/reference/company-balance/company-balance-api-scopes"},{"openapi":"get /v1/companies/{companyId}/balance","title":"Get the balance for a company","href":"/reference/company-balance/get-the-balance-for-a-company"}]},{"group":"EMPLOYEES API","pages":[{"title":"Overview","href":"/reference/employees/employees-api-overview"},{"title":"Scopes","href":"/reference/employees/employees-api-scopes"},{"group":"Employees","pages":[{"openapi":"get /v2/employees","title":"Search for employees","href":"/reference/employees/search-for-employees"},{"openapi":"get /v2/employees/{employeeId}","title":"Search for a specific employee","href":"/reference/employees/search-for-a-specific-employee"}]}]},{"group":"ENRICHMENT API","pages":[{"title":"Overview","href":"/reference/enrichment-api/enrichment-api-overview"},{"title":"Scopes","href":"/reference/enrichment-api/enrichment-api-scopes"},{"title":"Enrichment Workflow Quick Guide","href":"/reference/enrichment-api/enrichment-workflow-basic-guide"},{"group":"Enrichment API (v2)","pages":[{"title":"Enrich Accounting Entry","openapi":"post /v2/accounting-entries:enrich","href":"/reference/enrichment-api/enrichment-api-v2/enrich-accounting-entry"}]}]},{"group":"EXPORT API","pages":[{"title":"Export API Overview","href":"/reference/export-api/export-api-overview"},{"title":"Export API Scopes","href":"/reference/export-api/export-api-scopes"},{"title":"Vendor Tagging in Export Items","href":"/reference/export-api/vendor-tagging-in-export-items"},{"title":"Multi Currency Configuration","href":"/reference/export-api/multi-currency-configuration"},{"title":"Export API Workflow","href":"/reference/export-api/export-api-workflow"},{"group":"Export API (v3)","pages":[{"openapi":"post /v3/export-job-events","title":"Create an Export Job Event","href":"/reference/export-api/export-api-v3/create-an-export-job-event"},{"openapi":"get /v3/export-jobs","title":"Get a List of Export Jobs","href":"/reference/export-api/export-api-v3/get-a-list-of-export-jobs"},{"openapi":"post /v3/export-jobs","title":"Create a New Export Job","href":"/reference/export-api/export-api-v3/create-a-new-export-job"},{"openapi":"get /v3/export-jobs/{jobId}","title":"Get an Export Job","href":"/reference/export-api/export-api-v3/get-an-export-job"},{"openapi":"get /v3/export-jobs/{jobId}/items","title":"Get Export Job Items","href":"/reference/export-api/export-api-v3/get-export-job-items"},{"openapi":"put /v3/export-jobs/{jobId}/items","title":"Update Export Job Items","href":"/reference/export-api/export-api-v3/update-export-job-items"},{"openapi":"get /v3/export-items","title":"Get Export Items","href":"/reference/export-api/export-items-v3/get-export-items"}]},{"group":"Export API (v2)","pages":[{"openapi":"post /v2/export-job-events","title":"Create an Export Job Event","href":"/reference/export-api/export-api-v2/create-an-export-job-event"},{"openapi":"get /v2/export-jobs","title":"Get a List of Export Jobs","href":"/reference/export-api/export-api-v2/get-a-list-of-export-jobs"},{"openapi":"post /v2/export-jobs","title":"Create a New Export Job","href":"/reference/export-api/export-api-v2/create-a-new-export-job"},{"openapi":"get /v2/export-jobs/{jobId}","title":"Get an Export Job","href":"/reference/export-api/export-api-v2/get-an-export-job"},{"openapi":"get /v2/export-jobs/{jobId}/items","title":"Get Export Job Items","href":"/reference/export-api/export-api-v2/get-export-job-items"},{"openapi":"put /v2/export-jobs/{jobId}/items","title":"Update Export Job Items","href":"/reference/export-api/export-api-v2/update-export-job-items"},{"openapi":"get /v2/export-items","title":"Get Export Items","href":"/reference/export-api/export-items-v2/get-export-items"}]},{"group":"Export API (v1)","pages":[{"openapi":"post /v1/export-job-events","deprecated":true,"title":"Create an Export Job Event","href":"/reference/export-api/export-api-v1/create-an-export-job-event"},{"openapi":"get /v1/export-jobs","deprecated":true,"title":"Get a List of Export Jobs","href":"/reference/export-api/export-api-v1/get-a-list-of-export-jobs"},{"openapi":"post /v1/export-jobs","deprecated":true,"title":"Create a New Export Job","href":"/reference/export-api/export-api-v1/create-a-new-export-job"},{"openapi":"get /v1/export-jobs/{jobId}","deprecated":true,"title":"Get an Export Job","href":"/reference/export-api/export-api-v1/get-an-export-job"},{"openapi":"get /v1/export-jobs/{jobId}/items","deprecated":true,"title":"Get Export Job Items","href":"/reference/export-api/export-api-v1/get-export-job-items"},{"openapi":"put /v1/export-jobs/{jobId}/items","deprecated":true,"title":"Update Export Job Items","href":"/reference/export-api/export-api-v1/update-export-job-items"}]},{"group":"Export Items (v1)","pages":[{"openapi":"get /v1/export-items","deprecated":true,"title":"Get Export Items","href":"/reference/export-api/export-items-v1/get-export-items"}]}]},{"group":"TAGS API","pages":[{"title":"Overview","href":"/reference/tags-overview"},{"title":"Scopes","href":"/reference/scopes-2"},{"group":"Tag Groups","pages":[{"openapi":"get /v0/aggregations/tag-groups","title":"Returns all tag groups for given company in an aggregated format","href":"/reference/tags-api/tag-groups/returns-all-tag-groups-for-given-company-in-an-aggregated-format"},{"openapi":"get /v0/aggregations/tag-groups/{groupId}","title":"Returns an aggregated tag group by its ID","href":"/reference/tags-api/tag-groups/returns-an-aggregated-tag-group-by-its-id"},{"openapi":"get /v0/tag-groups","title":"Returns all tag groups for given company","href":"/reference/tags-api/tag-groups/returns-all-tag-groups-for-given-company"},{"openapi":"post /v0/tag-groups","title":"Creates a new tag group resource","href":"/reference/tags-api/tag-groups/creates-a-new-tag-group-resource"},{"openapi":"get /v0/tag-groups/{groupId}","title":"Returns the tag group resource by id","href":"/reference/tags-api/tag-groups/returns-the-tag-group-resource-by-id"},{"openapi":"put /v0/tag-groups/{groupId}","title":"Updates the tag group resource by id","href":"/reference/tags-api/tag-groups/updates-the-tag-group-resource-by-id"},{"openapi":"delete /v0/tag-groups/{groupId}","title":"Deletes the tag group resource by id","href":"/reference/tags-api/tag-groups/deletes-the-tag-group-resource-by-id"},{"openapi":"get /v0/tag-groups/{groupId}/dimensions","title":"Get a list of tag group dimensions","href":"/reference/tags-api/tag-groups/get-a-list-of-tag-group-dimensions"},{"openapi":"post /v0/tag-groups/{groupId}/dimensions","title":"Creates a new tag group dimension","href":"/reference/tags-api/tag-groups/creates-a-new-tag-group-dimension"},{"openapi":"get /v0/tag-groups/{groupId}/dimensions/{dimensionId}","title":"Get a tag group dimension","href":"/reference/tags-api/tag-groups/get-a-tag-group-dimension"},{"openapi":"put /v0/tag-groups/{groupId}/dimensions/{dimensionId}","title":"Update a tag group dimension","href":"/reference/tags-api/tag-groups/update-a-tag-group-dimension"},{"openapi":"delete /v0/tag-groups/{groupId}/dimensions/{dimensionId}","title":"Delete a tag group dimension","href":"/reference/tags-api/tag-groups/delete-a-tag-group-dimension"}]},{"group":"Tags","pages":[{"openapi":"post /v0/aggregations/tags","title":"Search and return aggregated tags","href":"/reference/tags-api/tags/search-and-return-aggregated-tags"},{"openapi":"get /v0/tag-groups/{groupId}/tags","title":"Returns tags for given tag group","href":"/reference/tags-api/tags/returns-tags-for-given-tag-group"},{"openapi":"post /v0/tag-groups/{groupId}/tags","title":"Creates a new tag sub-resource under the given tag group","href":"/reference/tags-api/tags/creates-a-new-tag-sub-resource-under-the-given-tag-group"},{"openapi":"get /v0/tags","title":"Search tags","href":"/reference/tags-api/tags/search-tags"},{"openapi":"get /v0/tags/{tagId}","title":"Returns tag by id","href":"/reference/tags-api/tags/returns-tag-by-id"},{"openapi":"put /v0/tags/{tagId}","title":"Updates tag by id","href":"/reference/tags-api/tags/updates-tag-by-id"},{"openapi":"delete /v0/tags/{tagId}","title":"Deletes tag by id","href":"/reference/tags-api/tags/deletes-tag-by-id"},{"openapi":"get /v0/tags/{tagId}/dimensions","title":"Fetches dimension values","href":"/reference/tags-api/tags/fetches-dimension-values"},{"openapi":"get /v0/tags/{tagId}/dimensions/{dimensionId}","title":"Gets a dimension value","href":"/reference/tags-api/tags/gets-a-dimension-value"},{"openapi":"put /v0/tags/{tagId}/dimensions/{dimensionId}","title":"Updates a dimension value","href":"/reference/tags-api/tags/updates-a-dimension-value"},{"openapi":"post /v0/tags/{tagId}/dimensions/{dimensionId}","title":"Creates a dimension value","href":"/reference/tags-api/tags/creates-a-dimension-value"},{"openapi":"delete /v0/tags/{tagId}/dimensions/{dimensionId}","title":"Deletes a dimension value","href":"/reference/tags-api/tags/deletes-a-dimension-value"}]}]},{"group":"TAX CODE API","pages":[{"title":"Overview","href":"/reference/tax-codes-overview"},{"title":"Scopes","href":"/reference/scopes-3"},{"group":"Tax Codes","pages":[{"openapi":"post /v0/tax-codes","title":"Create a new tax code","href":"/reference/tax-codes/create-a-new-tax-code"},{"openapi":"get /v0/tax-codes/{taxCodeId}","title":"Returns a given tax code","href":"/reference/tax-codes/returns-a-given-tax-code"},{"openapi":"put /v0/tax-codes/{taxCodeId}","title":"Update an tax code","href":"/reference/tax-codes/update-an-tax-code"},{"openapi":"delete /v0/tax-codes/{taxCodeId}","title":"Delete an tax code","href":"/reference/tax-codes/delete-an-tax-code"},{"openapi":"post /v0/tax-codes:search","title":"Returns a list of tax codes","href":"/reference/tax-codes/returns-a-list-of-tax-codes"}]}]},{"group":"TEAMS API","pages":[{"title":"Team API Overview","href":"/reference/teams/teams-api-overview"},{"title":"Scopes","href":"/reference/teams/teams-api-scopes"},{"group":"Teams","pages":[{"openapi":"post /v1/teams/{teamId}/members","title":"Add members to a Team","href":"/reference/teams/add-team-members"},{"openapi":"post /v1/teams","title":"Create a Team","href":"/reference/teams/create-a-team"},{"openapi":"delete /v1/teams/{teamId}","title":"Delete a Team by ID","href":"/reference/teams/delete-a-team"},{"openapi":"get /v1/teams/{teamId}","title":"Get a Team by ID","href":"/reference/teams/get-a-team-by-id"},{"openapi":"get /v1/teams","title":"Search for teams","href":"/reference/teams/search-for-teams"},{"openapi":"delete /v1/teams/{teamId}/members/{employeeId}","title":"Remove a member from a Team","href":"/reference/teams/remove-a-team-member"},{"openapi":"patch /v1/teams/{teamId}","title":"Partially update a Team","href":"/reference/teams/update-a-team"}]}]},{"group":"VENDORS API","pages":[{"title":"Overview","href":"/reference/vendor/vendors-api-overview"},{"title":"Vendor API Scopes","href":"/reference/vendor/vendor-api-scopes"},{"group":"Vendors API","pages":[{"openapi":"post /v1/vendors","title":"Create a New Vendor","href":"/reference/external-vendors/create-a-new-vendor"},{"openapi":"get /v1/vendors/{id}","title":"Retrieves a Vendor in Pleo by its id","href":"/reference/external-vendors/retrieves-a-vendor-in-pleo-by-its-id"},{"openapi":"put /v1/vendors/{id}","title":"Update a Vendor","href":"/reference/external-vendors/update-a-vendor"},{"openapi":"post /v1/vendors/{id}:activate","title":"Activate a Vendor","href":"/reference/external-vendors/activate-a-vendor"},{"openapi":"post /v1/vendors/{id}:archive","title":"Archive a Vendor","href":"/reference/external-vendors/archive-a-vendor"},{"openapi":"post /v1/vendors:search","title":"Fetches Vendors by search criteria","href":"/reference/external-vendors/fetches-vendors-by-search-criteria"}]}]},{"group":"WEBHOOK SUBSCRIPTIONS API","pages":[{"title":"Overview","href":"/reference/webhooks/overview-webhooks"},{"title":"Authentication and Authorisation","href":"/reference/webhooks/webhooks-authentication-authorisation"},{"group":"Subscriptions","pages":[{"title":"Subscriptions","href":"/reference/webhooks/subscriptions"},{"openapi":"get /v1/subscriptions","title":"Get subscriptions","href":"/reference/subscriptions/get-subscriptions"},{"openapi":"post /v1/subscriptions","title":"Create a subscription","href":"/reference/subscriptions/create-a-subscription"},{"openapi":"get /v1/subscriptions/{id}","title":"Get subscription by id","href":"/reference/subscriptions/get-subscription-by-id"},{"openapi":"put /v1/subscriptions/{id}","title":"Update a subscription","href":"/reference/subscriptions/update-a-subscription"},{"openapi":"delete /v1/subscriptions/{id}","title":"Delete subscription by id","href":"/reference/subscriptions/delete-subscription-by-id"},{"openapi":"get /v1/subscriptions/{id}/activities","title":"Get subscription activities","href":"/reference/subscriptions/get-subscription-activities"},{"openapi":"get /v1/subscriptions/{id}/secret","title":"Get subscription secret by id","href":"/reference/subscriptions/get-subscription-secret-by-id"}]},{"title":"Webhook Events","href":"/reference/webhooks/webhook-events"}]},{"group":"PLEO.IO API (DEPRECATED)","pages":[{"title":"Deprecation and Migration Information","href":"/reference/notice"},{"title":"Authentication for the Legacy API","icon":"circle-exclamation","href":"/reference/authentication-legacy"},{"title":"Attribute explanations","icon":"circle-exclamation","href":"/reference/attribute-explanations"},{"title":"Request ID's","icon":"circle-exclamation","href":"/reference/request-ids"},{"title":"Errors","icon":"circle-exclamation","href":"/reference/errors"},{"title":"Versioning","icon":"circle-exclamation","href":"/reference/versioning"},{"title":"FAQ","icon":"circle-exclamation","href":"/reference/faq-1"},{"title":"Postman Collection","icon":"circle-exclamation","href":"/reference/open-api"},{"group":"HealthCheck","icon":"circle-exclamation","pages":[{"openapi":"get /health","deprecated":true,"title":"Returns healtcheck status of OpenAPIs for a given company","href":"/reference/pleo-deprecated/healthcheck/returns-healtcheck-status-of-openapis-for-a-given-company"}]},{"group":"Expenses","icon":"circle-exclamation","pages":[{"openapi":"get /expenses/{expenseId}","deprecated":true,"title":"Get an expense for a company","href":"/reference/pleo-deprecated/expenses/get-an-expense-for-a-company"},{"openapi":"get /expenses","deprecated":true,"title":"Get expenses for a company","href":"/reference/pleo-deprecated/expenses/get-expenses-for-a-company"},{"openapi":"put /expenses","deprecated":true,"title":"Update a given list of expenses. ","href":"/reference/pleo-deprecated/expenses/update-a-given-list-of-expenses"}]},{"group":"Tag Groups","icon":"circle-exclamation","pages":[{"openapi":"get /tag-groups","deprecated":true,"title":"Get all tag groups belonging to the specified company.","href":"/reference/pleo-deprecated/tag-groups/get-all-tag-groups-belonging-to-the-specified-company"},{"openapi":"post /tag-groups","deprecated":true,"title":"Create a new tag group.","href":"/reference/pleo-deprecated/tag-groups/create-a-new-tag-group"},{"openapi":"get /tag-groups/{tagGroupId}","deprecated":true,"title":"Get a tag group","href":"/reference/pleo-deprecated/tag-groups/get-a-tag-group"},{"openapi":"delete /tag-groups/{tagGroupId}","deprecated":true,"title":"Delete or archive a tag group.","href":"/reference/pleo-deprecated/tag-groups/delete-or-archive-a-tag-group"},{"openapi":"patch /tag-groups/{tagGroupId}","deprecated":true,"title":"Update a tag group","href":"/reference/pleo-deprecated/tag-groups/update-a-tag-group"},{"openapi":"get /tag-groups/{tagGroupId}/tags","deprecated":true,"title":"Get all tags for a specified tag group","href":"/reference/pleo-deprecated/tag-groups/get-all-tags-for-a-specified-tag-group"},{"openapi":"post /tag-groups/{tagGroupId}/tags","deprecated":true,"title":"Create a new tag","href":"/reference/pleo-deprecated/tag-groups/create-a-new-tag"},{"openapi":"get /tag-groups/{tagGroupId}/tags/{tagId}","deprecated":true,"title":"Get a tag from a tag group","href":"/reference/pleo-deprecated/tag-groups/get-a-tag-from-a-tag-group"},{"openapi":"delete /tag-groups/{tagGroupId}/tags/{tagId}","deprecated":true,"title":"Delete a tag","href":"/reference/pleo-deprecated/tag-groups/delete-a-tag"},{"openapi":"patch /tag-groups/{tagGroupId}/tags/{tagId}","deprecated":true,"title":"Update a tag","href":"/reference/pleo-deprecated/tag-groups/update-a-tag"}]},{"group":"Company","icon":"circle-exclamation","pages":[{"openapi":"get /companies/balance","deprecated":true,"title":"Get company account balance","href":"/reference/pleo-deprecated/company/get-company-account-balance"}]},{"group":"Receipts","icon":"circle-exclamation","pages":[{"openapi":"get /expenses/{expenseId}/receipts","deprecated":true,"title":"Get expense receipts","href":"/reference/pleo-deprecated/receipts/get-expense-receipts"},{"openapi":"get /expenses/{expenseId}/receipts/{receiptId}","deprecated":true,"title":"Get an expense receipt","href":"/reference/pleo-deprecated/receipts/get-an-expense-receipt"}]},{"group":"Employees","icon":"circle-exclamation","pages":[{"openapi":"get /employees/{employeeId}","deprecated":true,"title":"Get an employee for a company","href":"/reference/pleo-deprecated/employees/get-an-employee-for-a-company"},{"openapi":"put /employees/{employeeId}","deprecated":true,"title":"Update an employee for a company","href":"/reference/pleo-deprecated/employees/update-an-employee-for-a-company"},{"openapi":"delete /employees/{employeeId}","deprecated":true,"title":"Delete an employee for a company","href":"/reference/pleo-deprecated/employees/delete-an-employee-for-a-company"},{"openapi":"get /employees","deprecated":true,"title":"Get company employees","href":"/reference/pleo-deprecated/employees/get-company-employees"},{"openapi":"post /employees","deprecated":true,"title":"Create an employee for a company","href":"/reference/pleo-deprecated/employees/create-an-employee-for-a-company"}]},{"group":"Accounts","icon":"circle-exclamation","pages":[{"openapi":"get /accounts/{accountId}","deprecated":true,"title":"Get an account for a company","href":"/reference/pleo-deprecated/accounts/get-an-account-for-a-company"},{"openapi":"put /accounts/{accountId}","deprecated":true,"title":"Update an account for a company","href":"/reference/pleo-deprecated/accounts/update-an-account-for-a-company"},{"openapi":"delete /accounts/{accountId}","deprecated":true,"title":"Delete an account for a company","href":"/reference/pleo-deprecated/accounts/delete-an-account-for-a-company"},{"openapi":"get /accounts","deprecated":true,"title":"Get company accounts","href":"/reference/pleo-deprecated/accounts/get-company-accounts"},{"openapi":"post /accounts","deprecated":true,"title":"Create an account for a company","href":"/reference/pleo-deprecated/accounts/create-an-account-for-a-company"},{"openapi":"get /account-groups","deprecated":true,"title":"Get all company account groups","href":"/reference/pleo-deprecated/accounts/get-all-company-account-groups"},{"openapi":"post /account-groups","deprecated":true,"title":"Create an account group for a company","href":"/reference/pleo-deprecated/accounts/create-an-account-group-for-a-company"},{"openapi":"get /account-groups/{accountCategoryId}","deprecated":true,"title":"Get an account group for a company","href":"/reference/pleo-deprecated/accounts/get-an-account-group-for-a-company"},{"openapi":"put /account-groups/{accountCategoryId}","deprecated":true,"title":"Update an account group for a company","href":"/reference/pleo-deprecated/accounts/update-an-account-group-for-a-company"},{"openapi":"delete /account-groups/{accountCategoryId}","deprecated":true,"title":"Delete an account group for a company","href":"/reference/pleo-deprecated/accounts/delete-an-account-group-for-a-company"}]},{"group":"Experimental","icon":"circle-exclamation","pages":[{"openapi":"get /account-categories","deprecated":true,"title":"Get all company account groups","href":"/reference/pleo-deprecated/experimental/get-all-company-account-groups"},{"openapi":"post /account-categories","deprecated":true,"title":"Create an account group for a company","href":"/reference/pleo-deprecated/experimental/create-an-account-group-for-a-company"},{"openapi":"get /account-categories/{accountCategoryId}","deprecated":true,"title":"Get an account group for a company","href":"/reference/pleo-deprecated/experimental/get-an-account-group-for-a-company"},{"openapi":"put /account-categories/{accountCategoryId}","deprecated":true,"title":"Update an account group for a company","href":"/reference/pleo-deprecated/experimental/update-an-account-group-for-a-company"},{"openapi":"delete /account-categories/{accountCategoryId}","deprecated":true,"title":"Delete an account group for a company","href":"/reference/pleo-deprecated/experimental/delete-an-account-group-for-a-company"}]},{"group":"Teams","icon":"circle-exclamation","pages":[{"openapi":"get /teams","deprecated":true,"title":"Get all teams for a company","href":"/reference/pleo-deprecated/teams/get-all-teams-for-a-company"},{"openapi":"post /teams","deprecated":true,"title":"Create a team for a company","href":"/reference/pleo-deprecated/teams/create-a-team-for-a-company"},{"openapi":"get /teams/{teamId}","deprecated":true,"title":"Get a team for a company","href":"/reference/pleo-deprecated/teams/get-a-team-for-a-company"},{"openapi":"put /teams/{teamId}","deprecated":true,"title":"Update a team for a company","href":"/reference/pleo-deprecated/teams/update-a-team-for-a-company"},{"openapi":"delete /teams/{teamId}","deprecated":true,"title":"Delete a team for a company","href":"/reference/pleo-deprecated/teams/delete-a-team-for-a-company"},{"openapi":"put /teams/{teamId}/employees/{employeeId}","deprecated":true,"title":"Add an employee to a team","href":"/reference/pleo-deprecated/teams/add-an-employee-to-a-team"},{"openapi":"delete /teams/{teamId}/employees/{employeeId}","deprecated":true,"title":"Remove an employee from a team","href":"/reference/pleo-deprecated/teams/remove-an-employee-from-a-team"}]},{"group":"Tax Codes","icon":"circle-exclamation","pages":[{"openapi":"get /tax-codes/{taxCodeId}","deprecated":true,"title":"Get a tax code for a company","href":"/reference/pleo-deprecated/tax-codes/get-a-tax-code-for-a-company"},{"openapi":"get /tax-codes","deprecated":true,"title":"Get tax codes for a company","href":"/reference/pleo-deprecated/tax-codes/get-tax-codes-for-a-company"}]}]}]},{"tab":"Pleo MCP","pages":[{"title":"Pleo MCP","href":"/docs/current/pleo-mcp/get-started/pleo-mcp-overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Deprecation and Migration","pages":[{"title":"Deprecation and Migration","href":"/deprecation/overview"}]},{"tab":"Terms of Service","pages":[{"title":"Terms of Service","href":"/page/terms-of-service"}]}]},"basePath":"","title":"Company API Overview - Pleo Docs","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":[],"chunks":[]}