Skip to main content

​
List Territories

Retrieve a paginated list of all territories in your workspace.
​
page
integer
default:"1"
Page number for pagination.
​
per_page
integer
default:"25"
Number of territories per page.
curl -X GET "https://api.pipelinegeneration.ai/v1/territories?page=1&per_page=10" \
  -H "x-api-key: your_api_key"

[
  {
    "id": "ter_abc123",
    "name": "Enterprise West Coast",
    "description": "West Coast enterprise accounts",
    "company_count": 156,
    "owner": "Jane Smith",
    "created_at": "2026-01-05T08:00:00Z"
  },
  {
    "id": "ter_def456",
    "name": "Mid-Market EMEA",
    "description": "EMEA mid-market segment",
    "company_count": 89,
    "owner": "John Doe",
    "created_at": "2026-01-10T12:00:00Z"
  }
]

​
Get Territory

Retrieve detailed information about a specific territory.
​
territory_id
string
required
The unique identifier of the territory.
curl -X GET "https://api.pipelinegeneration.ai/v1/territories/{territory_id}" \
  -H "x-api-key: your_api_key"

{
  "id": "ter_abc123",
  "name": "Enterprise West Coast",
  "description": "West Coast enterprise accounts",
  "company_count": 156,
  "owner": "Jane Smith",
  "scoring_model": "Enterprise ICP v2",
  "filters": {
    "region": "West Coast",
    "segment": "Enterprise"
  },
  "created_at": "2026-01-05T08:00:00Z",
  "updated_at": "2026-03-10T14:00:00Z"
}

​
List Territory Companies

Retrieve the companies that belong to a specific territory, with pagination.
​
territory_id
string
required
The unique identifier of the territory.
​
page
integer
default:"1"
Page number for pagination.
​
per_page
integer
default:"25"
Number of companies per page.
curl -X GET "https://api.pipelinegeneration.ai/v1/territories/{territory_id}/companies?page=1&per_page=20" \
  -H "x-api-key: your_api_key"

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Acme Corporation",
      "domain": "acme.com",
      "industry": "Technology",
      "employee_count": 5000,
      "score": 87,
      "tier": "A"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "name": "GlobalSoft",
      "domain": "globalsoft.io",
      "industry": "Software",
      "employee_count": 2500,
      "score": 72,
      "tier": "B"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 156
  }
}