# Retrieve computers pending approval

Retrieves computers pending approval or with a specific approval status. Used in the computer approval workflow. Supports filtering by approval status and computer name.

## Endpoints

GET `/dcapi/som/approval/computers-info`

## Request URL

`https://{server-hostname}:8383/dcapi/som/approval/computers-info`

## Scope

`SOM.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** (`string`, Mandatory): `application/approvalComputersRes.v1+json`

## Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/som/approval/computers-info \
  --header 'Accept: application/approvalComputersRes.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

#### Response Body: `application/json`

- `JSON Object`
  - **total** (`string`): Total number of computer records matching the specified filter criteria across all pages
  - **computerInfo** (`JSON Array`): Array of computer information objects for the current page, each containing details about the computer's approval status, network configuration, and domain membership
  - **page** (`string`): Current page number in the paginated result set (1-based)

### HTTP code 401

#### Response Body: `application/json`

- `JSON Object`
  - **errorCode** (`long`): Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
  - **errorMsg** (`string`): Authentication failure reason

## Possible Response Codes

- **200**: HTTP code
- **401**: HTTP code

## Sample Response: HTTP 200

Computers pending approval

```json
{
  "total": 30,
  "computerInfo": [
    {
      "approvalStatus": 3,
      "resourceID": "3009",
      "servicePack": "--",
      "fqdn": "--",
      "ipAddress": "--",
      "dbUpdatedTime": "1776060255784",
      "computerFullName": "AlvaroSantiago",
      "osName": "--",
      "subnetMask": "--",
      "uuId": "--",
      "customerName": "DC_CUSTOMER",
      "macAddress": "--",
      "osVersion": "--",
      "computerName": "AlvaroSantiago",
      "dbAddedTime": "1776060255606",
      "domainName": "WORKGROUP",
      "guid": "--",
      "remoteOfficeName": "Local Office",
      "remoteIpAddr": "127.0.0.1"
    }
  ],
  "page": 1
}
```

## Sample Response: HTTP 401

User not authorized to view these computers

```json
{
  "errorCode": "1001",
  "message": "User is not authorized to access the requested computers",
  "statusCode": 401
}
```

## API Rate Limits

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.