---
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`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/ad_accounts/{ad_account_id}/conversion_eqs`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://www.pinterest.com/oauth/`
    - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `ads:read`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.pinterest.com/v3/oauth/access_token/` scopes: `ads:read`
- TypeScript: <https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/conversion_eqs/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Changes

- **2025-12-11** (v5) `79f62f71f05b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/conversion_eqs/get.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/b698c180678a?raw)