# Fetch a single CSS record by ID

Returns the complete Computer Specific Settings record, including domain, OU, user accounts, and profile backup details.

## Endpoint

`GET /emsapi/osdeployer/computersettings/{computerSettingsId}`

## Request

### Request URL

`https://{server-hostname}:8383/emsapi/osdeployer/computersettings/{computerSettingsId}`

### Scope

`OSDComputerSettings.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

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

#### Path Parameters

- **computerSettingsId** (`string`, Mandatory): ID of OS Deployment ComputerSettings

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/emsapi/osdeployer/computersettings/{computerSettingsId} \
  --header 'Accept: application/computerSettingsDetails.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

Response body: `application/computerSettings.v1+json`

- `JSON Object`
  - **serialOrMAC** (`string`): Serial number or MAC address of the machine this CSS record applies to.
  - **computerName** (`string`): Computer name configured for this machine. Present only if a computer name has been set.
  - **computerDescription** (`string`): Description configured for this machine. Present only if a description has been set.
  - **domainInfo** (`JSON Object`): Domain or workgroup join configuration. Present only if domain settings have been configured.
  - **ouInfo** (`JSON Object`): Active Directory OU placement. Present only if OU settings have been configured.
  - **userAccounts** (`JSON Object`): User account configuration. Present only if user accounts have been configured.
    - **deleteExistingUsers** (`boolean`): If true, existing local accounts are removed before applying this configuration.
  - **userProfileBackup** (`JSON Object`): User profile backup/restore configuration. Present only if profile backup has been configured.

### Possible Response Codes

- **200** (`HTTP code`)

### Sample Response: HTTP 200

CSS record with all optional sections populated; restored passwords are masked.

```json
{
  "userProfileBackup": {
    "backupID": 9001,
    "userProfiles": [
      {
        "password": "********",
        "backupUserID": 7
      }
    ]
  },
  "domainInfo": {
    "domainName": "corp.example.com",
    "credentialID": 50,
    "domainID": 1001
  },
  "computerName": "WIN-DESK-001",
  "serialOrMAC": "AA:BB:CC:DD:EE:FF",
  "ouInfo": {
    "distinguishedName": "OU=Sales,DC=corp,DC=example,DC=com",
    "ouName": "Sales"
  },
  "userAccounts": {
    "deleteExistingUsers": false,
    "localUsers": {
      "userIDs": [
        1,
        2
      ]
    },
    "domainUsers": [
      {
        "groupName": "Administrators",
        "guid": "abc-123",
        "userName": "jdoe"
      }
    ]
  },
  "computerDescription": "Sales laptop"
}
```

## Rate Limits

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

**Duration:** 1 minute | **Threshold:** 50 | **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.