Gemeente Amsterdam Brondocumenten API
The brondocumenten API from Gemeente Amsterdam — 2 operation(s) for brondocumenten.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amsterdam-nl:amsterdam-nl-brondocumenten-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Amsterdam Nl Brondocumenten API
version: 1.0.0
contact:
email: datapunt@amsterdam.nl
license:
name: ''
termsOfService: https://data.amsterdam.nl/
description: 'Operations tagged brondocumenten across 2 of this provider''s published API definitions: amsterdam-nl-bag-openapi-original.json, amsterdam-nl-bag-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.data.amsterdam.nl/
security:
- oauth2: []
tags:
- name: brondocumenten
paths:
/brondocumenten:
get:
operationId: bag_brondocumenten_list
description: In deze tabel staat geen data meer en wordt binnenkort verwijderd
parameters:
- in: header
name: Accept-Crs
schema:
type: string
description: Accept-Crs header for Geo queries
- in: header
name: Content-Crs
schema:
type: string
description: Content-Crs header for Geo queries
- in: header
name: X-Api-Key
schema:
type: string
description: Api Key for statistical purposes, not for authentication
- name: _count
required: false
in: query
description: Include a count of the total result set and the number of pages.Only works for responses that return a page.
schema:
type: boolean
- in: query
name: _csv_header
schema:
type: string
enum:
- id
- title
- none
description: Specify type of header for csv file
- in: query
name: _csv_separator
schema:
type: string
enum:
- ','
- ;
description: Specify type of separator for csv file
- in: query
name: _expand
schema:
type: boolean
description: Allow to expand relations.
- in: query
name: _expandScope
schema:
type: string
description: Comma separated list of named relations to expand.
- in: query
name: _fields
schema:
type: string
description: Comma-separated list of fields to display
- in: query
name: _format
schema:
type: string
enum:
- json
- csv
- geojson
description: Select the export format
- name: _pageSize
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- name: _sort
required: false
in: query
description: Which field to use when ordering the results.
schema:
type: string
- name: bronleverancierCode
in: query
description: Verstrekker van brondocumenten en/of gegevens voortkomend uit het uitoefenen of voorbereiden van een gemeentelijke bevoegdheid, die nodig zijn voor een registratie aan de bronhouder, conform vastgestelde aanleverspecificaties. code
schema:
type: string
- name: bronleverancierCode[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: bronleverancierCode[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: bronleverancierCode[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: bronleverancierCode[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: bronleverancierCode[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: bronleverancierOmschrijving
in: query
description: Verstrekker van brondocumenten en/of gegevens voortkomend uit het uitoefenen of voorbereiden van een gemeentelijke bevoegdheid, die nodig zijn voor een registratie aan de bronhouder, conform vastgestelde aanleverspecificaties. omschrijving
schema:
type: string
- name: bronleverancierOmschrijving[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: bronleverancierOmschrijving[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: bronleverancierOmschrijving[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: bronleverancierOmschrijving[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: bronleverancierOmschrijving[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: documentnummer
in: query
description: Identificerende nummer van het document
schema:
type: string
- name: documentnummer[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: documentnummer[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: documentnummer[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: documentnummer[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: documentnummer[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: page
required: false
in: query
description: A page number within the paginated result set.
schema:
type: integer
- name: registratiedatum
in: query
description: De datum waarop het brondocument is opgeslagen in het register
schema:
type: string
format: date-time
- name: registratiedatum[gt]
in: query
description: Greater than; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: string
format: date-time
- name: registratiedatum[gte]
in: query
description: Greater than or equal to; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: string
format: date-time
- name: registratiedatum[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
format: date-time
explode: false
style: form
- name: registratiedatum[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: registratiedatum[lt]
in: query
description: Less than; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: string
format: date-time
- name: registratiedatum[lte]
in: query
description: Less than or equal to; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: string
format: date-time
- name: registratiedatum[not]
in: query
description: Exclude matches; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: array
items:
type: string
format: date-time
- name: typeBrondocumentCode
in: query
description: 'Code van het type brondocument. Bijvoorbeeld: Bouwvergunning, Splitsingvergunning, etc'
schema:
type: string
- name: typeBrondocumentCode[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: typeBrondocumentCode[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: typeBrondocumentCode[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: typeBrondocumentCode[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: typeBrondocumentCode[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: typeBrondocumentOmschrijving
in: query
description: Het type brondocument. omschrijving
schema:
type: string
- name: typeBrondocumentOmschrijving[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: typeBrondocumentOmschrijving[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: typeBrondocumentOmschrijving[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: typeBrondocumentOmschrijving[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: typeBrondocumentOmschrijving[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: typeDossierCode
in: query
description: 'Code van het type dossier. Bijvoorbeeld: Omgevingsvergunning of Terugmelding of sloopvergunning, etc'
schema:
type: string
- name: typeDossierCode[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: typeDossierCode[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: typeDossierCode[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: typeDossierCode[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: typeDossierCode[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: typeDossierOmschrijving
in: query
description: Het type dossier. omschrijving
schema:
type: string
- name: typeDossierOmschrijving[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: typeDossierOmschrijving[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: typeDossierOmschrijving[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: typeDossierOmschrijving[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: typeDossierOmschrijving[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
tags:
- brondocumenten
responses:
'200':
content:
application/hal+json:
schema:
$ref: '#/components/schemas/PaginatedBagbrondocumentenList'
text/csv:
schema:
$ref: '#/components/schemas/PaginatedBagbrondocumentenList'
application/geo+json:
schema:
$ref: '#/components/schemas/PaginatedBagbrondocumentenList'
description: ''
summary: Bag brondocumenten list
x-summary-source: derived
servers:
- url: https://api.data.amsterdam.nl/
/brondocumenten/{documentnummer}:
get:
operationId: bag_brondocumenten_retrieve
parameters:
- in: header
name: Accept-Crs
schema:
type: string
description: Accept-Crs header for Geo queries
- in: header
name: Content-Crs
schema:
type: string
description: Content-Crs header for Geo queries
- in: header
name: X-Api-Key
schema:
type: string
description: Api Key for statistical purposes, not for authentication
- in: query
name: _csv_header
schema:
type: string
enum:
- id
- title
- none
description: Specify type of header for csv file
- in: query
name: _csv_separator
schema:
type: string
enum:
- ','
- ;
description: Specify type of separator for csv file
- in: query
name: _expand
schema:
type: boolean
description: Allow to expand relations.
- in: query
name: _expandScope
schema:
type: string
description: Comma separated list of named relations to expand.
- in: query
name: _fields
schema:
type: string
description: Comma-separated list of fields to display
- in: query
name: _format
schema:
type: string
enum:
- json
- csv
- geojson
description: Select the export format
- name: _sort
required: false
in: query
description: Which field to use when ordering the results.
schema:
type: string
- name: bronleverancierCode
in: query
description: Verstrekker van brondocumenten en/of gegevens voortkomend uit het uitoefenen of voorbereiden van een gemeentelijke bevoegdheid, die nodig zijn voor een registratie aan de bronhouder, conform vastgestelde aanleverspecificaties. code
schema:
type: string
- name: bronleverancierCode[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: bronleverancierCode[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: bronleverancierCode[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: bronleverancierCode[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: bronleverancierCode[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: bronleverancierOmschrijving
in: query
description: Verstrekker van brondocumenten en/of gegevens voortkomend uit het uitoefenen of voorbereiden van een gemeentelijke bevoegdheid, die nodig zijn voor een registratie aan de bronhouder, conform vastgestelde aanleverspecificaties. omschrijving
schema:
type: string
- name: bronleverancierOmschrijving[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: bronleverancierOmschrijving[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: bronleverancierOmschrijving[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: bronleverancierOmschrijving[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: bronleverancierOmschrijving[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- in: path
name: documentnummer
schema:
type: string
title: Brondocument nummer
description: Identificerende nummer van het document
required: true
- name: documentnummer
in: query
description: Identificerende nummer van het document
schema:
type: string
- name: documentnummer[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: documentnummer[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: documentnummer[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: documentnummer[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: documentnummer[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: registratiedatum
in: query
description: De datum waarop het brondocument is opgeslagen in het register
schema:
type: string
format: date-time
- name: registratiedatum[gt]
in: query
description: Greater than; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: string
format: date-time
- name: registratiedatum[gte]
in: query
description: Greater than or equal to; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: string
format: date-time
- name: registratiedatum[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
format: date-time
explode: false
style: form
- name: registratiedatum[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: registratiedatum[lt]
in: query
description: Less than; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: string
format: date-time
- name: registratiedatum[lte]
in: query
description: Less than or equal to; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: string
format: date-time
- name: registratiedatum[not]
in: query
description: Exclude matches; use yyyy-mm-dd or yyyy-mm-ddThh:mm[:ss[.ms]]
schema:
type: array
items:
type: string
format: date-time
- name: typeBrondocumentCode
in: query
description: 'Code van het type brondocument. Bijvoorbeeld: Bouwvergunning, Splitsingvergunning, etc'
schema:
type: string
- name: typeBrondocumentCode[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: typeBrondocumentCode[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: typeBrondocumentCode[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: typeBrondocumentCode[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: typeBrondocumentCode[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: typeBrondocumentOmschrijving
in: query
description: Het type brondocument. omschrijving
schema:
type: string
- name: typeBrondocumentOmschrijving[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: typeBrondocumentOmschrijving[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: typeBrondocumentOmschrijving[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: typeBrondocumentOmschrijving[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: typeBrondocumentOmschrijving[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: typeDossierCode
in: query
description: 'Code van het type dossier. Bijvoorbeeld: Omgevingsvergunning of Terugmelding of sloopvergunning, etc'
schema:
type: string
- name: typeDossierCode[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: typeDossierCode[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: typeDossierCode[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: typeDossierCode[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: typeDossierCode[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
- name: typeDossierOmschrijving
in: query
description: Het type dossier. omschrijving
schema:
type: string
- name: typeDossierOmschrijving[in]
in: query
description: 'Matches any value from a comma-separated list: val1,val2,valN.'
schema:
type: array
items:
type: string
explode: false
style: form
- name: typeDossierOmschrijving[isempty]
in: query
description: Whether the field is empty or not.
schema:
type: boolean
- name: typeDossierOmschrijving[isnull]
in: query
description: Whether the field has a NULL value or not.
schema:
type: boolean
- name: typeDossierOmschrijving[like]
in: query
description: Matches text using wildcards (? and *).
schema:
type: string
- name: typeDossierOmschrijving[not]
in: query
description: Exclude matches; text
schema:
type: array
items:
type: string
tags:
- brondocumenten
responses:
'200':
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Bagbrondocumenten'
text/csv:
schema:
$ref: '#/components/schemas/Bagbrondocumenten'
application/geo+json:
schema:
$ref: '#/components/schemas/Bagbrondocumenten'
description: ''
summary: Bag brondocumenten retrieve
x-summary-source: derived
servers:
- url: https://api.data.amsterdam.nl/
components:
schemas:
BagdefaultBrondocumentenLinks:
type: object
description: The contents of the `brondocumenten._links` field. It contains all relationships with objects.
properties:
schema:
type: string
format: uri
description: The schema field is exposed with every record
readOnly: true
self:
$ref: '#/components/schemas/BagbrondocumentenLink'
required:
- schema
- self
BagbrondocumentenLink:
type: object
description: The identifier of the relationship to brondocumenten.
properties:
href:
type: string
format: uri
readOnly: true
title:
type: string
documentnummer:
type: string
title: Brondocument nummer
description: Identificerende nummer van het document
required:
- documentnummer
- href
- title
Bagbrondocumenten:
type: object
description: In deze tabel staat geen data meer en wordt binnenkort verwijderd
properties:
_links:
allOf:
- $ref: '#/components/schemas/BagdefaultBrondocumentenLinks'
title: ' links'
documentnummer:
type: string
title: Brondocument nummer
description: Identificerende nummer van het document
bronleverancierCode:
type:
- string
- 'null'
title: Bron leverancier code
description: Verstrekker van brondocumenten en/of gegevens voortkomend uit het uitoefenen of voorbereiden van een gemeentelijke bevoegdheid, die nodig zijn voor een registratie aan de bronhouder, conform vastgestelde aanleverspecificaties. code
bronleverancierOmschrijving:
type:
- string
- 'null'
title: Bron leverancier omschrijving
description: Verstrekker van brondocumenten en/of gegevens voortkomend uit het uitoefenen of voorbereiden van een gemeentelijke bevoegdheid, die nodig zijn voor een registratie aan de bronhouder, conform vastgestelde aanleverspecificaties. omschrijving
typeDossierCode:
type:
- string
- 'null'
title: Dossier type code
description: 'Code van het type dossier. Bijvoorbeeld: Omgevingsvergunning of Terugmelding of sloopvergunning, etc'
typeDossierOmschrijving:
type:
- string
- 'null'
title: Dossier type omschrijving
description: Het type dossier. omschrijving
typeBrondocumentCode:
type:
- string
- 'null'
title: Brondocument type code
description: 'Code van het type brondocument. Bijvoorbeeld: Bouwvergunning, Splitsingvergunning, etc'
typeBrondocumentOmschrijving:
type:
- string
- 'null'
title: Brondocument type omschrijving
description: Het type brondocument. omschrijving
registratiedatum:
type:
- string
- 'null'
format: date-time
title: Registratie datum
description: De datum waarop het brondocument is opgeslagen in het register
required:
- _links
- documentnummer
PaginatedBagbrondocumentenList:
type: object
properties:
page:
type: object
properties:
number:
type: integer
example: 3
size:
type: integer
example: 20
totalElements:
type: integer
example: 5
totalPages:
type: integer
example: 3
_links:
type: object
properties:
self:
type: object
properties:
href:
type: string
format: uri
example: https://api.data.amsterdam.nl/v1/.../resource/?page=3
next:
type: object
properties:
href:
type:
- string
- 'null'
format: uri
example: https://api.data.amsterdam.nl/v1/.../resource/?page=4
previous:
type: object
properties:
href:
type:
- string
- 'null'
format: uri
example: https://api.data.amsterdam.nl/v1/.../resource/?page=2
_embedded:
type: object
properties:
brondocumenten:
type: array
items:
$ref: '#/components/schemas/Bagbrondocumenten'
securitySchemes:
oauth2:
type: oauth2
flows:
implicit:
authorizationUrl: https://iam.amsterdam.nl/auth/realms/datapunt-ad/protocol/openid-connect/auth
scopes: {}
externalDocs:
description: API Usage Documentation
url: https://api.data.amsterdam.nl/v1/docs/datasets/bag.html
x-refined-from:
- amsterdam-nl-bag-openapi-original.json
- amsterdam-nl-bag-openapi.yml
x-versions:
default:
url: https://api.data.amsterdam.nl/v1/afvalwijzer
status: stable
endSupportDate: null
statusDescription: stabiel
default: true
paths:
afvalwijzer: stable
acc_afvalwijzer: stable
pathsUnderDevelopment: false
v1:
url: https://api.data.amsterdam.nl/v1/afvalwijzer/v1
status: stable
endSupportDate: null
statusDescription: stabiel
default: true
paths:
afvalwijzer: stable
acc_afvalwijzer: stable
pathsUnderDevelopment: false
pathsDeprecated: false
pathsDiscontinued: false