List quota plans
GET/sales/quotas
Returns all quota plans with their territory and owner user relations, enriched with forecast performance data (attainment %, won value, projected value). Use this to monitor progress against sales targets across territories and individual reps.
Request
This endpoint takes no parameters and no request body.
Responses
200 Quota plans with live performance metrics
Content type application/json, object.
| Field | Type | Required | Description |
|---|---|---|---|
data | array of object · QuotaPlanV1 | No | |
data[].id | integer | No | Auto-incremented primary key. |
data[].name | string | No | Descriptive plan label. Example: |
data[].territory_id | integer, nullable | No | Linked territory ID. Example: |
data[].owner_user_id | integer, nullable | No | Linked rep user ID for individual quotas. |
data[].currency | string | No | ISO 4217 currency code. Example: |
data[].period_start | string (date) | No | First day of the quota period. Example: |
data[].period_end | string (date) | No | Last day of the quota period. Example: |
data[].target_amount | number | No | Revenue target for the period. Example: |
data[].status | string | No | Lifecycle status. One of: |
data[].attainment_pct | number, nullable | No | Percentage of target attained as computed by the forecast engine. Example: |
data[].won_value | number, nullable | No | Actual revenue won so far this period. Example: |
data[].projected_value | number, nullable | No | Probability-weighted projected revenue for the full period. Example: |
data[].notes | string, nullable | No | Optional context notes. |
data[].created_by | integer, nullable | No | Tenant user ID who created the plan. |
data[].created_at | string (date-time) | No | Record creation timestamp. |
Example
{
"data": [
{
"id": 5,
"name": "Q2 2026 – Greater Accra",
"territory_id": 3,
"owner_user_id": null,
"currency": "GHS",
"period_start": "2026-04-01",
"period_end": "2026-06-30",
"target_amount": 150000,
"status": "active",
"attainment_pct": 38.5,
"won_value": 57750,
"projected_value": 112000,
"notes": null
}
]
}401 Unauthenticated
Example request
curl -X GET "https://{tenant}.faciotech.net/api/v1/sales/quotas" \
-H "Accept: application/json"