These API docs are under construction and prone to change.

Endpoints

The Fyndera API provides endpoints for accessing legislation and regulatory documents. All endpoints require authentication via API key.

GET /legislation

Retrieve legislation documents based on specified criteria.

Request

# Example 1: Specific dates (rarely used - prefer date ranges)
curl -X GET "https://api.fyndera.be/v1/legislation?publicationDate=2024-01-01&documentTopic=Income Tax&documentTopic=VAT&documentType=Legislation&documentType=Ruling&documentSource=Fisconet&documentSource=Vlabel" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Example 2: Date range (recommended approach)
curl -X GET "https://api.fyndera.be/v1/legislation?publicationDateFrom=2024-01-01&publicationDateTo=2024-12-31&documentTopic=Income Tax&documentType=Legislation" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

url = 'https://api.fyndera.be/v1/legislation'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

# Specific dates (rarely used - prefer date ranges)
params = {
    'publicationDate': ['2024-01-01', '2024-01-15'],
    'documentTopic': ['Income Tax', 'VAT'],
    'documentType': ['Legislation', 'Ruling'],
    'documentSource': ['Fisconet', 'Vlabel']
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

# Date range (recommended approach)
range_params = {
    'publicationDateFrom': '2024-01-01',
    'publicationDateTo': '2024-12-31',
    'documentTopic': ['Income Tax'],
    'documentType': ['Legislation']
}

range_response = requests.get(url, headers=headers, params=range_params)
range_data = range_response.json()

Query Parameters

All parameters are optional and can accept multiple values by repeating the parameter name in the URL.

Parameter	Type	Description	Example Values
`publicationDate`	`string[]`	Filter by publication date(s)	`2024-01-01`, `2024-01-15`
`publicationDateFrom`	`string`	Start date for date range filter	`2024-01-01`
`publicationDateTo`	`string`	End date for date range filter	`2024-12-31`
`documentTopic`	`string[]`	Filter by document topic(s)	`Income Tax`, `VAT`
`documentType`	`string[]`	Filter by document type(s)	`Legislation`, `Ruling`
`documentSource`	`string[]`	Filter by document source(s)	`Fisconet`, `Vlabel`

Multiple Values

To pass multiple values for the same parameter, repeat the parameter name in the URL:

?documentTopic=VAT&documentTopic=Income_Tax&documentTopic=Customs

This is equivalent to passing an array: ["VAT", "Income Tax", "Customs"] Note: Multiple publicationDate values are rarely used as they represent “documents published on EITHER date”. For most use cases, use publicationDateFrom and publicationDateTo for date ranges instead.

Parameter Values

publicationDate

Date format: YYYY-MM-DD

Accepts specific dates
Multiple dates can be provided as an array
Use publicationDateFrom and publicationDateTo for date ranges

publicationDateFrom & publicationDateTo

Date format: YYYY-MM-DD

publicationDateFrom: Start date for range filter (inclusive) - documents published on or after this date
publicationDateTo: End date for range filter (inclusive) - documents published on or before this date
Both parameters are optional - you can use just one for open-ended ranges
Cannot be used together with publicationDate in the same request
Date range behavior: Returns documents published within the specified date range

documentTopic

Available topics:

Customs - Customs and import/export regulations
Excise Duties - Excise duties and taxes
Income Tax - General income tax regulations
VAT - Value Added Tax regulations
Succession and Registration Rights - Succession and registration rights
Other - - Other document topics

documentType

Available types:

Administrative Guideline - Administrative guidelines and procedures
Court Verdict - Court decisions and verdicts
International Treaty - International treaties and agreements
Legislation - Formal laws and legislation
Parliamentary Question - Parliamentary questions and answers
Ruling - Administrative rulings and decisions
Other - Other document types

documentSource

Available sources:

Fisconet - Fisconet database
Vlabel - Vlabel database
CBN - CBN database

Looking for other sources? Request more sources via api-support@fyndera.be.

Response

array

Show document object

string

Unique identifier for the document

string

Document language code (e.g., “nl”, “fr”, “en”)

string

Source organization or institution

string

URL to the original document source

string

Document title

string

Brief summary of the document content

array

Array of relevant keywords

string

Date when the document was published (YYYY-MM-DD format). If an existing document gets updated by a source, the publication date will change and the new version will be published under the same docId.

string

Full document content in Markdown format

object

Show custom values object

string

Custom title field

string

Custom summary field

array

Custom keywords array

string

Document type classification

string

Document topic classification

object

Show metadata object

string

Unique identifier for this request

string

ISO 8601 timestamp of the response

Example Response

{
  "documents": [
    {
      "docId": "DOC-2024-001",
      "language": "nl",
      "source": "Fisconet",
      "sourceURL": "https://www.minfin.fgov.be/myminfin-web/pages/public/fisconet/document/df0ea27b-9054-49d0-a03e-accf6c1b2e1f",
      "title": "Voorafgaande beslissing nr. 2023.0089 d.d. 21.03.2023",
      "summary": "Winstpremie voor de werknemers - Handeling buiten de werkingssfeer van de BTW.",
      "keywords": [
        "winstpremie voor de werknemers",
        "winstpremietaks op winstdeelnemingen",
        "tarief",
        "fiscale aftrekbaarheid",
        "doorfacturatie",
        "handeling buiten de werkingssfeer",
        "btw",
        "verworpen uitgave"
      ],
      "publicationDate": "2024-01-15",
      "contents": "",
      "customValues": {
        "title": "Fiscale behandeling winstpremie werknemers binnen een groep van vennootschappen.",
        "summary": "De voorafgaande beslissing 2023.0089 van 21.03.2023 betreft de fiscale behandeling van een winstpremie voor werknemers binnen een groep van vennootschappen. De winstpremie, bedoeld voor alle werknemers in België, is onderworpen aan 7% belasting, berekend op het bedrag verminderd met 13,07% solidariteitsbijdrage, en vrijgesteld van inkomstenbelasting voor werknemers. Voor de toekennende vennootschap is de premie deels een verworpen uitgave (voor eigen werknemers) en deels fiscaal aftrekbaar (voor werknemers van andere werkgevers). Het doorfactureren van de premie aan andere werkgevers is geen dienst en valt buiten de btw-werkingssfeer. Elke werkgever is verantwoordelijk voor de inhouding van de 7% belasting en de bijbehorende formaliteiten voor de eigen werknemers.",
        "keywords": [],
        "documentType": "Ruling",
        "documentTopic": ["Income Tax"]
      }
    }
  ]
}

Error Responses

See Error Codes for detailed error information.

Rate Limits

By default, we process a maximum of 1.000 requests per hour. If you need different limits, contact api-support@fyndera.be.

Bulk data delivery

If you prefer data delivery outside of the API, we can provide:

JSONL exports containing one document per line
Delivery to your cloud bucket (S3, GCS, or Azure Blob) or shared bucket access

Include the time window, sources, and fields you need. Contact api-support@fyndera.be to arrange bulk delivery.

Starten met Fyndera

Documentatie

Integraties

Instellingen

API Documentation

Endpoints

Endpoints

GET /legislation

Request

Query Parameters

Multiple Values

Parameter Values

publicationDate

publicationDateFrom & publicationDateTo

documentTopic

documentType

documentSource

Response

Example Response

Error Responses

Rate Limits

Bulk data delivery

​Endpoints

​GET /legislation

​Request

​Query Parameters

​Multiple Values

​Parameter Values

​publicationDate

​publicationDateFrom & publicationDateTo

​documentTopic

​documentType

​documentSource

​Response

​Example Response

​Error Responses

​Rate Limits

​Bulk data delivery

Endpoints

GET /legislation

Request

Query Parameters

Multiple Values

Parameter Values

publicationDate

publicationDateFrom & publicationDateTo

documentTopic

documentType

documentSource

Response

Example Response

Error Responses

Rate Limits

Bulk data delivery