---
title: "Get OS version values — advertiser"
type: reference
method: GET
path: /rest-api/advertiser/{advertiserId}/targeting/operating-system/{osName}/versions.do
tag: "Targeting Rules"
---

# Get OS version values — advertiser

`GET https://YOUR-NETWORK-DOMAIN/rest-api/advertiser/{advertiserId}/targeting/operating-system/{osName}/versions.do`

Returns a JSON array of available version values for the specified operating system. The osName must match one of the values returned by the OS values endpoint. Requires UPDATE permission on the advertiser and MANAGE_DEMAND_TARGETING user permission.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `advertiserId` | integer | yes | `1234` | Unique numeric ID of the advertiser |
| `osName` | string | yes | `WINDOWS` | Operating system. Accepts enum name or integer ID for backward compatibility |

## Responses

- `200` — Success
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Advertiser not found
- `500` — Internal server error

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/advertiser/1234/targeting/operating-system/WINDOWS/versions.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/targeting-rules/get-advertiser-targeting-operating-system-versions