Get the Identifier of the Directory Where Deal Stages are Stored: crm.dealcategory.status
Choose a tool for developing with an AI agent:
- use Alaio Vibecode to build an app for Bitrix24 from a task description without knowing any programming language. The agent writes the code and deploys the app to a server, with no manual hosting setup
- use the MCP server to develop a REST API integration in your own project. The agent refers to 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>';
// client and ctx are already created — see the Go SDK section
res, err := client.Core().Call(ctx, "crm.dealcategory.status", b24.Params{
"id": "1",
})
if err != nil {
return fmt.Errorf("crm.dealcategory.status: %w", err)
}
// The response arrives as json.RawMessage — unmarshal it
// into a struct matching the response shape shown below on this page.
fmt.Printf("%s\n", res.Result)