---
title: "Get entities from ChurnScoreFactor"
method: GET
path: "/ChurnScoreFactor"
tags: ["ChurnScoreFactor"]
---

# Get entities from ChurnScoreFactor

`GET /ChurnScoreFactor`

## Query parameters

- `$top` number
- `$skip` number
- `$filter` string[]
- `$count` boolean
- `$orderby` string[]
- `$select` string[]
- `$expand` string[]
- `$apply` string

## Parameters

- `#/components/parameters/search` — unresolved $ref

## Response `200`

Retrieved entities

- object
  - `value` ChurnZeroChurnScoreFactor[]
    - `Id` number — Internal identifier for ChurnZero.
    - `ChurnScoreFactorType` 'EventCount' | 'SegmentBonus' | 'ActiveContacts' | 'LicenseUtilization' | 'Tenure' | 'RenewalAmount' | 'TimeInApp' | 'ActiveDays' | 'AccountAttribute' | 'TaskLoggedActivities' | 'TaskMostRecentActivity' | 'CustomTable' | 'NumberOfContactMessagesSent' | 'MostRecentMessageSent' | 'JourneyProgress' | 'NumberOfContactMessagesReceived' | 'MostRecentMessageReceived' | 'NumberOfContactMessagesSentOrReceived' | 'MostRecentMessageSentOrReceived' | 'SurveyScore' | 'SuccessInsights' | 'NumberOfNotes' | 'MostRecentNoteDaysFromToday' | 'ChurnScore' | 'FamilyPrimaryChurnScores' | 'NumberOfMeetings' | 'NextUpcomingMeeting' | 'MostRecentPastMeeting' | 'PercentOfSuccessPlanGoalsAchieved' | 'NumberOfSuccessPlanGoals' | 'NumberOfSuccessPlans' | 'PercentOfSuccessPlansClosed' | 'MostRecentSignalDaysFromToday' | 'NumberOfSignals' — The kind of signal this factor measures, as a string (e.g. EventCount, ActiveContacts, LicenseUtilization, Tenure, SurveyScore, JourneyProgress, ChurnScore — the last being a composite factor built from another ChurnScore).
    - `ChurnScoreId` number — The Id of the ChurnScore this factor belongs to; see the ChurnScore entity.
    - `Name` string — The display name of the Churn Score Factor, as configured by the admin.
    - `Journey` object, nullable — An account-level project plan that tracks a phase of the customer lifecycle (e.g. onboarding, adoption, expansion). Composed of Milestones containing Tasks and Achievements. Journeys target Accounts only, do not send customer communications, and are timeline-based but not bound to a fixed timeframe — they're used to track progress and detect stalls.
      - `Id` number — Internal identifier for ChurnZero.
      - `Description` string — The description for the Journey.
      - `ExpectedDuration` number — The number of days an Account is expected to be in the Journey.
      - `IsActive` boolean — True if the Journey is currently running and being evaluated. Kept in sync with Status: activating a Draft or Paused Journey sets Status to Running, and deactivating a Running Journey sets Status to Paused.
      - `IsSharedExternally` boolean — True if this Journey is configured for external sharing, which lets designated customer contacts view the Journey's progress and externally visible steps outside of ChurnZero.
      - `Name` string — The name of the Journey.
      - `ObjectCreatedDate` string, date-time — The date/time the Journey record was created. ISO 8601 formatted string.
      - `ObjectLastModifiedDate` string, date-time — The date/time the Journey record was last modified. ISO 8601 formatted string.
      - `ProgressBottom` number — Progress Scale threshold, in days from the Account's Journey start (Days In). An Account at or below this many days is 'On Track'; beyond it is 'Behind'. (Set per Journey in the Progress Scale; need not be a fixed fraction of ExpectedDuration.)
      - `ProgressTop` number — Progress Scale threshold, in days from the Account's Journey start (Days In). Beyond this the Account is 'Stuck'; between ProgressBottom and ProgressTop it is 'Behind'. Note an Account's overall Journey Status (JourneyProgress.Status) is also raised to the worst of its in-progress Milestones, so it can read 'Stuck' before Days In reaches ProgressTop.
      - `Status` string — The Journey's configuration lifecycle state: Draft, Paused, Running (shown as 'Active' in the ChurnZero UI), or MarkedForDeletion. This describes the Journey definition itself, NOT an Account's progress — an Account's On Track/Behind/Stuck progress status lives on the JourneyProgress entity's Status.
    - `ChurnScore` object, nullable — A ChurnScore definition — a configurable scoring framework that estimates an Account's likelihood to renew on a 0 (low risk) to 100 (high risk) scale. Composed of weighted ChurnScoreFactors that must sum to 100 points and graded on a red/yellow/green scale. May be Standard (built from raw signals) or Composite (built from other ChurnScores). Scores are recalculated nightly and only apply to Active Accounts.
      - `Id` number — Internal identifier for ChurnZero.
      - `ChurnScoreType` 'Standard' | 'Composite' | 'Family' — The type of Churn Score: Standard (built from raw signal factors), Composite (built from other ChurnScores used as weighted factors), or Family.
      - `GradingBottom` number — The lower cut point of the red/yellow/green grading scale: calculated scores at or below this value grade green (healthy / low churn risk).
      - `GradingTop` number — The upper cut point of the red/yellow/green grading scale: scores above GradingBottom and at or below this value grade yellow; scores above this value grade red (high churn risk).
      - `Name` string — The name of the Churn Score, as configured by the admin.
  - `@odata.nextLink` string

## Other responses

- `400` — Bad Request|This usually occurs because of a missing or malformed parameter. Check the documentation and the syntax of your request and try again.
- `401` — Unauthorized|A valid authentication token was not provided with the request, so the API could not associate a user with the request.
- `403` — Forbidden|The authentication and request syntax was valid but the server is refusing to complete the request. This can happen if you try to read or write to objects or properties that the user does not have access to.
- `409` — Conflict|The underlying model/schema has changed. Usually caused by a race condition. Sending the request again will succeed.
- `429` — Too Many Requests|You have exceeded one of the enforced rate limits in the API. See the documentation on rate limiting for more information.
- `500` — Internal Server Error|There was a problem on ChurnZeros's end.
- `default` — error

---

[API](https://skmtc.net/churnzero/apis/churnzero-rest-api-for-marketingpony.md) · [All operations](https://skmtc.net/churnzero/apis/churnzero-rest-api-for-marketingpony/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/churnzero/churnzero-rest-api-for-marketingpony/revisions/fa74265a328d/schema)