Lifecycle Stage Object

Lifecycle stages define the steps on a sales journey. In Pardot, we define the following lifecycle stages:

  • Visitor
  • Prospect
  • Marketing qualified lead (MQL)
  • Sales qualified lead (SQL)
  • Won opportunity Use lifecycle stage resources to learn about a prospect's current lifecycle stage, including the stage name and position. Learn more about prospect lifecycles in Salesforce Help.
OperationHTTP VerbURL FormatAbility Requirements
ReadGEThttps://pi.pardot.com/api/v5/objects/lifecycle-stages/<id>?<params>Prospect > Lifecycle > View Report ability
QueryGEThttps://pi.pardot.com/api/v5/objects/lifecycle-stages?<params>Prospect > Lifecycle > View Report ability

Read-Only Fields

FieldTypeDescription
idIntegerID of the lifecycle stage.
nameStringPardot ID of this lifecycle stage.
isDeletedBooleanTrue if the lifecycle stage is in the recycle bin in Pardot.
createdAtDateTimeCreation time of the lifecycle stage.
updatedAtDateTimeLast updated time for the lifecycle stage.
isLockedBooleanWhen true, lifecycle stage is locked.
positionIntegerLifcycle stage's position in lifecycle.
matchTypeEnumMatch all is returned when a prospect must match all rules in order to be in this stage. Match any is returned when a prospect can match 1 or more rules

Retrieve a single lifecycle stage following the conventions described in the Version 5 Overview.

Example request:

Example response:

Retrieving a collection of lifecycle stages follows the conventions described in Version 5 Overview.

Sortable Fields

When executing a query, the following fields can be specified in the orderBy parameter. See the conventions for query described in the Version 5 Overview.

  • id
  • createdAt
  • updatedAt

Example request:

Example response:

Filtering Results

When executing a query, the following parameters can be used to filter the returned results. These parameters can be specified in the request along with any shared parameters defined in Version 5 Overview. When specifying more than one parameter, all parameters must match the record in order for it to be returned in the results.

ParameterDescription
idReturns any lifecycle stage where ID is equal to the given integer value.
idGreaterThanReturns any lifecycle stages where ID is greater than the specified value, non-inclusive.
idGreaterThanOrEqualToReturns any lifecycle stages where ID is greater than or equal to the specified value.
idLessThanReturns any lifecycle stages where ID is less than the specified value, non-inclusive.
idLessThanOrEqualToReturns any lifecycle stages where ID is less than or equal to the specified value.
createdAtReturns any lifecycle stage where CreatedAt is equal to the given datetime value.
createdAtAfterReturns any lifecycle stage where CreatedAt is after the given datetime value, non-inclusive.
createdAtAfterOrEqualToReturns any lifecycle stage where CreatedAt is after or equal to the given datetime value.
createdAtBeforeReturns any lifecycle stage where CreatedAt is before the given datetime value, non-inclusive.
createdAtBeforeOrEqualToReturns any lifecycle stage where CreatedAt is before or equal to the given datetime value.
updatedAtReturns any lifecycle stage where UpdatedAt is equal to the given datetime value.
updatedAtAfterReturns any lifecycle stage where UpdatedAt is after the given datetime value, non-inclusive.
updatedAtAfterOrEqualToReturns any lifecycle stage where UpdatedAt is after or equal to the given datetime value.
updatedAtBeforeReturns any lifecycle stage where UpdatedAt is before the given datetime value, non-inclusive.
updatedAtBeforeOrEqualToReturns any lifecycle stage where UpdatedAt is before or equal to the given datetime value.

Example request:

Example response: