---
schema_version: "1"
id: 9d5e8f00857e3dfc5c3ccd9f9c6b80af086b775a3d6711b914a093ce50171455
title: LeadStatus
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_leadstatus.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_leadstatus.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 702ffec18d48008242f740e7e95ead1391ceac75c393b12332d10a685b39428e
description: Represents the status of a Lead record, such as Open, Qualified, or Converted.
---
# LeadStatus

Represents the status of a Lead record, such as Open, Qualified, or Converted.

![Important](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note_important.png)

#### Important

Where possible, we changed noninclusive terms to align with our company value of Equality. Because changing terms in our code can break current implementations, we maintained this object’s name.

## Supported Calls

describeSObjects(), query(), retrieve()

## Fields

| Field | Details |
| --- | --- |
| ApiName | 
Type

string

Properties

Filter, Group, idLookup, Sort

Description

Uniquely identifies a picklist value so it can be retrieved without using an id or primary label.



 |
| IsConverted | 

Type

boolean

Properties

Defaulted on create, Filter, Group, Sort

Description

Indicates whether this lead status value represents a converted lead (true) or not (false). Multiple lead status values can represent a converted lead.



 |
| IsDefault | 

Type

boolean

Properties

Defaulted on create, Filter, Group, Sort

Description

Indicates whether this is the default lead status value (true) or not (false) in the picklist.



 |
| MasterLabel | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

Label for this lead status value. This display value is the internal label that does not get translated.



 |
| SortOrder | 

Type

int

Properties

Filter, Group, Nillable, Sort

Description

Number used to sort this value in the lead status picklist. These numbers are not guaranteed to be sequential, as some previous lead status values might have been deleted.



 |

## Usage

This object represents a value in the lead status picklist (see [Lead](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_lead.htm "Represents a prospect or lead.")). The lead status picklist provides additional information about the status of a [Lead](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_lead.htm "Represents a prospect or lead."), such as whether a given status value represents a converted [Lead](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_lead.htm "Represents a prospect or lead."). Query this object to retrieve the set of values in the lead status picklist, and then use that information while processing [Lead](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_lead.htm "Represents a prospect or lead.") objects to determine more information about a given lead. For example, the application could test whether a given lead is converted based on its Status value and the value of the IsConverted property in the associated LeadStatus record.

#### See Also

- [LeadOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_leadownersharingrule.htm "Represents the rules for sharing a lead with users other than the owner.")
- [LeadShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_leadshare.htm "Represents a sharing entry on a Lead.")