--- title: "Address lookup report submitted" method: POST path: "reportEvents_webhook-report-address-lookup-submitted" --- # Address lookup report submitted `POST reportEvents_webhook-report-address-lookup-submitted` (webhook) Webhook for the `report/address-lookup.submitted` event. For more info see [Webhooks Overview](https://docs.withpersona.com/webhooks). Sent when an address lookup report has been submitted to its upstream data source and is awaiting results (`status` is `submitted`). A `ready` or `errored` event follows once processing completes. The payload is the polymorphic report object. Inspect `payload.data.type` (`report/address-lookup`) 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` WebhooksWebhookReportAddressLookupSubmittedPayloadContentApplicationJsonSchemaData - `type` 'event' - `id` string: Unique identifier for this Event. Starts with `evt_`. - `attributes` WebhooksWebhookReportAddressLookupSubmittedPayloadContentApplicationJsonSchemaDataAttributes - `created-at` string, date-time: Datetime when the event was created. - `name` 'report/address-lookup.submitted' - `payload` WebhooksWebhookReportAddressLookupSubmittedPayloadContentApplicationJsonSchemaDataAttributesPayload - `data` ReportAddressLookup: An Address Lookup Report - `id` string: The ID of the report - `attributes` ReportDiscriminatorMappingReportAddressLookupAttributes - `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 - `addressee` string, nullable: The name of an individual at this location. - `address-street-1` string, nullable: Address line 1 (e.g., street, PO Box, or company name). - `address-street-2` string, nullable: Address line 2 (e.g., apartment, suite, unit, or building). - `address-city` string, nullable: City - `address-subdivision` string, nullable: Subnational division of a country, such as a state or province. - `address-postal-code` string, nullable: ZIP or postal code. - `resolved-addressee` string, nullable - `resolved-address-street-1` string, nullable - `resolved-address-street-2` string, nullable - `resolved-address-city` string, nullable - `resolved-address-subdivision` string, nullable - `resolved-address-postal-code` string, nullable - `metadata-record-type` string, nullable - `metadata-zip-type` string, nullable - `metadata-county-fips` string, nullable - `metadata-county-name` string, nullable - `metadata-carrier-route` string, nullable - `metadata-carrier-route-type` string, nullable - `metadata-congressional-district` string, nullable - `metadata-building-default-indicator` string, nullable - `metadata-residential-delivery-indicator` string, nullable - `metadata-latitude` number, double, nullable - `metadata-longitude` number, double, nullable - `metadata-precision` string, nullable - `metadata-time-zone` string, nullable - `metadata-utc-offset` integer, nullable - `metadata-obeys-daylight-savings` boolean, nullable - `analysis-dpv-match-code` string, nullable - `analysis-dpv-match-code-decoded` string, nullable - `analysis-dpv-footnotes` string[], nullable - `analysis-dpv-footnotes-decoded` string[], nullable - `analysis-dpv-cmra` string, nullable - `analysis-dpv-vacant` string, nullable - `analysis-active` string, nullable - `analysis-footnotes` string[], nullable - `analysis-footnotes-decoded` string[], nullable - `analysis-lacs-link-code` string, nullable - `analysis-lacs-link-code-decoded` string, nullable - `analysis-lacs-link-indicator` string, nullable - `analysis-lacs-link-indicator-decoded` string, nullable - `analysis-suite-link-match` string, nullable - `metadata-ews-match` string, nullable - `error-message` string, nullable - `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-3.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-3/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-3/revisions/0a3310d5046f?raw)