Developer Overheid Open Source Register
Developer Overheid Open Source Register
Download OpenAPI specification:Download
Deze API (Application Programming Interface) van RVO biedt de mogelijkheid om data van het Informatiehuis Internationaal Ondernemen (IIO) op te vragen. Om ervoor te zorgen dat RVO zijn dienstverlening zo goed mogelijk aan kan bieden is de Informatie Internationaal Ondernemen (IIO) API momenteel alleen bruikbaar met behulp van een API-key. RVO gebruikt deze key om inzicht te krijgen in het gebruik van de API. Bijvoorbeeld om te meten welke endpoints en filtermogelijkheden het populairst zijn. We gebruiken de API-key ook om de gebruikers van de API in beeld te krijgen. Zo kunnen wij gebruikers tijdig informeren over incidenten (veroorzaakte piekbelasting, storingen, etc.) en backwards incompatible wijzigingen (versie updates, deprecation periods, etc.).
Een IIO API-key kan verkregen worden door een e-mail te sturen naar informatiehuisIO@rvo.nl. Om onze dienstverlening in de toekomst te kunnen verbeteren en aan te laten sluiten bij onze gebruikers stellen wij het op prijs als je ook laat weten wie je bent en wat je motivatie is om deze API te gebruiken.
De loggings gegevens worden enkel gebruikt voor statische doeleinden, beheer en doorontwikkeling. Loggings gegevens worden niet gepubliceerd als dit herleidbaar kan zijn naar individuele gebruikers.
Een compleet overzicht van alle technische wijzigingen is te vinden in de onderstaande changelog: https://internationaal.ondernemen.overheid.nl/api/iio/v1/changelog.md
Return the image, body, source, country and link of a content item.
| uuid required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 A UUID parameter from a sector, country, content-item etc. |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "titel": "Doing Business in Germany",
- "tekst": "<p>This is an example of HTML content.</p>",
- "afbeelding": {
- "alt-text": "A beautiful sunset over the mountains",
}, - "gepubliceerdOp": "2024-02-10T09:00:06+01:00",
- "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
], - "sectoren": [
- {
- "sector": "Energy",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
], - "_links": {
}
}Return the ID's of all content-items together with the title, body, link, image, date and related sectors or countries.
| sector | string <uuid> Example: sector=123e4567-e89b-12d3-a456-426614174000 Filter items by one or more sector UUIDs. UUIDs should be comma-separated for multiple sectors. |
| country | string <uuid> Example: country=123e4567-e89b-12d3-a456-426614174000 Filter items by one or more country UUIDs. UUIDs should be comma-separated for multiple countries. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "content-items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "titel": "Doing Business in Germany",
- "tekst": "<p>This is an example of HTML content.</p>",
- "afbeelding": {
- "alt-text": "A beautiful sunset over the mountains",
}, - "gepubliceerdOp": "2024-02-10T09:00:06+01:00",
- "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
], - "sectoren": [
- {
- "sector": "Energy",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
], - "_links": {
}
}
]
}, - "_links": {
}
}Return the ID's of all countries together with the country name, ISO codes, capital and time difference with The Netherlands.
| code | integer <int32> Example: code=123 A filter parameter for the country code. |
| code_iso_alpha_2 | string Example: code_iso_alpha_2=NL A filter parameter for the ISO Alpha-2 code. |
| code_iso_alpha_3 | string Example: code_iso_alpha_3=NLD A filter parameter for the ISO Alpha-3 code. |
| code_iso_3166_2 | string Example: code_iso_3166_2=ISO 3166-2:NR A filter parameter for the ISO 3166-2 code. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
object Controls the sorting order of countries based on specified fields. Use field names as keys. |
{- "_embedded": {
- "landen": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "naam": "Netherlands",
- "code": "528",
- "code_iso_alpha_2": "NL",
- "code_iso_alpha_3": "NLD",
- "code_iso_3166_2": "NL-NH",
- "_embedded": {
- "hoofdstad": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "tijdsverschil": 2,
- "naam": "Amsterdam"
}
}, - "_links": {
}
}
]
}, - "_links": {
}
}Return the links, observations and do's and don'ts of a country. Also including oficial languages, currency, currency code, image file of flag, country name, country code, residence name, capital, time difference with The Netherlands, form of government and business languages.
| uuid required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 A UUID parameter from a sector, country, content-item etc. |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "naam": "Netherlands",
- "code": "528",
- "code_iso_alpha_2": "NL",
- "code_iso_alpha_3": "NLD",
- "code_iso_3166_2": "NL-NH",
- "_embedded": {
- "hoofdstad": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "tijdsverschil": 2,
- "naam": "Amsterdam"
}
}, - "_links": {
- "dosAndDonts": {
}, - "contentItems": {
},
}, - "officieleTalen": [
- "Nederlands",
- "Engels"
], - "valuta": [
- {
- "code": "EUR",
- "naam": "Euro"
}
], - "inwonerbenaming": "Nederlander",
- "staatsvorm": "constitutionele monarchie",
- "sanitaireProblemen": true,
- "zakelijkeTalen": [
- "English",
- "French"
]
}Return the contact details of organizations belonging to a country.
| uuid required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 A UUID parameter from a sector, country, content-item etc. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "instanties": [
- {
- "contactpunten": [
- {
- "telefoonnummer": [
- "+31880424242"
], - "openingstijden": "<p>You can reach us on working days from 8:30 AM to 5:00 PM.</p>",
- "faxnummer": "+31880429527",
- "email": "info@rvo.nl"
}
], - "geometrie": [
- {
- "type": "Point",
- "coordinates": [
- 12.34,
- 56.78
]
}
], - "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "naam": "RVO headquarters",
- "vestiging": {
- "address": {
- "volledigAdres": "Prinses Beatrixlaan 2 2595 AL Den Haag Zuid-Holland"
}
}, - "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
]
}
]
}, - "_links": {
}
}Return the content items details belonging to a country.
| uuid required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 A UUID parameter from a sector, country, content-item etc. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "content-items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "titel": "Doing Business in Germany",
- "tekst": "<p>This is an example of HTML content.</p>",
- "afbeelding": {
- "alt-text": "A beautiful sunset over the mountains",
}, - "gepubliceerdOp": "2024-02-10T09:00:06+01:00",
- "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
], - "sectoren": [
- {
- "sector": "Energy",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
], - "_links": {
}
}
]
}, - "_links": {
}
}Return the do's and don'ts of a country.
| uuid required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 A UUID parameter from a sector, country, content-item etc. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "dos-donts": [
- {
- "categorieen": [
- "Presentatie"
], - "titel": "Choose elaborate clothing",
- "isDo": true,
- "tekst": "<p>This is an example of HTML content.</p>",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
]
}
]
}, - "_links": {
}
}Retrieve observations for a specific country using a valid country UUID.
| uuid required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 A UUID parameter from a sector, country, content-item etc. |
| type | string Enum: "bigMacIndex" "economischeGroei" "easeOfDoingBusinessIndex" "uitvoerwaarde" "corruptieIndex" "bbp" "koopkracht" "globalCompetitivenessIndex" "globalInnovationIndex" "invoerWaarde" "inflatie" "logisticPerformanceIndex" "inwoneraantal" "oppervlakte" "werkloosheid" Specifies the type of observation to filter by. |
| year | integer <int32> Example: year=2024 Filter results on a specific year. |
| jaartal | integer <int32> Example: jaartal=2024 Filter results on a specific year with a dutch parameter. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "observaties": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "oppervlakte",
- "meeteenheid": {
- "naam": "Vierkante kilometer",
- "afkorting": "<p>In km²</p>"
}, - "waarde": "1671000",
- "jaartal": "2016",
- "ranking": 5,
- "schatting": false,
- "schaal": "km²",
- "herkomst": {
- "bron": {
- "naam": "Wereldbank"
}, - "datum": "2022-12-01"
}, - "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
]
}
]
}, - "_links": {
}
}Return the ID's of all events together with the event title, body, link, image, dates and related sectors or countries.
| sector | string <uuid> Example: sector=123e4567-e89b-12d3-a456-426614174000 Filter items by one or more sector UUIDs. UUIDs should be comma-separated for multiple sectors. |
| country | string <uuid> Example: country=123e4567-e89b-12d3-a456-426614174000 Filter items by one or more country UUIDs. UUIDs should be comma-separated for multiple countries. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "evenementen": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "titel": "Germany MEDICA 2024",
- "tekst": "<p>This is an example of HTML content.</p>",
- "afbeelding": {
- "alt-text": "A beautiful sunset over the mountains",
}, - "startdatum": "2024-02-10T09:00:06+01:00",
- "einddatum": "2024-02-10T09:00:06+01:00",
- "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
], - "sectoren": [
- {
- "sector": "Energy",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
]
}
]
}, - "_links": {
}
}Return the title, body and link of all finances and subsidies together with the related country along with associated country names, links, and IDs. Supports filtering by multiple country IDs using the 'country' query parameter.
| country | string <uuid> Example: country=123e4567-e89b-12d3-a456-426614174000 Filter items by one or more country UUIDs. UUIDs should be comma-separated for multiple countries. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "financieringen": [
- {
- "titel": "Canada subsidy guide",
- "tekst": "<p>This is an example of HTML content.</p>",
- "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
]
}
]
}, - "_links": {
}
}Return the title, body and link of all laws and regulations together with the related country along with associated country names, links, and IDs. Supports filtering by multiple country IDs using the 'country' query parameter.
| country | string <uuid> Example: country=123e4567-e89b-12d3-a456-426614174000 Filter items by one or more country UUIDs. UUIDs should be comma-separated for multiple countries. |
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "wet-en-regelgevingen": [
- {
- "titel": "Laws and regulations in Afghanistan",
- "tekst": "<p>This is an example of HTML content.</p>",
- "landen": [
- {
- "land": "Netherlands",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
]
}
]
}, - "_links": {
}
}Return the ID's and names of all sectors together.
| pageSize | integer Default: 10 Enum: 10 20 50 Set the amount of items to retrieve per page. |
| page | integer <int32> >= 1 Default: 1 Set the current page for the items to retrieve. |
{- "_embedded": {
- "sectoren": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "naam": "Creatieve industrie"
}
]
}, - "_links": {
}
}