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

[HannahM]

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

• Summary
• Problem
• Resolution
• Steps
• What's Next?
• Related reading

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

1. Retrieve the decimal locationId from the HTTP Monitor execution API output
2. Convert decimal → hexadecimal (any standard converter works)
   Example:
   54 (decimal) → 34 (hex)
3. 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

4. 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