---
title: "Approved Merchants"
method: POST
path: "/summaries"
tags: ["Merchant Group Summaries"]
---

# Approved Merchants

`POST /summaries`

This endpoint is used to retrieve all approved merchants you can work with, including geo-specific rates and performance metrics.

## Query parameters

- `campaignId` integer, required

## Headers

- `Accept-Encoding` 'gzip'

## Request body

- MerchantGroupSummaryRequest
  - `filters` MerchantGroupSummaryFilter[]
    - `type` 'NAME' | 'GROUP_ID' | 'CATEGORY' | 'GEO' | 'PROGRAM_TYPE' | 'DOMAIN', required
    - `values` integer[], required — For GROUP_ID: Enter numbers directly (e.g., 384) For all other filters: Enter text values - the red highlight can be ignored for non-GROUP_ID filters
  - `page` integer, required
  - `pageSize` integer, required

## Response `200`

Successful operation

- IOCollectionResponse
  - `results` MerchantGroupSummaryResponse[]
    - `groupId` integer
    - `name` string
    - `description` string
    - `terms` string
    - `sovrnPreferred` boolean
    - `logoImageUrl` string
    - `category` string[]
    - `sovrn` NetworkSummary
      - `CPA` CPASummary[]
        - `geo` string
        - `averageEpc` number, float
        - `averageOrderValue` number, float
        - `calculatedCommissionRate` number, float
        - `rates` MerchantRateDto[]
          - `currentRate` number, double
          - `rateFormat` string
          - `action` string
          - `details` string
        - `domains` string[]
      - `CPC` CPCSummary
        - `calculatedEpc` number, float
  - `page` integer
  - `perPage` integer
  - `totalItems` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — User not found
- `429` — Too many requests (rate limit exceeded)
- `500` — Internal server error

---

[API](https://skmtc.dev/sovrn/apis/rest.md) · [All operations](https://skmtc.dev/sovrn/apis/rest/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sovrn/rest/revisions/cb783ced960d/schema)
