---
title: "Search CPM floor rates"
type: reference
method: GET
path: /rest-api/floorCPMs.do
tag: "Pricing"
---

# Search CPM floor rates

`GET https://YOUR-NETWORK-DOMAIN/rest-api/floorCPMs.do`

Retrieves a list of self-serve CPM floor rates filtered by campaign type, operating system, world region, and geo-location country codes. The query parameters are bound into a CampaignCpmFloorRateQuery object; if the region parameter is specified, the region is resolved to its constituent country codes before filtering. A missing or unknown campaignType or os is answered with a 400 naming it. Requires REST API authentication.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `campaignType` | integer | yes | `1` | Self-Serve campaign type ID (1=BANNER_DESKTOP, 2=BANNER_MOBILE, 3=BANNER_APPLICATION, 4=BANNER_NATIVE, 5=POP_UNDER, 6=INTERSTITIAL_MOBILE, 7=INTERSTITIAL_APPLICATION) |
| `os` | integer | yes | `1` | Operating system ID, as listed by the operating-system targeting values |
| `geo` | array<string> | no | `US` | Array of country codes, '*' being global |
| `region` | integer | no | `150` | World region ID — resolves to constituent country codes |

## Responses

- `200` — CPM floor rates retrieved successfully as a JSON array of CampaignCpmFloorRate objects
- `400` — Missing or invalid required parameters (campaignType, os)
- `401` — Authentication error - invalid hash, timestamp, or username
- `403` — Insufficient permissions to access this resource
- `500` — Internal server error during rate lookup
- `503` — The geo service did not answer while resolving the region

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/floorCPMs.do?campaignType=1&os=1&geo=US&region=150' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/pricing/get-floorcpms