Pleo
App · 25 actions
Work with Pleo tag groups, tags, tax codes, accounts, vendors and accounting exports.
Actions
| Action | What it does |
|---|---|
| Create tag | Create tag. |
| Create tag group | Create tag group. |
| Create tax code | Create tax code. |
| Delete tag | Delete tag. |
| Delete tag group | Delete tag group. |
| Delete tax code | Delete tax code. |
| Get account | Get account. |
| Get export job | Get export job. |
| Get tag | Get tag. |
| Get tag group | Get tag group. |
| Get tax code | Get tax code. |
| Get vendor | Get vendor. |
| List export items | List export items. |
| List export job items | List export job items. |
| List export jobs | List export jobs. |
| List group tags | List group tags. |
| List tag groups | List tag groups. |
| Search accounts | Search accounts. |
| Search bookkeeping categories | Search bookkeeping categories. |
| Search bookkeeping groups | Search bookkeeping groups. |
| Search tax codes | Search tax codes. |
| Search vendors | Search vendors. |
| Update tag | Update tag. |
| Update tag group | Update tag group. |
| Update tax code | Update tax code. |
Create tag
Create tag. Returns one response page; the connected account determines access.
Inputs
- GroupId
groupIdtextRequired - Group id.
- Archived
archivedtrue/falseRequired - This tag is not used anymore
- Code
codetextRequired - External identifier of the Tag
- Name
nametext - User readable name that is used for the possible value within a tag group on an expense
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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_idtext - Company id.
- Archived
archivedtrue/falseRequired - Archived.
- Code
codetextRequired - Code.
- Metadata
metadataobject - Metadata.
- Name
nametextRequired - Name.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
archivedtrue/falseRequired - Boolean flag used to archive or unarchive a category (when set to true, account is not visible or usable on the platform)
- Code
codetext - The accounting system's internal identifier of the tax code
- CompanyId
companyIdtextRequired - Company ID the tax code is being created/updated for
- IngoingTaxAccount
ingoingTaxAccounttext - Ingoing tax account usually used to account for reverse VAT
- Name
nametextRequired - Name of the tax code
- OutgoingTaxAccount
outgoingTaxAccounttext - Outgoing tax account usually used to account for reverse VAT
- Rate
ratenumberRequired - 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
typetextRequired - Classification of this tax codeOne of:
inclusive,exclusive,reverse.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
tagIdtextRequired - Tag id.
Outputs
API response.
datanull- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
groupIdtextRequired - Group id.
Outputs
API response.
datatrue/false- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
taxCodeIdtextRequired - Taxcode id.
Outputs
API response.
datanull- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"data": null,
"has_more": false,
"next_cursor": null
}Get account
Get account. Returns one response page; the connected account determines access.
Inputs
- AccountId
accountIdtextRequired - ID of the account to retrieve.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
jobIdtextRequired - Job id.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
tagIdtextRequired - Tag id.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
groupIdtextRequired - Group id.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
taxCodeIdtextRequired - Taxcode id.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
idtextRequired - Id.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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_idtext - The Export Job ID in which the accounting entries have been included for export.
- Before
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
- Limit
limitnumber - The maximum amount of items to return.At least 0.
- Sorting keys
sorting_keyslist - The keys to sort the results by.
- Sorting order
sorting_orderlist - 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.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
jobIdtextRequired - Job id.
- Status
statustext - Enter a status to retrieve a list of export job items in the specified state.One of:
pending,in_progress,failed,successful,abandoned. - Before
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
- Limit
limitnumber - The maximum amount of items to return.At least 0.
- Sorting keys
sorting_keyslist - The keys to sort the results by.
- Sorting order
sorting_orderlist - 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.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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_idtext - Enter the company ID for which you want to retrieve the list of export jobs processed previously.
- Statuses
statuseslist - Fetch a list of jobs in specific states.One or more of:
pending,in_progress,failed,completed,completed_with_errors. - Target systems
target_systemslist - Restrict the returned export jobs to those recorded against any of the named target systems; the value is case-insensitive.
- Before
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
- Limit
limitnumber - The maximum amount of items to return.At least 0.
- Sorting keys
sorting_keyslist - The keys to sort the results by.
- Sorting order
sorting_orderlist - 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.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
groupIdtextRequired - Group id.
- Before
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset])
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset])
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after])
- Limit
limitnumber - The maximum amount of items to return
- Sorting keys
sorting_keyslist - The keys to sort the results by
- Sorting order
sorting_orderlist - The order to sort the results by. Must be the same length as [sortingKeys]; one order per keyOne or more of:
ASC,ASC_NULLS_FIRST,ASC_NULLS_LAST,DESC,DESC_NULLS_FIRST,DESC_NULLS_LAST. - Include archived
include_archivedtrue/false - Include archived.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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_idtext - Company id.
- Organization ID
organization_idtext - Organization id.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"data": {
"data": []
},
"has_more": false,
"next_cursor": null
}Search accounts
Search accounts. Returns one response page; the connected account determines access.
Inputs
- Before
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
- Limit
limitnumber - The maximum amount of items to return.At least 0.
- Sorting keys
sorting_keyslist - The keys to sort the results by.
- Sorting order
sorting_orderlist - 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
archivedtrue/false - Filter by archived status.
- Code
codetext - Search by code.
- Codes
codeslist - Search by a list of codes.
- CompanyId
companyIdtextRequired - Filter by company ID.
- ExcludeIfAssignedToCategory
excludeIfAssignedToCategorytrue/falseRequired - Exclude bookkeeping accounts assigned to a bookkeeping category.
- ExcludeIfAssignedToContraAccount
excludeIfAssignedToContraAccounttrue/falseRequired - Exclude bookkeeping accounts assigned to a contra account.
- ExternalId
externalIdtext - Search by external id.
- IDS
idslist - Filter by a list of account IDs.
- Name
nametext - Search by name.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
- Limit
limitnumber - The maximum amount of items to return.At least 0.
- Sorting keys
sorting_keyslist - The keys to sort the results by.
- Sorting order
sorting_orderlist - 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
accountIdslist - Filter by a list of bookkeeping account IDs.
- Archived
archivedtrue/false - Filter by archived status.
- CategoryGroupIds
categoryGroupIdslist - Filter by a list of bookkeeping category group IDs.
- CompanyId
companyIdtextRequired - Filter by company ID.
- IDS
idslist - Filter by a list of bookkeeping category IDs.
- Name
nametext - Search by bookkeeping category name.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
- Limit
limitnumber - The maximum amount of items to return.At least 0.
- Sorting keys
sorting_keyslist - The keys to sort the results by.
- Sorting order
sorting_orderlist - 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
archivedtrue/false - Filter by archived status.
- CompanyId
companyIdtextRequired - Filter by company ID.
- IDS
idslist - Filter by a list of bookkeeping category group IDs.
- Name
nametext - Search by name.
- Types
typeslist - 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.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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_idtext - Company id.
- Before
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset])
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset])
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after])
- Limit
limitnumber - The maximum amount of items to return
- Sorting keys
sorting_keyslist - The keys to sort the results by
- Sorting order
sorting_orderlist - The order to sort the results by. Must be the same length as [sortingKeys]; one order per keyOne or more of:
ASC,ASC_NULLS_FIRST,ASC_NULLS_LAST,DESC,DESC_NULLS_FIRST,DESC_NULLS_LAST. - Archived
archivedtrue/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
taxCodeIdslist - Useful for fetching a list of tax codes given a specific list of IDs.
- Type
typetext - Classification of the tax codes to fetchOne of:
inclusive,exclusive,reverse.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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_idtextRequired - Company id.
- Before
beforetext - Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
- After
aftertext - Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
- Offset
offsetnumber - Offset of the page of data to return (cannot be used together with [before] or [after]).
- Limit
limitnumber - The maximum amount of items to return.
- Sorting keys
sorting_keyslist - The keys to sort the results by.
- Sorting order
sorting_orderlist - 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
accountingSystemslist - Only return Vendors linked to the given target ERP/accounting systems.
- Codes
codeslist - Only return Vendors with the given vendor codes.
- Countries
countrieslist - 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
externalIdslist - Only return Vendors with the given vendor external ids.
- IDS
idslist - Only return Vendors with the given Vendor Ids.
- Name
nametext - 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
stateslist - Only return Vendors with the given states.One or more of:
DRAFT,ACTIVE,ARCHIVED. - TaxRegistrationNumbers
taxRegistrationNumberslist - Only return Vendors with the given Tax Registration Numbers.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
tagIdtextRequired - Tag id.
- Archived
archivedtrue/falseRequired - This tag is not used anymore
- Code
codetextRequired - External identifier of the Tag
- Name
nametext - User readable name that is used for the possible value within a tag group on an expense
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
groupIdtextRequired - Group id.
- Archived
archivedtrue/falseRequired - Archived.
- Code
codetextRequired - Code.
- Metadata
metadataobjectRequired - Metadata.
- Name
nametextRequired - Name.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
taxCodeIdtextRequired - Taxcode id.
- Archived
archivedtrue/falseRequired - Boolean flag used to archive or unarchive a category (when set to true, account is not visible or usable on the platform)
- Code
codetext - The accounting system's internal identifier of the tax code
- CompanyId
companyIdtextRequired - Company ID the tax code is being created/updated for
- IngoingTaxAccount
ingoingTaxAccounttext - Ingoing tax account usually used to account for reverse VAT
- Name
nametextRequired - Name of the tax code
- OutgoingTaxAccount
outgoingTaxAccounttext - Outgoing tax account usually used to account for reverse VAT
- Rate
ratenumberRequired - 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
typetextRequired - Classification of this tax codeOne of:
inclusive,exclusive,reverse.
Outputs
API response.
dataobject- Data.
has_moretrue/false- Whether a continuation page is available.
next_cursortext- Continuation value, when supplied by the service.
Example output
{
"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
}