--- title: "Generating API tokens" slug: "generating-api-tokens" updated: 2026-03-06T07:25:31Z published: 2026-03-06T07:25:31Z canonical: "kb.solargis.com/generating-api-tokens" --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.solargis.com/llms.txt > Use this file to discover all available pages before exploring further. # Generating API tokens ## API tokens > [!WARNING] > **Important**: This section is available to **admin users** only. An **API token** is a secure string used to authenticate and authorize your access to our [Solargis Time Series and TMY data services](/v1/docs/solargis-time-series-and-tmy-api). The tokens are generated and managed in the **Solargis account administration** section. ![](https://cdn.document360.io/ae2d502f-6c0d-4865-a68e-43ad8da61149/Images/Documentation/image(627).png?sv=2026-02-06&spr=https&st=2026-11-07T22%3A38%3A42Z&se=2026-11-07T23%3A38%3A42Z&sr=c&sp=r&sig=fKCDefJP1KHNP%2Bwqh5BNmBF%2Fcg8pVlaNs9aR2zWMJWE%3D) ## Generating your API tokens API tokens are **generated per service**. For example, you will need one token for **TMY data** and another for **Time Series** downloads. Available data services depend on your account subscription or purchased add-ons. We offer two token types - **user tokens** and **useless tokens**. User tokenUserless token The token is **directly linked to a user** for whom it has been generated. Only this user can use it to make calls to the Solargis API with this token. Userless tokens are **anonymous** tokens. They have the same functionality as user tokens, but they are not tied to a user, and anyone can use them. To generate a token: 1. In your account administration, navigate to the **API section.** Available data services will be listed. 2. Click the **“Manage”** link of the service you want to create a token. ![](https://cdn.document360.io/ae2d502f-6c0d-4865-a68e-43ad8da61149/Images/Documentation/image(628).png?sv=2026-02-06&spr=https&st=2026-11-07T22%3A38%3A42Z&se=2026-11-07T23%3A38%3A42Z&sr=c&sp=r&sig=fKCDefJP1KHNP%2Bwqh5BNmBF%2Fcg8pVlaNs9aR2zWMJWE%3D) > [!TIP] > **Note**: You will be redirected to the API subscription page. The basic information about the API subscription is provided in the **General tab**. ### Generating user tokens 1. Switch to the "**Users and user tokens** tab. A list of users and their API subscriptions will be listed. 2. Use the toggle to **activate/deactivate** the API subscription for the required user. 3. Generate a new token by clicking the **“Generate token”** link. If you have activated access for a new user, you must save the changes using the **“Save”** button first to activate the link. 4. **Copy** or **download** the token. The system will also create and attach an ID to it for easier tracking. A user can have more than one token under his name. ![](https://cdn.document360.io/ae2d502f-6c0d-4865-a68e-43ad8da61149/Images/Documentation/image(630).png?sv=2026-02-06&spr=https&st=2026-11-07T22%3A38%3A42Z&se=2026-11-07T23%3A38%3A42Z&sr=c&sp=r&sig=fKCDefJP1KHNP%2Bwqh5BNmBF%2Fcg8pVlaNs9aR2zWMJWE%3D) > [!WARNING] > **Important**: The token will be **shown only once** - make sure you save it. If you lose it, you will have to generate a new one ### Generating userless tokens 1. Switch to the "**Userless tokens** tab. A list of existing API tokens will be listed. 2. Generate the token using the “Generate token” link. 3. **Copy** or **download** the token. The system will also create and attach an ID to it for easier tracking. ![](https://cdn.document360.io/ae2d502f-6c0d-4865-a68e-43ad8da61149/Images/Documentation/image(631).png?sv=2026-02-06&spr=https&st=2026-11-07T22%3A38%3A42Z&se=2026-11-07T23%3A38%3A42Z&sr=c&sp=r&sig=fKCDefJP1KHNP%2Bwqh5BNmBF%2Fcg8pVlaNs9aR2zWMJWE%3D) > [!WARNING] > **Important**: The token will be **shown only once** - make sure you save it. If you lose it, you will have to generate a new one ### Regenerating API tokens Tokens are displayed only once upon their generation. If you lose it, you must generate a new one. Older tokens remain working until manually deleted to ensure the existing connections keep working without disruptions. You can generate a new **user token** using the **“Generate token”** link next to the user while on the API subscription management page. A new token will be added to the user’s tokens. ![](https://cdn.document360.io/ae2d502f-6c0d-4865-a68e-43ad8da61149/Images/Documentation/image(632).png?sv=2026-02-06&spr=https&st=2026-11-07T22%3A38%3A42Z&se=2026-11-07T23%3A38%3A42Z&sr=c&sp=r&sig=fKCDefJP1KHNP%2Bwqh5BNmBF%2Fcg8pVlaNs9aR2zWMJWE%3D) You can generate new **userless tokens** using the **“Generate token”** directly on the **Userless tokens** page. ![](https://cdn.document360.io/ae2d502f-6c0d-4865-a68e-43ad8da61149/Images/Documentation/image(633).png?sv=2026-02-06&spr=https&st=2026-11-07T22%3A38%3A42Z&se=2026-11-07T23%3A38%3A42Z&sr=c&sp=r&sig=fKCDefJP1KHNP%2Bwqh5BNmBF%2Fcg8pVlaNs9aR2zWMJWE%3D) ## Managing API tokens As an admin, you can **activate/deactivate** user access to API subscriptions and **rename** or **delete** tokens. All is done on the respective User or Userless tokens pages. The process is identical for both token types. User token management is available using the **“Manage”** link next to the user and userless tokens are managed directly on the **Userless tokens** page. To rename/delete tokens, use the respective links to **rename** or **delete** it. > [!WARNING] > **Important**: When deleting a token, ensure there are **no services connected through it.** Connections using this token will cease to operate once it is deleted. ![](https://cdn.document360.io/ae2d502f-6c0d-4865-a68e-43ad8da61149/Images/Documentation/image(634).png?sv=2026-02-06&spr=https&st=2026-11-07T22%3A38%3A42Z&se=2026-11-07T23%3A38%3A42Z&sr=c&sp=r&sig=fKCDefJP1KHNP%2Bwqh5BNmBF%2Fcg8pVlaNs9aR2zWMJWE%3D) ### Importing API tokens into PVSyst If you want to use the TMY API to load the data into PVSyst via API, learn how to import the API token into PVSyst [here](https://www.pvsyst.com/help-pvsyst7/meteo_import_solargisapi.htm). ## API usage history You can check your usage history on the Usage history page. The calls are stored here for 7 days. ![](https://cdn.document360.io/ae2d502f-6c0d-4865-a68e-43ad8da61149/Images/Documentation/image(636).png?sv=2026-02-06&spr=https&st=2026-11-07T22%3A38%3A42Z&se=2026-11-07T23%3A38%3A42Z&sr=c&sp=r&sig=fKCDefJP1KHNP%2Bwqh5BNmBF%2Fcg8pVlaNs9aR2zWMJWE%3D)