List selected process fields

GET

/processes/list

Last modified:2026-10-30 21:18:06

OperationId:listProcessesFields

Returns the same rows as GET /processes, reduced to the fields named in fields. Requires Super User or Super User Read Only scope. An unknown parameter is ignored, so a misspelled filter returns every row.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

The matching processes, reduced to the named fields. An empty array when none match.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/processes/list?fields=process-element-id%2Cprocess-application%2Cprocess-hostname%2Cprocess-status&process-application=SiPbx&process-hostname=core1.example.com&limit=1000&process-element-id=sipbx&process-element-type=SiPbx&process-element-version=v46-0-0x100&process-status=Running&process-mac-address=00%3A00%3A5E%3A00%3A53%3A01&process-ip-address=192.0.2.10&process-domain-db=sipbx&start=undefined&sort=element_status%20asc%2Chostname%20asc' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Selected fields

With fields=process-element-id,process-application,process-hostname,process-status.

[
    {
        "process-element-id": "sipbx",
        "process-application": "SiPbx",
        "process-hostname": "core1.example.com",
        "process-status": "Running"
    },
    {
        "process-element-id": "ncs",
        "process-application": "NCS",
        "process-hostname": "core1.example.com",
        "process-status": "Running"
    },
    {
        "process-element-id": "sipbx",
        "process-application": "SiPbx",
        "process-hostname": "core2.example.com",
        "process-status": "Running"
    }
]

Modified at 2026-10-30 21:18:06

Count processes

List controllable services