Getting Started with the PAIR Finance API

This document outlines the current public PAIR Finance API (last updated: April 7th, 2025). It is available using HTTPS only at app.pairfinance.com/api/v2.

To access further explanations and sample bodies with descriptions, please click on the arrow next to ‘Guides’ in the top left-hand corner and select ‘API Reference’ from the drop-down menu that opens.

  • Authentication: The PAIR Finance API uses Basic Authorization. Please use the API credentials assigned to you by your PAIR Finance Integration-Team to authenticate your requests.
  • Error States: The common HTTP Response Status Codes are used.
  • HTTPS: The API is only available over HTTPS.
  • Time zones / dates: All timestamps are formatted as ISO8601 with timezone information. For API calls that allow for a timestamp to be specified, we use that exact timestamp. These timestamps look like this: 2024-05-02T12:58:54+00:00.

Testing:

For testing before go-live please use the demo endpoint https://demo.pairfinance.com/api/v2/ shown in the method descriptions under 'API Reference'.

After testing please use production endpoint https://app.pairfinance.com/api/v2/ if contract with consumer was concluded under German law. Same endpoint should be used for FR, ES, & PT.

Please use the following further production endpoints:


What’s Next