{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/servicetitan/main/json-schema/servicetitan-location-schema.json",
  "title": "ServiceTitan Location",
  "description": "Customer service location (physical address) for jobs, equipment, memberships, and contracts.",
  "type": "object",
  "required": ["id", "customerId", "address"],
  "properties": {
    "id": { "type": "integer", "format": "int64" },
    "customerId": { "type": "integer", "format": "int64" },
    "active": { "type": "boolean" },
    "name": { "type": "string", "description": "Location alias; defaults to address" },
    "address": {
      "type": "object",
      "properties": {
        "street": { "type": "string" },
        "unit": { "type": ["string", "null"] },
        "city": { "type": "string" },
        "state": { "type": "string" },
        "zip": { "type": "string" },
        "country": { "type": "string" },
        "latitude": { "type": ["number", "null"] },
        "longitude": { "type": ["number", "null"] }
      }
    },
    "zoneId": { "type": ["integer", "null"] },
    "taxZoneId": { "type": ["integer", "null"] },
    "createdOn": { "type": "string", "format": "date-time" },
    "modifiedOn": { "type": "string", "format": "date-time" },
    "contacts": {
      "type": "array",
      "items": { "type": "object" }
    },
    "customFields": {
      "type": "array",
      "items": { "type": "object" }
    }
  }
}