---
schema_version: "1"
id: 31ea654014fd13fc189d697c723ea340fdcedc46619f0fe1299b442ca60f7e24
title: CaseStatus
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_casestatus.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_casestatus.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 95bba91ffbb714f6a5a1a1ca2f3f889ce4693b60e506fa9f112478ea426f25b8
description: Represents the status of a Case, such as New, On Hold, or In Process.
---
# CaseStatus

Represents the status of a Case, such as New, On Hold, or In Process.

![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.



 |
| IsClosed | 

Type

boolean

Properties

Defaulted on create, Filter, Group, Sort

Description

Indicates whether this case status value represents a closed Case (true) or not (false). Multiple case status values can represent a closed Case.



 |
| IsDefault | 

Type

boolean

Properties

Defaulted on create, Filter, Group, Sort

Description

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



 |
| MasterLabel | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

Label for this case 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 case status picklist. These numbers are not guaranteed to be sequential, as some previous case status values might have been deleted.



 |

## Usage

This object represents a value in the case status picklist. The case status picklist provides additional information about the status of a Case, such as whether a given Status value represents an open or closed case. Query the CaseStatus object to retrieve the set of values in the case status picklist, and then use that information while processing Case records to determine more information about a given case. For example, the application could test whether a given case is open or closed based on its Status value and the value of the IsClosed property in the associated CaseStatus object.

#### See Also

- [Overview of Salesforce Objects and Fields](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_concepts.htm "Salesforce objects and fields are analogous to database tables and the table columns. Objects and fields structure data. For example, the central object in the Salesforce data model represents accounts—companies and organizations involved with your business, such as customers, partners, and competitors.")