---
title: "[Internal] List business units"
method: GET
path: "/api/business-units"
tags: ["Business Units"]
---

# \[Internal\] List business units

`GET /api/business-units`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/business-units`
- Auth: none declared

## Query parameters

- `active` boolean, nullable
- `limit` integer, nullable
- `start_key` string, nullable
- `count_invoices_waiting_review` boolean

## Response `200`

Successful Response

- ListBusinessUnitsResponse
  - `results` BusinessUnitDTO[], required
    - `aggregate_id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `ident` string, nullable, required
    - `vat_id` string, nullable, required
    - `integration_type` 'INFOR' | 'ESLOG' | 'MINIMAX', required
    - `name` string, required
    - `active` boolean, required
    - `integration_configuration` IntegrationConfigurationResponseDto, required
      - `import_configuration` union
        - AzureConfigurationResponseDto
          - `name` 'AzureConfigurationResponseDto'
          - `email` string, required
        - BusinessUnitEmailImportConfigurationDto
          - `name` 'BusinessUnitEmailImportConfigurationDto'
          - `email` string, nullable
          - `proforma_email` string, nullable
          - `read_directly` boolean
          - `entries` EmailImportEntryDto[]
            - `email` string, required
            - `type` string, required
            - `document_category` string, nullable
        - MinimaxImportExportConfigurationResponseDto
          - `name` 'MinimaxImportExportConfigurationResponseDto'
          - `username` string, required
      - `processing_configuration` ProcessingConfigurationDto
        - `name` 'ProcessingConfigurationDto'
        - `batch_splitting` boolean
        - `processing_flow` 'REVIEW_REQUIRED' | 'DIRECT_EXPORT'
        - `check_unique_invoices` boolean
        - `document_type_name` string, nullable
        - `add_timestamp_prefix_to_exported_invoices` boolean
      - `export_configuration` union
        - FolderExportConfigurationDto
          - `name` 'FolderExportConfigurationDto'
          - `folder_path` string, required
          - `export_eslog_envelope` boolean, required
        - EmailExportConfigurationDto
          - `name` 'EmailExportConfigurationDto'
          - `email` string, required
          - `export_eslog_envelope` boolean, required
        - ApiExportConfigurationDto
          - `name` 'ApiExportConfigurationDto'
          - `export_eslog_envelope` boolean
    - `email_import_configuration` BusinessUnitEmailImportConfigurationDto, required
      - `name` 'BusinessUnitEmailImportConfigurationDto'
      - `email` string, nullable
      - `proforma_email` string, nullable
      - `read_directly` boolean
      - `entries` EmailImportEntryDto[]
        - `email` string, required
        - `type` string, required
        - `document_category` string, nullable
    - `processing_configuration` ProcessingConfigurationDto, required
      - `name` 'ProcessingConfigurationDto'
      - `batch_splitting` boolean
      - `processing_flow` 'REVIEW_REQUIRED' | 'DIRECT_EXPORT'
      - `check_unique_invoices` boolean
      - `document_type_name` string, nullable
      - `add_timestamp_prefix_to_exported_invoices` boolean
    - `export_configuration` union, required
      - FolderExportConfigurationDto
        - `name` 'FolderExportConfigurationDto'
        - `folder_path` string, required
        - `export_eslog_envelope` boolean, required
      - EmailExportConfigurationDto
        - `name` 'EmailExportConfigurationDto'
        - `email` string, required
        - `export_eslog_envelope` boolean, required
      - ApiExportConfigurationDto
        - `name` 'ApiExportConfigurationDto'
        - `export_eslog_envelope` boolean
    - `minimax_configuration` MinimaxConfiguration, required
      - `name` 'MinimaxConfiguration'
      - `dummy_customer_id` integer, nullable
      - `minimax_inbox_email_address` string, nullable
      - `send_eslog_after_processing` boolean
      - `allowed_inbox_types` MinimaxInboxType[], nullable
    - `number_invoices_waiting_review` integer, nullable
    - `extract_line_items` boolean
    - `read_inbox` boolean, required
    - `inbox_email` string, required
    - `notification_configuration` NotificationConfiguration, required
      - `notification_emails` string[]
      - `notify_new_document` boolean
      - `auto_response_new_document` boolean
      - `send_daily_summary` boolean
    - `approval_configuration` ApprovalConfigurationDtoOutput, required
      - `name` 'ApprovalConfiguration'
      - `enabled` boolean
      - `rules` ApprovalRuleDtoOutput[]
        - `id` string, uuid, nullable
        - `name` string, nullable
        - `filters` FilterDTO[], required
          - `field_name` string, required
          - `operator` 'EQUALS' | 'NOT_EQUALS' | 'BEGINS_WITH' | 'LESS_THAN' | 'LESS_THAN_EQUALS' | 'GREATER_THAN' | 'GREATER_THAN_EQUALS' | 'BETWEEN' | 'IS_NULL' | 'IS_NOT_NULL' | 'MATCH_ANY' | 'MATCH_ALL' | 'IN' | 'NOT_IN', required
          - `values` string[], required
        - `filter_logic` 'AND' | 'OR'
        - `approvers` ApproverRefDto[]
          - `type` 'user' | 'role', required
          - `id` string, uuid, required
          - `identifier` string, nullable
        - `auto_approve` boolean
      - `default_approvers` ApproverRefDto[]
        - `type` 'user' | 'role', required
        - `id` string, uuid, required
        - `identifier` string, nullable
    - `email_whitelist_configuration` EmailWhitelistConfiguration, required
      - `allow_all` boolean
      - `whitelisted_emails` string[]
      - `whitelisted_domains` string[]
    - `document_type_id` string, uuid, nullable, required
    - `in_deletion_since` string, date-time, nullable, required
  - `last_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/typless/apis/typless-api.md) · [All operations](https://skmtc.dev/typless/apis/typless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typless/apis/typless-api/revisions/d614787a47ef?raw)