Purchasing an API subscription
To start using the paid 2GIS maps, navigation, and search APIs, purchase a subscription in the Platform Manager personal account. For available services, prices, and restrictions, see Pricing and limits.
- 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 create a free demo key for one month to test the 2GIS APIs functionality.
Purchasing a subscription
-
Register in the Platform Manager personal account.
-
Go to the Dashboard tab and click Buy Subscription.
Subscription purchaseIf you do not see the Buy Subscription button in the interface, click Submit Purchase Request to purchase a subscription and skip the steps below. Once the subscription is created, you can proceed with managing access keys and viewing statistics.
-
Select the payment period: 1 month or 1 year.
-
Select the services you need access to. You can select separate services or a prepared set depending on the task, for example, searching for a business on the map or building routes.
If the services are not sufficient during operation, you can purchase additional services.
-
For each service, specify the limit on the number of requests or responses (depending on the service) per month.
If service usage exceeds the limit after you purchase a subscription, the API key is suspended until the beginning of the next month. You can change the limits for services of the key within the subscription or purchase additional limits in the subscription. The service is unlocked after that.
-
(Optional) Enter a promo code in the Promo code field. The total is recalculated automatically.
Promo codeOne promo code that you have not used before can be applied to an order.
-
Click Add Legal Data.
-
Select the license owner: legal entity, individual entrepreneur (IE), or individual.
-
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 company will be filled in automatically.
- Individual entrepreneur: tax reference number and email for receiving documents.
- Individual: full name, mobile phone number, and email for receiving documents.
-
Select the checkbox to agree to the offer terms and user agreement and click Save.
-
Check the specified information and click Proceed to Payment. An invoice will be generated automatically. Click Download Invoice and check it.
If you need to change the subscription conditions, click Change Subscription and specify new services and limits. Then click Proceed to Payment.
-
Pay for the subscription using any method:
- By bank card: click Pay by Card and enter card details. Mir, Visa, and Mastercard cards issued in the Russian Federation are accepted. If you pay by card, the subscription is activated immediately after payment.
- By invoice: click Download Invoice and pay using the specified payment details. Processing bank transfers may take up to 5 days. The subscription is activated only after payment. You can see the list of all invoices on the Payment tab.
If you purchased a subscription for the first time, one API key is created automatically. To create more keys, see the Creating a key in a subscription guide. If you previously used a demo key, you can convert it to production mode.
Managing a subscription
After activating a subscription, you can:
- Change the subscription terms for the next billing period.
- Purchase additional limits and services for the current period.
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.
What's next?
- Explore the documentation for the API you need with detailed usage scenarios.
- Create additional keys within the subscription.
- Configure additional key restrictions: see Configuring services, limits, and restrictions.
- View statistics of limit consumption and request distribution.
- Change the subscription settings, purchase missing services, or increase the limits.