---
title: "List the network's DSP partners"
type: reference
method: GET
path: /rest-api/dsp-partners.do
tag: "DSP Partners"
---

# List the network's DSP partners

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

Every OpenRTB demand partner this network bids into, newest id last, with the settings the console's DSP partners page shows: whether it is switched on, its bid endpoint, its type, its bid and win-notice timeouts, its QPS cap, what it is billed on, the OpenRTB and native protocol versions, the encryption of the macros it is sent, second-price, header bidding, gzip, click-through wrapping, user matching, its currency and any contractual rate, its supply-chain domain, whether analytics are pulled from it, and which provider scans its creatives. The answer carries total and more, so a cut list is never read as the whole of it. A partner's analytics-sync connection parameters and its per-partner parameters are on the single-partner read, which is also what to read back after a change. editable says whether this caller may change a partner as well as read one: the console grants reading and changing a partner together, under the one DSP Partners permission, so a caller this operation answers at all may also change what it answers. Requires the DSP Partners permission -- the admin one, or the account area's RTB DSP partners grant.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `name` | string | no | `TrafficStars` | Only partners whose name contains this, ignoring case |
| `active` | boolean | no | `true` | true for the partners that are switched on, false for the retired ones; left out, both |
| `start` | integer | no | `0` | Skip this many partners (zero-based position in the name-ordered list). Default 0 |
| `limit` | integer | no | `50` | How many partners to return, 1-500. Default 50 |

## Responses

- `200` — {success, editable, partners:[{id, name, active, url, ...}], returned, total, more}
- `400` — limit outside 1-500 or start below 0
- `401` — Authentication error
- `403` — The caller does not hold the DSP Partners permission

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/dsp-partners.do?name=TrafficStars&active=true&start=0' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/dsp-partners/get-dsp-partners