Get lead stage pipeline

Returns the workspace's lead stage pipeline — every stage, every status (active and archived), and the configured lost reasons.

Use this to discover valid values for the status field on leads and valid lost reasons for leads in LOST stages.

Request

Field	Value
Method	GET
URL	https://next.telecrm.in/autoupdate/v2/enterprise/{enterpriseId}/lead-stage-pipeline
Auth	Bearer token (Sync-typed). See Authentication.

Path parameters

Name	Type	Required	Description
enterpriseId	string	yes	The enterprise (workspace) ID.

Example request

curl "https://next.telecrm.in/autoupdate/v2/enterprise/{enterpriseId}/lead-stage-pipeline" \
  -H "Authorization: Bearer YOUR_SYNC_TOKEN"

Responses

200 OK

{
  "leadStages": [
    {
      "stageid": "stage_open_1",
      "stageType": "OPEN",
      "visibility": true,
      "activeStatuses": [
        { "statusid": 1, "label": "Fresh", "color": "#FF5733" },
        { "statusid": 2, "label": "Contacted", "color": "#33A8FF" },
        { "statusid": 3, "label": "Qualified", "color": "#33FF57" }
      ],
      "archivedStatuses": []
    },
    {
      "stageid": "stage_won_1",
      "stageType": "WON",
      "visibility": true,
      "activeStatuses": [
        { "statusid": 10, "label": "Won", "color": "#28A745" }
      ],
      "archivedStatuses": []
    },
    {
      "stageid": "stage_lost_1",
      "stageType": "LOST",
      "visibility": true,
      "activeStatuses": [
        { "statusid": 20, "label": "Lost", "color": "#DC3545" }
      ],
      "archivedStatuses": []
    }
  ],
  "activeLeadLostReasons": [
    { "reasonid": 1, "reasonLabel": "Price too high", "isDefault": false },
    { "reasonid": 2, "reasonLabel": "No Need", "isDefault": false }
  ],
  "archivedLeadLostReasons": [],
  "creationTimestamp": 1609459200000,
  "modificationTimestamp": 1735689600000,
  "lastModifiedBy": "admin@example.com",
  "version": 3
}

401 Unauthorized

See the universal 401 in the overview.

404 Not Found

{
  "error": {
    "code": "ENTERPRISE_NOT_FOUND",
    "message": "The enterprise with ID 62ab16e was not found."
  }
}

Notes

• stageType enum: OPEN, WON, LOST.
• activeStatuses[].label is the value to send in lead.fields.status on create and update calls. Labels are case-sensitive.
• archivedStatuses are still returned for historical leads but cannot be used as values on new leads.
• activeLeadLostReasons[].reasonLabel is the value to use for the workspace's lost-reason field. Only meaningful when the lead's status belongs to a LOST stage. See Field Types → lostReason.
• See Pitfalls for archived* handling.