Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.pleo.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Multi-Currency in Export API

contraAccount object is returned in the endpoint response of GET https://external.pleo.io/v3/export-items, when the expense is any of the following types and it impacts the account balance:
  • card_purchase
  • fee
  • cashback
  • refund
  • chargeback
  • direct_reimbursement
  • invoice_payment
  • card_invoice
  • atm_withdrawal
  • personal_spend
  • wallet_topup
  • wallet_unload

​
Frequently Asked Questions

No, the version 2 GET Get Export Items endpoint returns 400: Bad Request error and displays the following:
{
  "type": "UNSUPPORTED_API_VERSION",
  "message": "Upgrade to Export API v3 or higher: The API version you are trying to access does not support multi-currency wallets."
}
This ensures accurate bookkeeping, as when multi-currency configuration is enabled, the integration must access the Export API version 3 for the correct export of accounting entries from Pleo to the external ERP/accounting system.
Yes. Even if a customer has not activated multi-currency on Pleo, contra account, if configured, will be sent in V3 of GET Get Export Items endpoint. If contra accounts are not fully configured, then the endpoint will return status code 400 along with the following response body:
{
  "type": "MISSING_CONTRA_ACCOUNTS",
  "message": "Make sure you don't export EUR, USD expenses before you set your contra accounts."
}
This message will be based on export item currencies for which there is no contra account set.
You can configure the integration to either fail the corresponding export job or wait until it expires.
Note: An export job expires after one hour since its last update (lastUpdatedAt).

​
Export API Version 3 URLs

Production: https://external.pleo.io
Staging: https://external.staging.pleo.io
Note: In the endpoint specific paths, use v3 instead of v2. For example, POST https://external.pleo.io/v3/export-job-events.