Locations

Retrieve a Location

Changed on

OAuth Scope

This endpoint requires the following OAuth scope read_locations.

get/location/{uuid}.json

Request

  • Base URL
    https://api.servicem8.com/api_1.0
  • URL
    https://api.servicem8.com/api_1.0/location/{uuid}.json
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.servicem8.com/oauth/authorize
      Token URL: https://api.servicem8.com/oauth/access_token scopes: read_locations

Path parameters

uuidstring uuid required

UUID of the Location

Response

Location record retrieved successfully

namestring required

Location's name

line1string

First line of the location's address. Contains the street number and street name.

line2string

Second line of the location's address. Used for additional address information such as building/suite numbers or street details.

line3string

Third line of the location's address. Used for additional address details when line1 and line2 are not sufficient.

citystring

Email Address

countrystring

Email Address

post_codestring

Email Address

phone_1string

Primary contact phone number for the location. Can include formatting characters.

statestring

Address State

lngnumber float

Longitude coordinate of the location in decimal degrees format. Used for geolocation and distance calculations. Expected range is between -180 and 180 degrees.

latnumber float

Latitude coordinate of the location in decimal degrees format. Used for geolocation and distance calculations. Expected range is between -90 and 90 degrees.

uuidstring uuid

Unique identifier for this record

active0 | 1

Record active/deleted flag. Valid values are [0,1]

edit_datestring

Timestamp at which record was last modified

Example response

{
  "uuid": "123e4567-1181-47f1-8ff1-23f94f3cd92b",
  "edit_date": "2026-03-01 12:00:00"
}

Changes

  • ca9b053c4373Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status