# 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.

## Endpoint

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

## Request URL

`https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/som/approval/computers-info`

## Scope

`DesktopCentralCloud.SOM.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

### Query Parameters

- **page** (`string`, Optional): Specifies the page number to retrieve. Default is 1.
- **limit** (`string`, Optional): Specifies the number of records per page. Default is 25 and maximum is 500.
- **approvalStatus** (`string`, Optional): Specifies the approval status code to filter by: `3=pending` (default: `3`).
- **computerName** (`string`, Optional): Specifies the computer name to filter approval computers.

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/som/approval/computers-info \
  --header 'Accept: application/approvalComputersRes.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  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: credentials missing, expired, or invalid.
  - **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
}
```

## Rate Limits

**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.