> For the complete documentation index, see [llms.txt](https://docs.qvantum-plan.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qvantum-plan.de/dev/get-tenant.md).

# Getting a Tenant

First prerequisite to using the QVANTUM Public API is a valid QVANTUM *tenant* context. If you are interested in experimenting with the QVANTUM Public API, please contact us at <support@qvantum-plan.de> to have a tenant context set up for you.

Upon creation of your tenant context, you will receive an invitation mail, including URLs and initial login credentials for the QVANTUM Web App. Please follow the instructions in this invitation mail, perform a first login and change password immediately, before you use your username/password credentials with the QVANTUM Public API.

This tutorial builds upon a set of expected environment variables, mainly derived from the information of a QVANTUM tenant context. For the included curl command lines to work properly, developers must make sure that the following environment variables are set correctly, in particular wrt. [authentication](/dev/general-information.md#authentication).

* `API`: QVANTUM Public API endpoint URL; must be set to `https://api.qvantum-plan.de`.
* `AUTH`: QVANTUM Authentication endpoint URL; must be set to `https://auth.qvantum-plan.de`.
* `TENANT` : tenant identifier, as used in `https://app.qvantum-plan.de/tenants/${TENANT}`.
* `CLIENTID`: identifier of OAuth 2.0 client, defaults to `api`.
* `USERNAME`: username of your tenant account, stated as email address.
* `PASSWORD`: password of your tenant account.