Quick start


In this document, the term "realm" means "organization". See Manage your organization.

This section outlines how to quickly get started using the cost management API:


This section provides information on the minimum setup required to quickly begin using the cost management API. For more detailed information on HERE account setup, app registration, and authentication, see the Identity & Access Management Developer Guide.

Get a HERE account

In order to access the HERE platform cost management API, you need to obtain a HERE account. Learn more at Get a HERE account.

Get Credentials

HERE offers this option for authentication when you sign up for a plan at the HERE website.

Register your app

To register your app, follow the steps in Identity and Access Management Guide-OAuth Tokens.

Now that your app is registered, you can get OAuth 2.0 tokens to authenticate requests. You will need to code your application to get an OAuth 2.0 token for each request to a HERE service.

Get an OAuth token

There are multiple ways to get a token:

Having followed one of the above methods, you have successfully obtained a token to use in making REST requests to HERE APIs. Include the token in the HTTP Authorization header of your REST requests as a bearer token:

Authorization: Bearer <token>

Send a request

Once you have created a HERE account and setup your credentials, you can test them by sending any request. Include the token in the HTTP authorization header before you send the request. A successful response from your request verifies that your credentials are setup correctly. For example, the following is a short request which defines rules in your realm.

Get quota rules defined in your realm


    GET https://quota.bam.api.here.com/v1/realms/{{realm}}/rules


The following is a successful response to get the quota rules which are defined in your realm.

    HTTP 20O OK
  "total": 0,
  "limit": 100,
  "items": [
  "nextOffset": 0,
  "lastOffset": 0

results matching ""

    No results matching ""