API-toegang Upswitch Index
Hoe anonieme teaser-toegang, gratis-accounttoegang tot de volledige index en geauthenticeerde connectortoegang verschillen op de Upswitch Index-API.
Openbare benchmark-API
De Upswitch Index-API houdt anonieme toegang teaser-veilig: openbare requests kunnen de benchmarklaag verkennen, terwijl ingelogde gratis accounts de volledige databank met EV/EBITDA-, EV/omzet- en K/W-multiples ontgrendelen. Historische vintages, conceptvoorbeelden en audit-grade exports blijven betaalde/geauthenticeerde lagen.
GET /api/benchmarks/v1/index
Queryparameters sluiten aan bij de index-UI: country_code (ISO, bijv. BE, NL, GB, DE) beperkt rijen tot die markt (buiten Benelux: regiobrede GLOBAL-rijen plus dat land). Optioneel business_type_id geeft de exacte gepubliceerde activiteits-slice die bedrijfstypepagina's gebruiken. Optioneel benelux_scope=aggregate zonder country_code geeft alleen Benelux-brede aggregaatrijden (null country_code) voor integraties — de openbare index-UI filtert per land. Optioneel metric_name (exact, bijv. EV_EBITDA); optioneel min_confidence (standaard 0; gebruik bijv. 0,3 om te filteren, komma of punt); as_of en snapshot_id zijn beschikbaar voor Pro-vintages; optioneel locale (en of nl) voor de bedrijfstype-titels per rij (standaard en; valt terug op canonieke titels als een vertaling ontbreekt). Anonieme toegang blijft teaser-veilig; ingelogde gratis accounts ontgrendelen de volledige databank; draft_preview vereist een Pro-sessie of API-token.
Beschikbare endpoints
Alle endpoints zijn read-only GET-verzoeken. Anonieme toegang blijft teaser-veilig; ingelogde gratis accounts ontgrendelen de volledige databank; Pro-endpoints vereisen een persoonlijk toegangstoken of browsersessie.
GET /api/benchmarks/v1/index — Anonieme teaser-rijen, of de volledige databank voor ingelogde gebruikers; voeg include_market_data=1 toe voor marktcontext per land (draft_preview vereist Pro-sessie of API-token)
GET /api/benchmarks/v1/snapshots — Gepubliceerde vintagelijst (openbaar; Pro ziet alle vintages)
GET /api/benchmarks/v1/audit — Audit-JSON per rij (Pro-sessie of API-token; brondetails geredacteerd)
GET /api/benchmarks/v1/audit/pdf — Audit-PDF werkdocument (Pro-sessie of API-token)
GET /api/benchmarks/v1/accuracy — Backtestnauwkeurigheid (openbaar)
GET /api/benchmarks/v1/diff?from=&to= — Verschil tussen twee gepubliceerde vintages (openbaar; Pro voor niet-actieve 'from' snapshot)
GET /api/benchmarks/v1/sources — Benoemde sourcing-registry per land (openbaar; IP-rate-limited; dezelfde data als /markets/sources)
GET /api/benchmarks/v1/country-summary?country_code= — Aantallen gepubliceerde bedrijfstypes per country_basis voor de actieve vintage (openbaar; gelijk aan de evidence-voetnoot op de landpagina)
GET /api/benchmarks/v1/market-data — Landmacro, valuta, belasting, risicovrije rente en landrisico-inputs voor alle gepubliceerde markten (openbaar; country_code=BE voor één markt, countries=BE,NL,DE voor een begrensde set, format=csv voor Excel-export)
GET /api/benchmarks/v1/context — Modelklare bundel met multiples plus ingebedde marktdata per land in één JSON-respons (dezelfde filters als /index; voeg format=csv toe voor een vlakke Excel-export)
GET /api/benchmarks/v1/openapi.json — Versiebeheerde OpenAPI 3.1-spec voor deze API (openbaar)
OpenAPI 3.1-spec
Het volledige machinecontract voor deze API wordt gepubliceerd als OpenAPI 3.1 op /api/benchmarks/v1/openapi.json. Zet de spec in Postman, Insomnia, Stoplight of je SDK-generator. De spec is de citeerbare referentie voor M&A-tooling — Excel-modellen, dealmappen, fairness opinion-werkpapieren — en is de canonieke registratie van welke velden openbaar zijn vs. achter de Pro-grens vallen.
Open de OpenAPI-spec →Wat de openbare API niet blootgeeft
Elke indexrij kan een grof veld `source_alignment` bevatten (`independent_confirmation`, `single_source` of `not_disclosed`) — alleen een vertrouwenssignaal, zonder aanbiedersnamen, ruwe evidence-aantallen of blendgewichten. Openbare rijen bevatten ook een begrensd `provenance`-object (geselecteerde triagelaag, actualiteitsband, optionele NACE-wandeling) en `evidence_class` (`observed` / `hybrid` / `inferred`); ze geven nog steeds geen `source_mix`, citaties, chain-of-thought of andere ruwe attributie. Het product is de benchmarkstandaard zelf, geen dataleveranciers-openleggingsfeed.
Ontwikkelaarstoegang (Pro API-tokens)
Pro-gebruikers kunnen persoonlijke toegangstokens genereren vanuit hun accountinstellingen. Tokens bieden dezelfde rechten als een browsersessie: historische vintages, conceptweergave, audit-JSON en audit-PDF’s.
curl -H "Authorization: Bearer upat_..." /api/benchmarks/v1/index?draft_preview=1
Alternatief: curl -H "x-api-key: upat_..." /api/benchmarks/v1/index
Tokens hebben een limiet van 600 verzoeken per minuut (tegen 120/min per IP voor anonieme toegang). Maak en trek tokens in onder Instellingen → API-toegang in je Upswitch-dashboard.
Ontwikkelaarsinformatie
Alle responses bevatten X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset headers zodat je je quota programmatisch kunt bijhouden. Bij overschrijding retourneert de API 429 met een Retry-After header.
Alle benchmark-endpoints ondersteunen CORS (Access-Control-Allow-Origin: *) en verwerken OPTIONS-preflightverzoeken, zodat tokens ook vanuit browsergebaseerde applicaties gebruikt kunnen worden.
Geauthenticeerde connectortoegang
Betaalde integraties die rijkere multiplestoegang, automatisering of provenance nodig hebben, horen op geauthenticeerde API-routes met contractuele toegangscontrole. Zo blijft de openbare benchmarklaag helder én worden institutionele workflows ondersteund.
Voorbeelden: /api/benchmarks/v1/current, /history, /coverage
Upswitch.app
Volledig waarderingsplatform — Upswitch
Deze databank is de publieke benchmarklaag. Upswitch is het volledige platform: bedrijfsspecifieke waarderingen, klantrapportages, adviseurswerkflow en API-toegang voor teams. Gratis accounts werken op beide.