Get usage by billing tag

You can use the billing tag to get your usage amount, as shown here. This example uses org123456789 as the realmId and testtag as the billingTag.

Request

    GET https://usage.bam.api.here.com/v2/usage/realms/org123456789?startDate=2021-07-01T10:39:51&endDate=2021-08-30T10:39:51&billingTag=testtag

Parameters

The parameters shown here are necessary for this request. For a complete list of parameters, see the Tutorials overview.

realmId required string [ 5 .. 30 ] characters
Example: org123456789
Your org ID.
startDate
required
string
Example: startDate=yyyy-MM-dd'T'HH:mm:ss
Start date for a search.
endDate
required
string
Example: endDate=yyyy-MM-dd'T'HH:mm:ss
End date for a search.
billingTag string less than or equal to 500 characters
Example: billingTag=testtag
Billing tags are used for combining costs on your invoices.

Header parameters

X-Request-ID string
User-provided token that can be used to trace a request or a group of requests sent to the service.
X-Correlation-ID
required
string
Auto-generated ID, which uniquely identifies the request, available in the response. When contacting the support with an inquiry regarding a specific request, provide the value of this header; This assists with troubleshooting the issue.

Response: HTTP 200 OK

{
    "total": 2,
    "limit": 100,
    "items": [
        {
            "realmId": "org123456789",
            "featureId": "hrn:here:service::org123456789:feature1",
            "category": "Location Services",
            "name": "Autocomplete",
            "valueDriver": "Transactions",
            "usageValue": 144940.0000,
            "billableValue": 144940.0000
        },
        {
            "realmId": "org123456789",
            "featureId": "hrn:here:service::org123456789:feature2",
            "category": "Location Services",
            "name": "Geocode & Reverse Geocode",
            "valueDriver": "Transactions",
            "usageValue": 91932.0000,
            "billableValue": 91932.0000
        }
    ],
    "nextOffset": 0,
    "lastOffset": 0
}

More information can be found in the Usage API Reference.

results matching ""

    No results matching ""