Get the Identifier of the Directory Where Deal Stages are Stored: crm.dealcategory.status
If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.
Scope:
crmWho can execute the method: any user
DEPRECATED
The development of this method has been halted. Please use crm.category.*.
This method returns the identifier of the directory for storing stages based on the deal direction identifier.
The identifier is a string of the format DEAL_STAGE_[Direction Identifier]. For example, for a direction with an identifier of 1, the string "DEAL_STAGE_1" will be returned.
The identifier is intended for use with the family of methods crm.status.*. For instance, to create a new stage for a direction, you need to pass it to the method crm.status.add as the ENTITY_ID parameter.
Method Parameters
Required parameters are marked with *
|
Name |
Description |
|
id |
Direction identifier |
Code Examples
How to Use Examples in Documentation
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":"1"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.dealcategory.status
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":"1","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.dealcategory.status
try
{
const response = await $b24.callMethod(
"crm.dealcategory.status",
{ id: id }
);
const result = response.getData().result;
if(result.error())
{
console.error(result.error());
}
else
{
console.dir(result);
}
}
catch(error)
{
console.error('Error:', error);
}
try {
$response = $b24Service
->core
->call(
'crm.dealcategory.status',
[
'id' => $id,
]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error());
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error fetching deal category status: ' . $e->getMessage();
}
BX24.callMethod(
"crm.dealcategory.status",
{ id: id },
function(result)
{
if(result.error())
console.error(result.error());
else
console.dir(result.data());
}
);
require_once('crest.php');
$id = 1; // Replace 1 with the actual ID
$result = CRest::call(
'crm.dealcategory.status',
[
'id' => $id
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';