Purchasing and changing a subscription

To start working with 2GIS maps, search, or navigation APIs, you need to purchase a subscription and create API keys.

• Subscription is a package of services and usage limits. Within a subscription, you create API keys that provide access to the purchased service package and consume the specified limits. If the subscription is inactive (expired or unpaid), the API keys also stop working.
• API Key is a unique access key that you specify when working with services. Each API key by default has access to all the services included in the subscription.

You can get a free demo key for one month to test the 2GIS API functionality.

Creating a subscription

1. Sign in to the Platform Manager.

2. Go to the Dashboard tab and click Buy Subscription.

   Note

   If you do not see this button in the interface, click Contact Manager to buy a subscription and skip the steps below. Once the subscription is created, you can proceed with managing access keys and viewing statistics.

3. Select the payment period: 1 month, 6 months, or 1 year.

4. Select the services you need access to. For each service, specify the limit on the number of requests or responses (depending on the service) per month. After creating the key, you will be able to change the limits for services only within the subscription limits.

   If the usage limit for a service is exceeded, the API key will be suspended until the beginning of the next month.

5. Click Add Legal Data.

   

6. Select the license owner: legal entity, individual entrepreneur (IE), or individual.

7. Specify the owner details depending on the legal form:

   • Legal entity: tax reference number, RRC, and email for receiving documents. The name and legal address of the organization will be filled in automatically.
   • Individual entrepreneur: tax reference number and email for receiving documents.
   • Individual: full name, phone number, and email for receiving documents.

8. Select the checkbox to agree to the offer terms and user agreement, and click Save.

   

9. Check the specified data and click Proceed to Payment. The invoice will be generated automatically.

   To change the subscription conditions, click Change Subscription and specify the new settings. Then click Proceed to Payment.

10. To pay for the subscription, click Download Invoice, verify it, and pay according to the specified details.

    Processing bank transfers may take up to 5 days. The subscription is activated after payment. A list of all invoices is available on the Payment tab.

    

If this is your first subscription, one API key is created automatically. To create more keys, see the Creating access keys guide.

Changing a subscription

You can change the subscription settings that will take effect in the next period: duration, list of services, and limit on the number of requests or responses (depending on the service) per month.

You can change the subscription settings an unlimited number of times, but only until the invoice is paid and no earlier than 25 days before the end of the current period. An active subscription cannot be changed.

To change the subscription settings:

1. Go to the Payment tab and open the subscription page.

2. Click Change Subscription.

3. If necessary, select a new payment period: 1 month, 6 months, or 1 year.

4. Select the API services you need access to. For each service, specify the limit on the number of requests or responses (depending on the service) per month.

5. Click Proceed to Payment. A new invoice will be generated automatically.

6. To pay for the subscription, click Download Invoice, verify it, and pay according to the specified details.

   Processing bank transfers may take up to 5 days. The subscription is activated after payment. A list of all invoices is available on the Payment tab.

Other questions

If you have questions about subscription management, visit the support chat by clicking Help in the lower-left corner of the Platform Manager interface.