GuidesAPI Reference
Guides

Request tracing

X-Request-Id

You can tag your requests with a request identifier using the non-standard HTTP header X-Request-Id. The service will forward this value to the response regardless of whether it is a success or a failure. While you can use any string as the request identifier, HERE recommends using a UUID to uniquely identify your requests or groups of requests.

X-Correlation-Id

In addition to the X-Request-Id http header, the service response also carries a X-Correlation-Id http header. This is an auto-generated identifier that is unique to every request.

Request tracing use-cases

Some sample request tracing use-cases include:

  • Providing either the X-Request-Id or X-Correlation-Id when filing a bug or posting a question about a specific request to the HERE support service.
  • Grouping correlated requests could be tagged with the same X-Request-Id to establish a correlation.
  • If you have your own request tracing identifier, pass this value as the X-Request-Id to continue the tracing through the service.