--- title: "Phone number report errored" method: POST path: "reportEvents_webhook-report-phone-number-errored" --- # Phone number report errored `POST reportEvents_webhook-report-phone-number-errored` (webhook) Webhook for the `report/phone-number.errored` event. For more info see [Webhooks Overview](https://docs.withpersona.com/webhooks). Sent when a phone number report fails to complete processing (`status` is `errored`). The payload is the polymorphic report object. Inspect `payload.data.type` (`report/phone-number`) 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` WebhooksWebhookReportPhoneNumberErroredPayloadContentApplicationJsonSchemaData - `type` 'event' - `id` string: Unique identifier for this Event. Starts with `evt_`. - `attributes` WebhooksWebhookReportPhoneNumberErroredPayloadContentApplicationJsonSchemaDataAttributes - `created-at` string, date-time: Datetime when the event was created. - `name` 'report/phone-number.errored' - `payload` WebhooksWebhookReportPhoneNumberErroredPayloadContentApplicationJsonSchemaDataAttributesPayload - `data` ReportPhoneRisk: A Phone Risk Report - `id` string: The ID of the report - `attributes` ReportDiscriminatorMappingReportPhoneNumberAttributes - `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 - `phone-number` string: The input phone number of the search - `phone-type` string, nullable: Possible values: - FIXED_LINE - MOBILE - PREPAID - TOLL_FREE - VOIP - PAGER - PAYPHONE - INVALID - RESTRICTED_PREMIUM - PERSONAL - VOICEMAIL - OTHER Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `phone-carrier` string, nullable - `phone-city` string, nullable: City associated with the phone number location. - `phone-subdivision` string, nullable: State or region associated with the phone number location. - `phone-country-code` string, nullable: ISO 3166-1 alpha-2 country code associated with the phone number location. - `phone-risk-level` string, nullable: Assessment of the phone number's risk (low - high) - `phone-risk-recommendation` string, nullable: Possible values: - block - allow - flag Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `phone-risk-score` integer, nullable: Risk score out of 1000 - `phone-risk-sim-swap` string, nullable: The risk of a fraudulent SIM swap Possible values: - very-low - low - medium - high - N/A 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-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)