--- title: "Business lookup report ready" method: POST path: "reportEvents_webhook-report-business-lookup-ready" --- # Business lookup report ready `POST reportEvents_webhook-report-business-lookup-ready` (webhook) Webhook for the `report/business-lookup.ready` event. For more info see [Webhooks Overview](https://docs.withpersona.com/webhooks). Sent when a business lookup report finishes processing and its results are available (`status` is `ready`). The payload is the polymorphic report object. Inspect `payload.data.type` (`report/business-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` WebhooksWebhookReportBusinessLookupReadyPayloadContentApplicationJsonSchemaData - `type` 'event' - `id` string: Unique identifier for this Event. Starts with `evt_`. - `attributes` WebhooksWebhookReportBusinessLookupReadyPayloadContentApplicationJsonSchemaDataAttributes - `created-at` string, date-time: Datetime when the event was created. - `name` 'report/business-lookup.ready' - `payload` WebhooksWebhookReportBusinessLookupReadyPayloadContentApplicationJsonSchemaDataAttributesPayload - `data` ReportBusinessLookup: A Business Lookup Report - `id` string: The ID of the report - `attributes` ReportDiscriminatorMappingReportBusinessLookupAttributes - `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` ReportDiscriminatorMappingReportBusinessLookupAttributesQuery - … - `result` ReportDiscriminatorMappingReportBusinessLookupAttributesResult - … - `match-status-strength` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-business-name` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-address` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-address-street` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-address-city` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-address-postal-code` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-address-subdivision` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-phone-number` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-ein` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-associated-person` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `match-status-website` string, nullable: Possible values: - not_applicable - match - partial_match - no_match - unavailable - unknown Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `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)