Getting Started
Find your API base URL, prepare an API token, and make your first request.
Requirements
Before calling the API, you need:
- an Opero organisation
- an API token created in Opero
- your Opero API base URL
API tokens use the ek_ prefix and are sent as bearer tokens.
Authorization: Bearer ek_...API base URL
The API base URL is the root URL of the Opero API. It is provided for your Opero workspace and is different from the docs URL and the Opero web app URL.
Use it as the prefix for every API path:
{API_BASE_URL}/v1/pingReplace {API_BASE_URL} with the base URL assigned to your workspace.
First request
Use the ping endpoint to confirm that the base URL and token are valid:
curl "{API_BASE_URL}/v1/ping" \
-H "Authorization: Bearer ek_..."If the request succeeds, your token can authenticate against the API.
API Reference
Use the Opero API reference when you want to check available API operations or inspect request and response schemas.
Next step
Open the Opero API reference to inspect available endpoints and execute requests from the playground.