---
title: "Portefeuille matchen · API-documentatie | Faillissement.app"
description: "Documentatie van de Faillissement.app API: authenticatie, scopes, herkomst, credits, fouten, endpoints en webhooks."
canonical_url: "https://faillissement.app/ontwikkelaars/docs/portfolio-match"
locale: nl
meta:
  "og:description": "Documentatie van de Faillissement.app API: authenticatie, scopes, herkomst, credits, fouten, endpoints en webhooks."
  "og:title": "Portefeuille matchen · API-documentatie | Faillissement.app"
---

**API-documentatie**

**v1.0.0**

[openapi.json](https://faillissement.app/api/v1/openapi.json) [Prijzen](https://faillissement.app/ontwikkelaars) [API-sleutels](https://faillissement.app/account/api)

# Portefeuille matchen

**POST**`**/api/v1/portfolio/match**`

**scope: portfolio:match****0,1 credit per KvK-nummer**

Controleer welke KvK-nummers bij een openbaar faillissement horen. Alleen exacte KvK-matches; de nummers worden niet opgeslagen.

### **Body**

Body

| **Naam** | **Type** | **Omschrijving** |
| --- | --- | --- |
| `kvk_numbers`verplicht | string\[] | KvK-nummers van 8 cijfers |

### **Antwoord · HTTP 200**

### **Antwoord · HTTP 200**

Antwoord · HTTP 200

| **Naam** | **Type** | **Omschrijving** |
| --- | --- | --- |
| `data`verplicht | object\[] | |
| `data[].kvk_number`verplicht | string | |
| `data[].matched`verplicht | string | |
| `data[].cases`verplicht | string | |
| `meta`verplicht | object | |
| `meta.numbers`verplicht | integer | |
| `meta.matched`verplicht | integer | |
| `meta.credits`verplicht | number | |

### **Antwoord · HTTP 422**

Validation error

### **Antwoord · HTTP 422**

Antwoord · HTTP 422

| **Naam** | **Type** | **Omschrijving** |
| --- | --- | --- |
| `error`verplicht | object | |
| `error.code`verplicht | string | Stable error code, for example not\_found or validation\_failed |
| `error.message`verplicht | string | Human-readable explanation |
| `error.details` | object | Extra information, such as the fields that failed validation |

De velden van het antwoord staan in openapi.json. Hoe elke waarde met bron is opgebouwd, leest u bij [Gegevens en brondocumenten](https://faillissement.app/ontwikkelaars/docs/provenance)