Skip to content

List sales territories

GET/sales/territories

Returns all sales territories ordered alphabetically, enriched with deal counts, open pipeline value, and revenue won in the last 90 days. Use this to compare territory performance and assign or reassign territory managers.

Request

This endpoint takes no parameters and no request body.

Responses

200 List of territories with aggregated deal metrics

Content type application/json, object.

FieldTypeRequiredDescription
dataarray of object · SalesTerritoryV1No
data[].idintegerNo

Auto-incremented primary key.

data[].namestringNo

Full territory name.

Example: "Greater Accra"

data[].codestring, nullableNo

Short uppercase identifier.

Example: "GHA-ACC"

data[].manager_user_idinteger, nullableNo

ID of the territory manager user.

Example: 7

data[].descriptionstring, nullableNo

Extended description of the territory's scope.

data[].statusstringNo

Whether the territory is currently in use.

One of: "active", "inactive" · Example: "active"

data[].notesstring, nullableNo

Internal operator notes.

data[].deals_countintegerNo

Total number of deals assigned to this territory.

Example: 24

data[].open_deals_countintegerNo

Number of open (in-progress) deals.

Example: 18

data[].open_pipeline_valuenumberNo

Sum of deal values for all open deals in this territory.

Example: 85000.0

data[].won_90d_valuenumberNo

Revenue won from this territory in the past 90 days.

Example: 32000.0

data[].created_atstring (date-time)No

Record creation timestamp.

Example

{
  "data": [
    {
      "id": 3,
      "name": "Greater Accra",
      "code": "GHA-ACC",
      "manager_user_id": 7,
      "description": "Primary commercial territory covering Accra metro area.",
      "status": "active",
      "deals_count": 24,
      "open_deals_count": 18,
      "open_pipeline_value": 85000.0,
      "won_90d_value": 32000.0,
      "notes": null,
      "created_at": "2026-01-10T08:00:00Z"
    }
  ]
}

401 Unauthenticated

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/sales/territories" \
  -H "Accept: application/json"
Loading