Skip to main content

Getting started

Environments​

An environment is a separate copy of the Medipim system — with its own URL, its own dataset, and its own credentials. Think of it as a completely independent version of the API. Medipim provides two environments: production and sandbox.

Each environment has two entry points: the platform and the API. The platform is the web application where you can browse and manage product data through a graphical interface. The API gives you access to the same dataset programmatically — anything you can see on the platform, you can also query and update through the API.

This separation means you can safely develop and test your integration on the sandbox without affecting real data. When you're ready, you switch to the production URL and credentials to go live. Always make sure you are targeting the correct environment — your API credentials are tied to a specific one.

Production​

The production environment contains the live dataset and is used when your integration has been tested and is ready for real use.

  • Platform: https://platform.medipim.be
  • API: https://api.medipim.be/v4

Sandbox​

The sandbox environment can be used to test and experiment freely. Please contact our support team for more details and to gain access.

  • Platform: https://platform.sandbox.medipim.be
  • API: https://api.sandbox.medipim.be/v4
Sandbox data is not permanent

The sandbox environment is periodically reset — any data you create, modify, or upload will be removed. This means query results may change over time as the dataset is refreshed. Use the sandbox for development and testing only; do not rely on it for persistent storage.

Making your first request​

Try it in the browser

Each endpoint in the API Reference has an interactive request panel where you can send requests and see responses directly in your browser. You can switch between environments by changing the base URL in the request panel.

Every request to the Medipim API must be authenticated. You will need an API key and secret — contact info@medipim.com if you don't have one yet.

Once you have your credentials, head over to Authentication to learn how it works and to see code examples for your first authenticated request.