---
title: "Get Territory Match"
method: POST
path: "/jobs/territory/match"
---

# Get Territory Match

`POST /jobs/territory/match`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/jobs/territory/match`
- Auth: API key in header `x-api-key`

Dry-run territory matcher: finds which Service Territory an address/assignment would match, without creating or touching any Job record. Useful for previewing territory assignment before a job exists.

`customer_address` must contain whichever location field the matching territory type needs: `zip_code` for ZIPCODE territories, or `geo_cordinates` ([lat, lng]) for RADIUS/GEOFENCE territories.

## Request body

- object
  - `customer_address` object, required: Must include zip_code and/or geo_cordinates depending on the territory type(s) configured for the company.
    - `label` string
    - `first_name` string
    - `last_name` string
    - `phone_number` string
    - `email` string
    - `city` string
    - `state` string
    - `street` string
    - `country` string
    - `landmark` string
    - `zip_code` string
    - `geo_cordinates` number[]: [latitude, longitude]
    - `is_primary` boolean
  - `assigned_to` object[]: Optional. Each entry is validated: both user and team must exist/be active, and the user must actually belong to the team.
    - `user_uid` string
    - `team_uid` string

## Response `200`

200

- object
  - `type` string
  - `data` object
    - `matched_territory` object
      - `territory` object: The best-matching Service Territory, if one was found.
      - `is_conflict` boolean
      - `conflicts` string[]
    - `conflict_territory` object[]: One entry per other active territory whose boundary also contains the address, same shape as matched_territory.

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/jobs/territory/match/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)