---
title: "Veilingen · 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/auctions-index"
locale: nl
meta:
  "og:description": "Documentatie van de Faillissement.app API: authenticatie, scopes, herkomst, credits, fouten, endpoints en webhooks."
  "og:title": "Veilingen · 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)

# Veilingen

**GET**`**/api/v1/auctions**`

**scope: auctions:read****1 credits**

Veilingen uit faillissementen, met de koppeling aan het dossier en de herkomst.

### **Queryparameters**

Queryparameters

| **Naam** | **Type** | **Omschrijving** |
| --- | --- | --- |
| `q` | string \| null | Zoektekst |
| `closing` | enum \| null | today · 7d · 30d · null |
| `category[]` | enum\[] | construction\_machinery · vehicles · tools · stock · office\_it · hospitality · real\_estate · other |
| `provider[]` | string\[] | |
| `linked` | boolean \| null | |
| `sector` | enum \| null | A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · null |
| `curator` | string \| null | |
| `postcode` | string \| null | |
| `radius` | enum \| null | 10 · 25 · 50 · 100 · null |
| `sort` | enum \| null | Sortering closing · distance · newest · null |
| `page` | integer \| null | Paginanummer |

### **Antwoord · HTTP 200**

### **Antwoord · HTTP 200**

Antwoord · HTTP 200

| **Naam** | **Type** | **Omschrijving** |
| --- | --- | --- |
| `data`verplicht | mixed\[] | |
| `meta`verplicht | object | |
| `meta.total`verplicht | integer | |
| `meta.page`verplicht | integer | |
| `meta.last_page`verplicht | integer | |

### **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)