Get usage csv by featureId

You can retrieve the usage in csv format using the featureId, as shown here.

Request

This example uses hrn:here:service::org123456789:search-geocoding-1 as the featureId.

    GET https://usage.bam.api.here.com/v2/usage/realms/org123456789/csv?startDate=2021-07-01T10:39:51&endDate=2021-08-30T10:39:51&featureId=hrn%3Ahere%3Aservice%3A%3Aorg123456789%3Asearch-geocoding-1

Parameters

The parameters shown here are only necessary for this request. For a complete list of parameters, see the Usage API documentation.

realmId required string [ 5 .. 30 ] characters
Example: org123456789
Your org ID.
startTime
required
string
Example: startTime=yyyy-MM-dd'T'HH:mm:ss
Start date for history search.
endTime
required
string
Example: endTime=yyyy-MM-dd'T'HH:mm:ss
End date for history search.
featureId string less than or equal to 256 characters
Example: featureId=hrn:here:service::org123456789:search-geocoding-1
Feature HRN.

Response: HTTP 200 OK

The response in csv format lists the following columns:

  • Date and time (usageDateTime): The date and time that the usage occurred.
  • Org ID (realmId): The unique identifier for a end-customer's organization and partner organization associated with Org Name.
  • Category (category): The HERE product category, such as pipelines, data, etc.
  • App Id (appId): The unique identifier of a registered app.
  • Item (featureId): The feature ID.
  • Subscription ID (billingSubscriptionId): A unique identifier for your subscription to HERE. A subscription is the customer owned, technical instance of a product (no pricing etc. details). It is created to provision the purchased product and to report usage to the underlying billing system.
  • Resource ID (resourceHrn): Details provided for the type of usage.
  • Item description (name): A name for the item.
  • Unit (valueDriver):
  • Project ID (projectHrn): (Optional) A unique identifier to manage work and resources that can be applied.
  • Billing Tag (billingTag): a unique string used for combining expenses.
  • Usage amount (billableValue): How much billable usage has accrued.

For partners, an additional column is added in the csv output. The additional column is the name of the organization, orgName.

results matching ""

    No results matching ""