{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"API Fundamentals","description":"Fondo is the ground breaking open finance platform that lets you focus on what matters","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"api-fundamentals","__idx":0},"children":[{"$$mdtype":"Tag","name":"i","attributes":{"className":"fa-solid fa-gears"},"children":[]}," API Fundamentals"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It follows REST conventions with JSON-encoded requests and responses. All requests require ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["server-to-server OAuth 2.0 client credentials"]}," and are made over HTTPS. Requests can be sent to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sandbox"]}," – safe testing with no impact on live data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NPC"]}," (Non-Playable Character) – a test environment for web-onboarding user journeys. Uses test-BankID instead of real BankID for authentication."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Production"]}," – the live environment."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pagination","__idx":1},"children":["Pagination"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some list endpoints support cursor-based pagination with two query parameters:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start"]}]}," — a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortedId"]}," to begin from (inclusive — the item with this ID is included in the results). Omit on the first request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]}," — maximum number of results to return. Default is unlimited."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Omit both parameters to retrieve the full result set in one request. To paginate, pass the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortedId"]}," of the last item you received as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start"]},". Since ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start"]}," is inclusive, skip the first item of each subsequent page to avoid duplicates."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"real-time-updates","__idx":2},"children":["Real-time Updates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For near real-time updates, use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WebSocket subscriptions"]}," – keep a persistent connection to receive live events such as new orders or settlements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Journey callbacks"]}," – Fondo sends POST callbacks to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}," you provide when creating a journey, with status updates such as completion, cancellation, or errors."]}]}]},"headings":[{"value":"API Fundamentals","id":"api-fundamentals","depth":1},{"value":"Pagination","id":"pagination","depth":2},{"value":"Real-time Updates","id":"real-time-updates","depth":2}],"frontmatter":{"seo":{"title":"API Fundamentals"}},"lastModified":"2026-06-05T09:51:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/api-guide/api-fundamentals","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}