---
title: "Get event quality score (EQS)"
method: GET
path: "/ad_accounts/{ad_account_id}/conversion_eqs"
tags: ["conversion_eqs"]
---

# Get event quality score (EQS)

`GET /ad_accounts/{ad_account_id}/conversion_eqs`

Get the Event Quality Score (EQS) of your conversion signals.

[Event Quality Score](https://help.pinterest.com/en/business/article/eqs) indicates how effective the customer information and event insights (metadata) passed with your web, app and offline conversion events may be at matching to a Pinterest user.

## Path parameters

- `ad_account_id` string, required

## Query parameters

- `lookback_period` '1d' | '14d', required — Days in lookback window in the GET Conversion EQS response.
- `source_platform` 'WEB' | 'MOBILE' | 'MOBILE_ANDROID' | 'MOBILE_IOS' | 'OFFLINE' | 'PINTEREST_WEB' | 'PINTEREST_ANDROID' | 'PINTEREST_IOS' | 'POINT_OF_SALE' — List of source platforms for a conversion event.
- `ingestion_source` 'TAG' | 'MMP' | 'FILE_UPLOAD' | 'CONVERSIONS_API' | 'NATIVE' — List of ingestion sources for a conversion event.

## Response `200`

The request has succeeded.

- EventQualityScore[]
  - `ingestion_source` 'TAG' | 'MMP' | 'FILE_UPLOAD' | 'CONVERSIONS_API' | 'NATIVE', required — List of ingestion sources for a conversion event.
  - `lookback_period` '1d' | '14d', required — Days in lookback window in the GET Conversion EQS response.
  - `overall_status` 'NEEDS_IMPROVEMENT' | 'FAIR' | 'GOOD', required — Overall status of event quality score.
  - `quality_components` QualityComponents, required — Set of quality components, with each component containing a event coverage and details.
    - `advertiser_external_id` object
    - `click_id_epik` object
    - `external_event_id` object — Dedup components.
    - `hashed_email` object — User matching identifiers.
    - `hashed_maid` object
    - `ip_address` object
    - `order_id` object
    - `order_value` object
    - `product_id` object — Product/event metadata.
    - `source_url` object
    - `user_agent` object
  - `source_platform` 'WEB' | 'MOBILE' | 'MOBILE_ANDROID' | 'MOBILE_IOS' | 'OFFLINE' | 'PINTEREST_WEB' | 'PINTEREST_ANDROID' | 'PINTEREST_IOS' | 'POINT_OF_SALE', required — List of source platforms for a conversion event.

## Other responses

- `400` — The request could not be understood by the server due to unexpected data.
- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404` — The requested resource could not be found on this server.
- `429` — The user has sent too many requests in a given amount of time and is being rate limited.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)