Pleo

App · 25 actions

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

Actions

ActionWhat it does
Create tagCreate tag.
Create tag groupCreate tag group.
Create tax codeCreate tax code.
Delete tagDelete tag.
Delete tag groupDelete tag group.
Delete tax codeDelete tax code.
Get accountGet account.
Get export jobGet export job.
Get tagGet tag.
Get tag groupGet tag group.
Get tax codeGet tax code.
Get vendorGet vendor.
List export itemsList export items.
List export job itemsList export job items.
List export jobsList export jobs.
List group tagsList group tags.
List tag groupsList tag groups.
Search accountsSearch accounts.
Search bookkeeping categoriesSearch bookkeeping categories.
Search bookkeeping groupsSearch bookkeeping groups.
Search tax codesSearch tax codes.
Search vendorsSearch vendors.
Update tagUpdate tag.
Update tag groupUpdate tag group.
Update tax codeUpdate tax code.

Create tag

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

Inputs

GroupIdgroupIdtextRequired
Group id.
Archivedarchivedtrue/falseRequired
This tag is not used anymore
CodecodetextRequired
External identifier of the Tag
Namenametext
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 IDcompany_idtext
Company id.
Archivedarchivedtrue/falseRequired
Archived.
CodecodetextRequired
Code.
Metadatametadataobject
Metadata.
NamenametextRequired
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

Archivedarchivedtrue/falseRequired
Boolean flag used to archive or unarchive a category (when set to true, account is not visible or usable on the platform)
Codecodetext
The accounting system's internal identifier of the tax code
CompanyIdcompanyIdtextRequired
Company ID the tax code is being created/updated for
IngoingTaxAccountingoingTaxAccounttext
Ingoing tax account usually used to account for reverse VAT
NamenametextRequired
Name of the tax code
OutgoingTaxAccountoutgoingTaxAccounttext
Outgoing tax account usually used to account for reverse VAT
RateratenumberRequired
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)
TypetypetextRequired
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

TagIdtagIdtextRequired
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

GroupIdgroupIdtextRequired
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

TaxCodeIdtaxCodeIdtextRequired
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

AccountIdaccountIdtextRequired
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

JobIdjobIdtextRequired
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

TagIdtagIdtextRequired
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

GroupIdgroupIdtextRequired
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

TaxCodeIdtaxCodeIdtextRequired
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

IDidtextRequired
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 IDjob_idtext
The Export Job ID in which the accounting entries have been included for export.
Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
Limitlimitnumber
The maximum amount of items to return.At least 0.
Sorting keyssorting_keyslist
The keys to sort the results by.
Sorting ordersorting_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

JobIdjobIdtextRequired
Job id.
Statusstatustext
Enter a status to retrieve a list of export job items in the specified state.One of: pending, in_progress, failed, successful, abandoned.
Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
Limitlimitnumber
The maximum amount of items to return.At least 0.
Sorting keyssorting_keyslist
The keys to sort the results by.
Sorting ordersorting_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 IDcompany_idtext
Enter the company ID for which you want to retrieve the list of export jobs processed previously.
Statusesstatuseslist
Fetch a list of jobs in specific states.One or more of: pending, in_progress, failed, completed, completed_with_errors.
Target systemstarget_systemslist
Restrict the returned export jobs to those recorded against any of the named target systems; the value is case-insensitive.
Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
Limitlimitnumber
The maximum amount of items to return.At least 0.
Sorting keyssorting_keyslist
The keys to sort the results by.
Sorting ordersorting_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

GroupIdgroupIdtextRequired
Group id.
Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset])
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset])
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after])
Limitlimitnumber
The maximum amount of items to return
Sorting keyssorting_keyslist
The keys to sort the results by
Sorting ordersorting_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 archivedinclude_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 IDcompany_idtext
Company id.
Organization IDorganization_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

Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
Limitlimitnumber
The maximum amount of items to return.At least 0.
Sorting keyssorting_keyslist
The keys to sort the results by.
Sorting ordersorting_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.
Archivedarchivedtrue/false
Filter by archived status.
Codecodetext
Search by code.
Codescodeslist
Search by a list of codes.
CompanyIdcompanyIdtextRequired
Filter by company ID.
ExcludeIfAssignedToCategoryexcludeIfAssignedToCategorytrue/falseRequired
Exclude bookkeeping accounts assigned to a bookkeeping category.
ExcludeIfAssignedToContraAccountexcludeIfAssignedToContraAccounttrue/falseRequired
Exclude bookkeeping accounts assigned to a contra account.
ExternalIdexternalIdtext
Search by external id.
IDSidslist
Filter by a list of account IDs.
Namenametext
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

Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
Limitlimitnumber
The maximum amount of items to return.At least 0.
Sorting keyssorting_keyslist
The keys to sort the results by.
Sorting ordersorting_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.
AccountIdsaccountIdslist
Filter by a list of bookkeeping account IDs.
Archivedarchivedtrue/false
Filter by archived status.
CategoryGroupIdscategoryGroupIdslist
Filter by a list of bookkeeping category group IDs.
CompanyIdcompanyIdtextRequired
Filter by company ID.
IDSidslist
Filter by a list of bookkeeping category IDs.
Namenametext
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

Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after]).At least 0.
Limitlimitnumber
The maximum amount of items to return.At least 0.
Sorting keyssorting_keyslist
The keys to sort the results by.
Sorting ordersorting_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.
Archivedarchivedtrue/false
Filter by archived status.
CompanyIdcompanyIdtextRequired
Filter by company ID.
IDSidslist
Filter by a list of bookkeeping category group IDs.
Namenametext
Search by name.
Typestypeslist
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 IDcompany_idtext
Company id.
Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset])
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset])
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after])
Limitlimitnumber
The maximum amount of items to return
Sorting keyssorting_keyslist
The keys to sort the results by
Sorting ordersorting_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.
Archivedarchivedtrue/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.
TaxCodeIdstaxCodeIdslist
Useful for fetching a list of tax codes given a specific list of IDs.
Typetypetext
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 IDcompany_idtextRequired
Company id.
Beforebeforetext
Lower bound of the page of data to return (cannot be used together with [after] or [offset]).
Afteraftertext
Upper bound of the page of data to return (cannot be used together with [before] or [offset]).
Offsetoffsetnumber
Offset of the page of data to return (cannot be used together with [before] or [after]).
Limitlimitnumber
The maximum amount of items to return.
Sorting keyssorting_keyslist
The keys to sort the results by.
Sorting ordersorting_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.
AccountingSystemsaccountingSystemslist
Only return Vendors linked to the given target ERP/accounting systems.
Codescodeslist
Only return Vendors with the given vendor codes.
Countriescountrieslist
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.
ExternalIdsexternalIdslist
Only return Vendors with the given vendor external ids.
IDSidslist
Only return Vendors with the given Vendor Ids.
Namenametext
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.
Statesstateslist
Only return Vendors with the given states.One or more of: DRAFT, ACTIVE, ARCHIVED.
TaxRegistrationNumberstaxRegistrationNumberslist
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

TagIdtagIdtextRequired
Tag id.
Archivedarchivedtrue/falseRequired
This tag is not used anymore
CodecodetextRequired
External identifier of the Tag
Namenametext
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

GroupIdgroupIdtextRequired
Group id.
Archivedarchivedtrue/falseRequired
Archived.
CodecodetextRequired
Code.
MetadatametadataobjectRequired
Metadata.
NamenametextRequired
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

TaxCodeIdtaxCodeIdtextRequired
Taxcode id.
Archivedarchivedtrue/falseRequired
Boolean flag used to archive or unarchive a category (when set to true, account is not visible or usable on the platform)
Codecodetext
The accounting system's internal identifier of the tax code
CompanyIdcompanyIdtextRequired
Company ID the tax code is being created/updated for
IngoingTaxAccountingoingTaxAccounttext
Ingoing tax account usually used to account for reverse VAT
NamenametextRequired
Name of the tax code
OutgoingTaxAccountoutgoingTaxAccounttext
Outgoing tax account usually used to account for reverse VAT
RateratenumberRequired
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)
TypetypetextRequired
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
}

On this page