article Synthetic Monitoring: How to Convert Location IDs Between HTTP Monitors execution API and the Locations API in Troubleshooting

Synthetic Monitoring: How to Convert Location IDs Between HTTP Monitors execution API and the Locations API

HannahM — Tue, 24 Feb 2026 20:04:52 GMT

Summary

When working with the Synthetic monitor executions API v2 - GET HTTP monitor and the Synthetic locations API v2, you may notice that location IDs don’t match.
This happens because:

The HTTP Monitor executions API returns location IDs in decimal
The Locations API uses hexadecimal location IDs

To query location details using the ID from a monitor execution, you must convert the decimal ID → hexadecimal and prepend the required prefix.

Example:
54 (decimal) → 34 (hex) → SYNTHETIC_LOCATION-0000000000000034

Problem

When retrieving execution details from the Synthetic monitor executions API v2 - GET HTTP monitor, the locationId field appears in decimal format, but when calling Synthetic locations API v2 - GET a location, the API expects a hexadecimal location ID.

This mismatch means that direct lookups are not possible unless the values are converted.

Resolution

Steps

Retrieve the decimal locationId from the HTTP Monitor execution API output
Convert decimal → hexadecimal (any standard converter works)
Example:
54 (decimal) → 34 (hex)
Apply the prefix: SYNTHETIC_LOCATION-00000000000000.
1. Apply zero-padding until the hex string is 16 characters long
  
  Final format required by the Locations API:
```
SYNTHETIC_LOCATION-0000000000000034
```
Add the location id to the Locations API call

What's Next?

If this article didn’t resolve your issue, please consider opening a support ticket.

Include:

A link to this article
The monitor execution payload (with locationId)
The request and full response body from your Locations API call
Any scripts or automated workflow where the mismatch occurs

This will help us diagnose formatting or data-transformation issues quickly.

Related reading

📖 Synthetic monitor executions API v2 - GET HTTP monitor

📖 Synthetic locations API v2

📖 Synthetic Troubleshooting Map

📖 HTTP Monitors (classic) documentation

📖 Latest Dynatrace Synthetic App