---
title: "Politically exposed person (PEP) report matched"
method: POST
path: "reportEvents_webhook-report-politically-exposed-person-matched"
---

# Politically exposed person (PEP) report matched

`POST reportEvents_webhook-report-politically-exposed-person-matched` (webhook)

Webhook for the `report/politically-exposed-person.matched` event. For more info see [Webhooks Overview](https://docs.withpersona.com/webhooks).

Sent when a politically exposed person (PEP) report surfaces one or more matches (`has-match` becomes `true`). For continuously-monitored reports this fires on the run that introduces a new match.

The payload is the polymorphic report object. Inspect `payload.data.type` (`report/politically-exposed-person`) to identify the report, and `payload.data.attributes` for its inputs and results.

## Headers

- `Persona-Signature` string
- `Persona-Webhook-Attempts-Made` integer
- `Persona-Webhook-Attempts-Left` integer
- `Persona-Webhook-First-Attempted-At` integer

## Payload

- object
  - `data` WebhooksWebhookReportPoliticallyExposedPersonMatchedPayloadContentApplicationJsonSchemaData
    - `type` 'event'
    - `id` string: Unique identifier for this Event. Starts with `evt_`.
    - `attributes` WebhooksWebhookReportPoliticallyExposedPersonMatchedPayloadContentApplicationJsonSchemaDataAttributes
      - `created-at` string, date-time: Datetime when the event was created.
      - `name` 'report/politically-exposed-person.matched'
      - `payload` WebhooksWebhookReportPoliticallyExposedPersonMatchedPayloadContentApplicationJsonSchemaDataAttributesPayload
        - `data` ReportPoliticallyExposedPerson: A Politically Exposed Person Report
          - `id` string: The ID of the report
          - `attributes` ReportDiscriminatorMappingReportPoliticallyExposedPersonAttributes
            - `status` string: The status of the report Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
            - `created-at` string: The time the report was created in ISO 8601 format
            - `completed-at` string, nullable: The time the report completed processing in ISO 8601 format
            - `redacted-at` string, nullable: The time the report was redacted in ISO 8601 format
            - `report-template-version-name` string: The name of the report template version used for this report
            - `has-match` boolean: Whether or not the report matched
            - `is-continuous` boolean: Whether or not this report has been run more than once
            - `is-recurring` boolean: Whether or not this report is scheduled to run in the future
            - `tags` string[]: Tags on the report
            - `query` ReportDiscriminatorMappingReportPoliticallyExposedPersonAttributesQuery
              - …
            - `result` ReportDiscriminatorMappingReportPoliticallyExposedPersonAttributesResultItems[], nullable
              - …
            - `ignore-list` ReportDiscriminatorMappingReportPoliticallyExposedPersonAttributesIgnoreListItems[]
              - …
            - `run-history` ReportDiscriminatorMappingReportPoliticallyExposedPersonAttributesRunHistoryItems[]: Deprecated and no longer populated. Use the [List Report History](https://docs.withpersona.com/api-reference/reports/list-report-history) endpoint instead.
              - …
          - `relationships` ReportSharedRelationships: Other Persona objects related to the report
            - `inquiry` ReportSharedRelationshipsInquiry: The inquiry linked to the report
              - …
            - `account` ReportSharedRelationshipsAccount: The report's home account, or the first linked account when it has no home account. It returns only one account and is kept for backwards compatibility; use `accounts` to see every associated account. Including it does not require the `account.read` permission.
              - …
            - `accounts` ReportSharedRelationshipsAccounts: Every account associated with the report, meaning its home account plus all linked accounts, deduplicated and listed in account creation order. Use this when a report can be linked to more than one account; `account` is kept for backwards compatibility and returns only one. The list is not paginated or capped, and is empty when the report has no accounts. Expanding it with `include=accounts` requires the `account.read` permission; the linkage ids do not.
              - …
            - `transaction` ReportSharedRelationshipsTransaction: The transaction linked to the report
              - …
            - `report-template` ReportSharedRelationshipsReportTemplate: The report template used to create this report
              - …
        - `included` ReportsIncludedObjectsItems[]
          - union
            - object: An Inquiry object
              - …
            - object: An Account object. Note that `fields` is **not** key inflected.
              - …
            - object: An Address Lookup Report Template
              - …
            - object: An Adverse Media Report Template
              - …
            - object: A Business Adverse Media Report Template
              - …
            - object: A Business Associated Persons Report Template
              - …
            - object: A Business Lookup Report Template
              - …
            - object: A Business Media Coverage Report Template
              - …
            - object: A Business Nonprofit Report Template
              - …
            - object: A Business Registrations Lookup Report Template
              - …
            - object: A Business Watchlist Report Template
              - …
            - object: A Crypto Address Watchlist Report Template
              - …
            - object: An Email Address Report Template
              - …
            - object: A Phone Risk Report Template
              - …
            - object: A Politically Exposed Person Report Template
              - …
            - object: A Profile Report Template
              - …
            - object: A Screening Report Template
              - …
            - object: A SentiLink Report Template
              - …
            - object: A Social Media Report Template
              - …
            - object: A Synthetic Template
              - …
            - object: A Watchlist Report Template
              - …
            - object: transaction variant
              - …

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/withpersona/apis/withpersona-5.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-5/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-5/revisions/0281de74819e?raw)