Getting Started with the PAIR Finance API
The PAIR Finance API lets you create and manage case files, report payments and discounts, and subscribe to webhook events. This page covers everything you need before your first request. For endpoint details, sample request bodies and field descriptions, see the API Reference.
The basics
| Base path | /api/v2 — see Endpoints for the host to use |
| Transport | HTTPS only |
| Content type | Send Content-Type: application/json on every request. Anything else is rejected with 406 Not Acceptable before authentication runs. |
| Authentication | Bearer token in the Authorization: Bearer <token> header. Your PAIR Finance Integration Team issues your credentials. |
| IP whitelisting | Optional, configured per company by your Integration Team. Where it is active, requests from any other IP are rejected with 401 Unauthorized. |
Endpoints
Build and test against the demo environment first:
https://demo.pairfinance.com/api/v2/Once testing is complete, switch to the production host for the law under which the contract with the consumer was concluded:
| Governing law | Production endpoint |
|---|---|
| Germany, France, Spain, Portugal, Italy | https://app.pairfinance.com/api/v2/ |
| Austria | https://at.pairfinance.com/api/v2/ |
| Switzerland | https://app.pairfinance.ch/api/v2/ |
| Belgium, Netherlands, Luxembourg | https://app.pairfinance.nl/api/v2/ |
| Sweden | https://app.pairfinance.se/api/v2/ |
| Norway | https://app.pairfinance.no/api/v2/ |
| Poland, Romania | https://app.pairfinance.pl/api/v2/ |
If you are unsure which endpoint applies to your case files, ask your Integration Team contact.
Updated about 1 month ago
What’s Next
Did this page help you?