# Pleo

> Work with Pleo tag groups, tags, tax codes, accounts, vendors and accounting exports.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/pleo

## Actions

### Create tag

Create tag. Returns one response page; the connected account determines access.

**Inputs**

- GroupId (`groupId`, text, required): Group id.
- Archived (`archived`, true/false, required): This tag is not used anymore
- Code (`code`, text, required): External identifier of the Tag
- Name (`name`, text): User readable name that is used for the possible value within a tag group on an expense

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "archived": false,
      "code": "12345",
      "createdAt": "2023-08-23T03:11:48.000Z",
      "groupId": "example",
      "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
      "name": "Lunch allowance",
      "updatedAt": "2023-08-23T03:11:48.000Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create tag group

Create tag group. Returns one response page; the connected account determines access.

**Inputs**

- Company ID (`company_id`, text): Company id.
- Archived (`archived`, true/false, required): Archived.
- Code (`code`, text, required): Code.
- Metadata (`metadata`, object): Metadata.
- Name (`name`, text, required): Name.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "archived": false,
      "code": "5524f270-6c21-11ee-b962-0242ac120002",
      "companyId": "c04c7e9e-6c15-11ee-b962-0242ac120003",
      "createdAt": "2023-08-23T03:11:48.000Z",
      "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
      "metadata": {
        "externalExtraId": "f302f9ec-6c17-11ee-b962-0242ac120002"
      },
      "name": "Projects",
      "updatedAt": "2023-08-23T03:11:48.000Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create tax code

Create tax code. Returns one response page; the connected account determines access.

**Inputs**

- Archived (`archived`, true/false, required): Boolean flag used to archive or unarchive a category (when set to true, account is not visible or usable on the platform)
- Code (`code`, text): The accounting system's internal identifier of the tax code
- CompanyId (`companyId`, text, required): Company ID the tax code is being created/updated for
- IngoingTaxAccount (`ingoingTaxAccount`, text): Ingoing tax account usually used to account for reverse VAT
- Name (`name`, text, required): Name of the tax code
- OutgoingTaxAccount (`outgoingTaxAccount`, text): Outgoing tax account usually used to account for reverse VAT
- Rate (`rate`, number, required): Percentage rate applied for this tax code (This is represented in decimals and not the percentage. e.g. 20% tax rate would be 0.20)
- Type (`type`, text, required): Classification of this tax code. One of: `inclusive`, `exclusive`, `reverse`.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "accountingIntegrationSystem": "example",
      "archived": false,
      "code": "01",
      "companyId": "example",
      "createdAt": "2026-01-01T00:00:00Z",
      "id": "example",
      "ingoingTaxAccount": "example",
      "name": "Standardmoms (25 %)",
      "outgoingTaxAccount": "example",
      "rate": 1.0,
      "type": "inclusive",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Delete tag

Delete tag. Returns one response page; the connected account determines access.

**Inputs**

- TagId (`tagId`, text, required): Tag id.

**Outputs**: API response.

- `data` (null): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": null
}
```

### Delete tag group

Delete tag group. Returns one response page; the connected account determines access.

**Inputs**

- GroupId (`groupId`, text, required): Group id.

**Outputs**: API response.

- `data` (true/false): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": false,
  "has_more": false,
  "next_cursor": null
}
```

### Delete tax code

Delete tax code. Returns one response page; the connected account determines access.

**Inputs**

- TaxCodeId (`taxCodeId`, text, required): Taxcode id.

**Outputs**: API response.

- `data` (null): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": null
}
```

### Get account

Get account. Returns one response page; the connected account determines access.

**Inputs**

- AccountId (`accountId`, text, required): ID of the account to retrieve.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "archived": false,
      "code": "example",
      "companyId": "example",
      "externalId": "example",
      "id": "example",
      "metadata": {},
      "name": "example",
      "taxCodeExternalId": "example"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get export job

Get export job. Returns one response page; the connected account determines access.

**Inputs**

- JobId (`jobId`, text, required): Job id.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "companyId": "example",
      "completedAt": "2026-01-01T00:00:00Z",
      "createdAt": "2026-01-01T00:00:00Z",
      "createdBy": "example",
      "expiredAt": "2026-01-01T00:00:00Z",
      "expiresIn": 1,
      "failureReason": "example",
      "failureReasonType": "invalid_configuration",
      "id": "example",
      "isInteractive": false,
      "lastUpdatedAt": "2026-01-01T00:00:00Z",
      "numberOfItems": 1,
      "startedAt": "2026-01-01T00:00:00Z",
      "status": "pending",
      "targetSystem": "example",
      "vendorBasedBookkeeping": false
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get tag

Get tag. Returns one response page; the connected account determines access.

**Inputs**

- TagId (`tagId`, text, required): Tag id.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "archived": false,
      "code": "12345",
      "createdAt": "2023-08-23T03:11:48.000Z",
      "groupId": "example",
      "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
      "name": "Lunch allowance",
      "updatedAt": "2023-08-23T03:11:48.000Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get tag group

Get tag group. Returns one response page; the connected account determines access.

**Inputs**

- GroupId (`groupId`, text, required): Group id.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "archived": false,
      "code": "5524f270-6c21-11ee-b962-0242ac120002",
      "companyId": "c04c7e9e-6c15-11ee-b962-0242ac120003",
      "createdAt": "2023-08-23T03:11:48.000Z",
      "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
      "metadata": {
        "externalExtraId": "f302f9ec-6c17-11ee-b962-0242ac120002"
      },
      "name": "Projects",
      "updatedAt": "2023-08-23T03:11:48.000Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get tax code

Get tax code. Returns one response page; the connected account determines access.

**Inputs**

- TaxCodeId (`taxCodeId`, text, required): Taxcode id.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "accountingIntegrationSystem": "example",
      "archived": false,
      "code": "01",
      "companyId": "example",
      "createdAt": "2026-01-01T00:00:00Z",
      "id": "example",
      "ingoingTaxAccount": "example",
      "name": "Standardmoms (25 %)",
      "outgoingTaxAccount": "example",
      "rate": 1.0,
      "type": "inclusive",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get vendor

Get vendor. Returns one response page; the connected account determines access.

**Inputs**

- ID (`id`, text, required): Id.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "accountingSystem": "example",
      "code": "example",
      "companyId": "c082afd8-c1d2-46ee-8f56-1512638f0e67",
      "country": "DK",
      "createdAt": "2026-01-01T00:00:00Z",
      "defaultCurrency": "DKK",
      "externalId": "example",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Pleo",
      "registrationNumber": "example",
      "state": "DRAFT",
      "taxRegistrationNumber": "example",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List export items

List export items. Returns one response page; the connected account determines access.

**Inputs**

- Job ID (`job_id`, text): The Export Job ID in which the accounting entries have been included for export.
- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after]). At least 0.
- Limit (`limit`, number): The maximum amount of items to return. At least 0.
- Sorting keys (`sorting_keys`, list): The keys to sort the results by.
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List export job items

List export job items. Returns one response page; the connected account determines access.

**Inputs**

- JobId (`jobId`, text, required): Job id.
- Status (`status`, text): Enter a status to retrieve a list of export job items in the specified state. One of: `pending`, `in_progress`, `failed`, `successful`, `abandoned`.
- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after]). At least 0.
- Limit (`limit`, number): The maximum amount of items to return. At least 0.
- Sorting keys (`sorting_keys`, list): The keys to sort the results by.
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List export jobs

List export jobs. Returns one response page; the connected account determines access.

**Inputs**

- Company ID (`company_id`, text): Enter the company ID for which you want to retrieve the list of export jobs processed previously.
- Statuses (`statuses`, list): Fetch a list of jobs in specific states. One or more of: `pending`, `in_progress`, `failed`, `completed`, `completed_with_errors`.
- Target systems (`target_systems`, list): Restrict the returned export jobs to those recorded against any of the named target systems; the value is case-insensitive.
- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after]). At least 0.
- Limit (`limit`, number): The maximum amount of items to return. At least 0.
- Sorting keys (`sorting_keys`, list): The keys to sort the results by.
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List group tags

List group tags. Returns one response page; the connected account determines access.

**Inputs**

- GroupId (`groupId`, text, required): Group id.
- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset])
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset])
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after])
- Limit (`limit`, number): The maximum amount of items to return
- Sorting keys (`sorting_keys`, list): The keys to sort the results by
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.
- Include archived (`include_archived`, true/false): Include archived.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List tag groups

List tag groups. Returns one response page; the connected account determines access.

**Inputs**

- Company ID (`company_id`, text): Company id.
- Organization ID (`organization_id`, text): Organization id.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search accounts

Search accounts. Returns one response page; the connected account determines access.

**Inputs**

- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after]). At least 0.
- Limit (`limit`, number): The maximum amount of items to return. At least 0.
- Sorting keys (`sorting_keys`, list): The keys to sort the results by.
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.
- Archived (`archived`, true/false): Filter by archived status.
- Code (`code`, text): Search by code.
- Codes (`codes`, list): Search by a list of codes.
- CompanyId (`companyId`, text, required): Filter by company ID.
- ExcludeIfAssignedToCategory (`excludeIfAssignedToCategory`, true/false, required): Exclude bookkeeping accounts assigned to a bookkeeping category.
- ExcludeIfAssignedToContraAccount (`excludeIfAssignedToContraAccount`, true/false, required): Exclude bookkeeping accounts assigned to a contra account.
- ExternalId (`externalId`, text): Search by external id.
- IDS (`ids`, list): Filter by a list of account IDs.
- Name (`name`, text): Search by name.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search bookkeeping categories

Search bookkeeping categories. Returns one response page; the connected account determines access.

**Inputs**

- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after]). At least 0.
- Limit (`limit`, number): The maximum amount of items to return. At least 0.
- Sorting keys (`sorting_keys`, list): The keys to sort the results by.
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.
- AccountIds (`accountIds`, list): Filter by a list of bookkeeping account IDs.
- Archived (`archived`, true/false): Filter by archived status.
- CategoryGroupIds (`categoryGroupIds`, list): Filter by a list of bookkeeping category group IDs.
- CompanyId (`companyId`, text, required): Filter by company ID.
- IDS (`ids`, list): Filter by a list of bookkeeping category IDs.
- Name (`name`, text): Search by bookkeeping category name.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search bookkeeping groups

Search bookkeeping groups. Returns one response page; the connected account determines access.

**Inputs**

- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after]). At least 0.
- Limit (`limit`, number): The maximum amount of items to return. At least 0.
- Sorting keys (`sorting_keys`, list): The keys to sort the results by.
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.
- Archived (`archived`, true/false): Filter by archived status.
- CompanyId (`companyId`, text, required): Filter by company ID.
- IDS (`ids`, list): Filter by a list of bookkeeping category group IDs.
- Name (`name`, text): Search by name.
- Types (`types`, list): Filter by a list of bookkeeping category group types. One or more of: `ENTERTAINMENT`, `EQUIPMENT_AND_HARDWARE`, `MARKETING_AND_ADVERTISING`, `MEALS_AND_DRINKS`, `OFFICE_EXPENSES`, `PHONE_AND_INTERNET`, `SERVICES_AND_CONSULTANCY`, `SOFTWARE`, `SUPPLIES`, `TRAVEL`, `OTHER`, `NO_SUITABLE_CATEGORY`.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search tax codes

Search tax codes. Returns one response page; the connected account determines access.

**Inputs**

- Company ID (`company_id`, text): Company id.
- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset])
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset])
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after])
- Limit (`limit`, number): The maximum amount of items to return
- Sorting keys (`sorting_keys`, list): The keys to sort the results by
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.
- Archived (`archived`, true/false): If set to true will only return tax codes that have been archived, if set to false will only return tax codes that have not been archived. By default,both archived and non-archived tax codes will be returned.
- TaxCodeIds (`taxCodeIds`, list): Useful for fetching a list of tax codes given a specific list of IDs.
- Type (`type`, text): Classification of the tax codes to fetch. One of: `inclusive`, `exclusive`, `reverse`.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search vendors

Search vendors. Returns one response page; the connected account determines access.

**Inputs**

- Company ID (`company_id`, text, required): Company id.
- Before (`before`, text): Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After (`after`, text): Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset (`offset`, number): Offset of the page of data to return (cannot be used together with [before] or [after]).
- Limit (`limit`, number): The maximum amount of items to return.
- Sorting keys (`sorting_keys`, list): The keys to sort the results by.
- Sorting order (`sorting_order`, list): The order to sort the results by. Must be the same length as [sortingKeys]; one order per key. One or more of: `ASC`, `ASC_NULLS_FIRST`, `ASC_NULLS_LAST`, `DESC`, `DESC_NULLS_FIRST`, `DESC_NULLS_LAST`.
- AccountingSystems (`accountingSystems`, list): Only return Vendors linked to the given target ERP/accounting systems.
- Codes (`codes`, list): Only return Vendors with the given vendor codes.
- Countries (`countries`, list): Only return Vendors with the given country codes. One or more of: `UNDEFINED`, `AC`, `AD`, `AE`, `AF`, `AG`, `AI`, `AL`, `AM`, `AN`, and 262 more.
- ExternalIds (`externalIds`, list): Only return Vendors with the given vendor external ids.
- IDS (`ids`, list): Only return Vendors with the given Vendor Ids.
- Name (`name`, text): The name field represents the official name of the Vendor as it is recorded in the target ERP/accounting system. This name is used to uniquely identify the vendor within the accounting workflow and is visible to the Pleo bookkeeper.
- States (`states`, list): Only return Vendors with the given states. One or more of: `DRAFT`, `ACTIVE`, `ARCHIVED`.
- TaxRegistrationNumbers (`taxRegistrationNumbers`, list): Only return Vendors with the given Tax Registration Numbers.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "currentRequestPagination": {
        "after": "example",
        "before": "example",
        "limit": 1,
        "offset": 1,
        "parameters": {},
        "sortingKeys": [],
        "sortingOrder": []
      },
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Update tag

Update tag. Returns one response page; the connected account determines access.

**Inputs**

- TagId (`tagId`, text, required): Tag id.
- Archived (`archived`, true/false, required): This tag is not used anymore
- Code (`code`, text, required): External identifier of the Tag
- Name (`name`, text): User readable name that is used for the possible value within a tag group on an expense

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "archived": false,
      "code": "12345",
      "createdAt": "2023-08-23T03:11:48.000Z",
      "groupId": "example",
      "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
      "name": "Lunch allowance",
      "updatedAt": "2023-08-23T03:11:48.000Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Update tag group

Update tag group. Returns one response page; the connected account determines access.

**Inputs**

- GroupId (`groupId`, text, required): Group id.
- Archived (`archived`, true/false, required): Archived.
- Code (`code`, text, required): Code.
- Metadata (`metadata`, object, required): Metadata.
- Name (`name`, text, required): Name.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "archived": false,
      "code": "5524f270-6c21-11ee-b962-0242ac120002",
      "companyId": "c04c7e9e-6c15-11ee-b962-0242ac120003",
      "createdAt": "2023-08-23T03:11:48.000Z",
      "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
      "metadata": {
        "externalExtraId": "f302f9ec-6c17-11ee-b962-0242ac120002"
      },
      "name": "Projects",
      "updatedAt": "2023-08-23T03:11:48.000Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Update tax code

Update tax code. Returns one response page; the connected account determines access.

**Inputs**

- TaxCodeId (`taxCodeId`, text, required): Taxcode id.
- Archived (`archived`, true/false, required): Boolean flag used to archive or unarchive a category (when set to true, account is not visible or usable on the platform)
- Code (`code`, text): The accounting system's internal identifier of the tax code
- CompanyId (`companyId`, text, required): Company ID the tax code is being created/updated for
- IngoingTaxAccount (`ingoingTaxAccount`, text): Ingoing tax account usually used to account for reverse VAT
- Name (`name`, text, required): Name of the tax code
- OutgoingTaxAccount (`outgoingTaxAccount`, text): Outgoing tax account usually used to account for reverse VAT
- Rate (`rate`, number, required): Percentage rate applied for this tax code (This is represented in decimals and not the percentage. e.g. 20% tax rate would be 0.20)
- Type (`type`, text, required): Classification of this tax code. One of: `inclusive`, `exclusive`, `reverse`.

**Outputs**: API response.

- `data` (object): Data.
- `has_more` (true/false): Whether a continuation page is available.
- `next_cursor` (text): Continuation value, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": {
      "accountingIntegrationSystem": "example",
      "archived": false,
      "code": "01",
      "companyId": "example",
      "createdAt": "2026-01-01T00:00:00Z",
      "id": "example",
      "ingoingTaxAccount": "example",
      "name": "Standardmoms (25 %)",
      "outgoingTaxAccount": "example",
      "rate": 1.0,
      "type": "inclusive",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```
