Sandbox environment

The sandbox environment is available for all non-production use cases. It provides access to the same API features as production, while being fully isolated from production data. This allows you to develop and test safely without polluting your region’s live data.

Enabling the Sandbox

You can enable the sandbox in one of two ways:

Option 1: Use the /sandbox endpoint prefix

Replace /v2 with /sandbox in the API endpoint.

https://onderwijsregio.onderwijsin.nl/api/sandbox/schema

Option 2: Set a request header

Include the following header in your request:

x-api-sandbox: true

Data Scope and Persistence

Sandbox data is scoped to your region. This means that any API key belonging to the same region has access to the same sandbox data.

To prevent an excessive buildup of test data, the sandbox is cleared automatically once per day. As a result, any test data you create should be considered temporary and may be gone the next day.

Parity with Production

All rules, conventions, and constraints that apply to the production environment—such as rate limits—also apply to the sandbox.

The primary goal of the sandbox is to offer an environment that behaves as closely as possible to production, while keeping your region’s production data clean and unaffected.