# Reports events

Report events for either a natural person or a business entity.

Endpoint: POST Reports events
Version: 1.154.0

## Request fields (application/json):

  - `id` (string, required)
    Event unique identifier

  - `created_at` (string, required)
    Date and time when the event was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)

  - `type` (string, required)
    Event type
    Enum: "REPORT.CREATED"

  - `object` (any, required)
    A report generated for an end user or a business. The shape of `data` depends on the report `type`.

  - `object.id` (string, required)
    The unique identifier of the report, as a UUID.

  - `object.created_at` (string, required)
    Date and time when the resource was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)

  - `object.user_id` (string, required)
    Unique identifier of the user, as a UUID.

  - `object.type` (string, required)
    Report type
* ACCOUNT_CLOSING - Securities account closure
* ACCOUNT_OPENING - Securities account opening
* AD_HOC_ACCOUNT_STATEMENT - Ad hoc account statement
* ANNUAL_INCOME_STATEMENT - Annual tax income statement ("Erträgnisaufstellung")
* ANNUAL_TAX_STATEMENT - Annual tax reporting
* BANK_ACCOUNT_CONNECTED - Connect reference bank account
* BUY_ORDER - Buy order
* CANCELLED_ORDER - Cancelled buy or sell order (not yet executed, user cancels or trading venue cancelled)
* CORPORATE_ACTION_CASH_TRANSACTION - cash transaction document (after corporate action)
* CORPORATE_ACTION_SECURITY_TRANSACTION - security transaction document (after corporate action)
* DIRECT_DEBIT_MANDATE - Creation of SEPA direct debit mandate
* EX_POST_COST - Ex-post cost report
* FEE_COLLECTION - Intake of service fees
* FRENCH_IFU - French tax statement (Imprimé fiscal unique)
* GENERIC_COMMUNICATION - Generic communication
* INCOME_DISTRIBUTION - Income distribution report
* LOSS_THRESHOLD - Notification that a holding has depreciated by 10%, or a multiple thereof, against its purchase value
* MONTHLY_BILLING_STATEMENT - Monthly billing activities statement
* ORDER_EX_ANTE_COST - Ex-ante cost report for a single order
* ORDER_EX_ANTE_COST_SAVINGS_PLAN - Ex-ante cost report for a savings plan order
* QUARTERLY_ACCOUNT_STATEMENT - Quarterly account statement
* REVOKED_ORDER - Revoked buy or sell order ("Storno")
* SECURITIES_TRANSFER_INCOMING - Securities are transferred in
* SECURITIES_TRANSFER_OUTGOING - Securities are being transferred out
* SELL_ORDER - Sell order
* TAX_CONSOLIDATED_CERTIFICATE_UK - UK Consolidated Tax Certificate
* TAX_PAYMENT - Tax payment document
* TAX_PREPAYMENT_DE - German tax prepayment (Vorabpauschale)
* TAX_PREPAYMENT_DE_CANCELLATION - German tax prepayment (Vorabpauschale) cancellation
* TAX_REFUND - Tax refund document (after tax optimization)
    Enum: "ACCOUNT_CLOSING", "ACCOUNT_OPENING", "AD_HOC_ACCOUNT_STATEMENT", "ANNUAL_INCOME_STATEMENT", "ANNUAL_TAX_STATEMENT", "BANK_ACCOUNT_CONNECTED", "BUY_ORDER", "CANCELLED_ORDER", "CORPORATE_ACTION_CASH_TRANSACTION", "CORPORATE_ACTION_SECURITY_TRANSACTION", "DIRECT_DEBIT_MANDATE", "EX_POST_COST", "FEE_COLLECTION", "FRENCH_IFU", "GENERIC_COMMUNICATION", "INCOME_DISTRIBUTION", "LOSS_THRESHOLD", "MONTHLY_BILLING_STATEMENT", "ORDER_EX_ANTE_COST", "ORDER_EX_ANTE_COST_SAVINGS_PLAN", "QUARTERLY_ACCOUNT_STATEMENT", "REVOKED_ORDER", "SECURITIES_TRANSFER_INCOMING", "SECURITIES_TRANSFER_OUTGOING", "SELL_ORDER", "TAX_CONSOLIDATED_CERTIFICATE_UK", "TAX_PAYMENT", "TAX_PREPAYMENT_DE", "TAX_PREPAYMENT_DE_CANCELLATION", "TAX_REFUND"

  - `object.substituted_report_id` (any, required)
    The unique identifier of the report that this report replaces, as a UUID. Populated when a mistrade causes a corrected report to be issued; `null` otherwise.

  - `object.data` (object)
    The contents of a report, including the account it relates to and references to the resources that triggered it.

  - `object.data.account` (object)
    The account that the report relates to.

  - `object.data.account.id` (string)
    Universally Unique Identifier (UUID) of the account.

  - `object.data.references` (array)
    Identifiers of the resources that the report relates to, such as the order or corporate action that triggered it.

  - `object.data.references.id` (string)
    The unique identifier of the referenced resource, as a UUID.

  - `object.data.references.type` (string)
    Report reference type
* CORPORATE_ACTION_TRANSACTION_ID - Corporate action transaction identifier
* ACCOUNT_GROUP_ID - Account group identifier
* ACCOUNT_ID - Account identifier
* ORDER_ID - Order identifier
    Enum: "CORPORATE_ACTION_TRANSACTION_ID", "ACCOUNT_GROUP_ID", "ACCOUNT_ID", "ORDER_ID"

  - `object.business_id` (string, required)
    Unique identifier for the business.

  - `object.type` (string, required)
    The type of report must be “ORDER_EX_ANTE_COST” or “ORDER_EX_ANTE_COST_SAVINGS_PLAN”.
    Enum: "ORDER_EX_ANTE_COST", "ORDER_EX_ANTE_COST_SAVINGS_PLAN"

  - `object.data` (object)
    Contents of the order-ex-ante cost report for a user.

  - `object.data.holding_period` (object)
    The holding period assumed when estimating the costs in this report. Costs are projected on the basis that the instrument is held for this period before being sold.

  - `object.data.holding_period.unit` (string)
    The unit in which the holding period is counted.
* YEAR — The holding period is counted in years.
    Enum: "YEAR"

  - `object.data.holding_period.quantity` (integer)
    The number of holding period units assumed, for example 3 for a three-year holding period.

  - `object.data.instrument` (object)
    The instrument that the planned order relates to.

  - `object.data.instrument.isin` (string)
    International securities identification number defined by [ISO 6166](https://en.wikipedia.org/wiki/International_Securities_Identification_Number).

  - `object.data.instrument.short_name` (string)
    The short display name of the instrument.

  - `object.data.venue` (object)
    The execution venue on which the planned order would be executed.

  - `object.data.venue.name` (string)
    The name of the execution venue.

  - `object.data.account` (object)
    The account that the planned order would be placed for.

  - `object.data.account.account_number` (integer)
    The serial account number of the account in the account group.

  - `object.data.account_group` (object)
    The account group that the account belongs to.

  - `object.data.account_group.id` (string)
    Universally Unique Identifier (UUID) of the account group.

  - `object.data.account_group.securities_account_number` (string)
    The nine-digit securities account number of the account group.

  - `object.data.user` (object, required)
    The end user that the report is addressed to.

  - `object.data.user.first_name` (string)
    First name of the user.

  - `object.data.user.last_name` (string)
    Last name of the user.

  - `object.data.user.salutation` (string)
    The salutation used for the end user in reports and statements.
* SALUTATION_MALE — Herr.
* SALUTATION_FEMALE — Frau.
* SALUTATION_FEMALE_MARRIED — Frau, married form.
* SALUTATION_DIVERSE — Gender-neutral salutation.

An empty string means no salutation is printed.
    Enum: "", "SALUTATION_MALE", "SALUTATION_FEMALE", "SALUTATION_FEMALE_MARRIED", "SALUTATION_DIVERSE"

  - `object.data.user.title` (string)
    The academic title used for the end user in reports and statements.
* DR — Doctor.
* PROF — Professor.
* PROF_DR — Professor Doctor.
* DIPL_ING — Graduate engineer (Diplom-Ingenieur).
* MAGISTER — Magister.

An empty string means no title is printed.
    Enum: "", "DR", "PROF", "PROF_DR", "DIPL_ING", "MAGISTER"

  - `object.data.user.address` (object)
    The residential address of the end user, as printed on the report.

  - `object.data.user.address.address_line1` (string)
    First line of the address.

  - `object.data.user.address.address_line2` (string)
    Second line of the address.

  - `object.data.user.address.postcode` (string)
    Postal code (postcode, PIN or ZIP code)

  - `object.data.user.address.country` (string)
    Country code. [ISO 3166 alpha-2 Codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `object.data.user.address.state` (string)
    State, province, county. [ISO 3166 alpha-2 Codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `object.data.user.address.city` (string)
    The name of a city, as it appears in a postal address.

  - `object.data.order` (object)
    The planned order whose costs this report estimates.

  - `object.data.order.user_id` (string)
    The unique identifier of the end user placing the order, as a UUID.

  - `object.data.order.account_id` (string)
    The ID of the account that owns the order.

  - `object.data.order.cash_amount` (string)
    The cash amount the planned order would invest, as a decimal string.

  - `object.data.order.currency` (string)
    The currency of the planned order, as an [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) three-letter code.
    Enum: "EUR", "GBP"

  - `object.data.order.side` (string)
    Whether the planned order buys or sells the instrument.
* BUY — The order buys the instrument.
* SELL — The order sells the instrument.
    Enum: "BUY", "SELL"

  - `object.data.order.instrument_id` (string)
    International securities identification number defined by [ISO 6166](https://en.wikipedia.org/wiki/International_Securities_Identification_Number).

  - `object.data.order.instrument_id_type` (string)
    The kind of identifier given in `instrument_id`.
* ISIN — International Securities Identification Number.
    Enum: "ISIN"

  - `object.data.order.order_type` (string)
    How the planned order is priced.
* MARKET — Executes at the best price available.
* LIMIT — Executes only at the `limit_price` or better.
* STOP — Becomes a market order once the `stop_price` is reached.
    Enum: "MARKET", "LIMIT", "STOP"

  - `object.data.order.quantity` (string)
    The number of units the planned order would buy or sell, as a decimal string.

  - `object.data.order.limit_price` (string)
    The limit price of the planned order, as a decimal string. Applies to `LIMIT` orders.

  - `object.data.order.stop_price` (string)
    The stop price of the planned order, as a decimal string. Applies to `STOP` orders.

  - `object.data.order.price` (string)
    The price used to estimate the costs of the planned order, as a decimal string.

  - `object.data.return_impact` (object)
    The cumulative effect of the estimated costs on the investment return, shown for each year of the assumed holding period.

  - `object.data.return_impact.year_one` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.return_impact.year_one.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.return_impact.year_one.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.return_impact.year_one.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.return_impact.year_two` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.return_impact.year_two.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.return_impact.year_two.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.return_impact.year_two.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.return_impact.year_three` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.return_impact.year_three.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.return_impact.year_three.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.return_impact.year_three.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.total_cost` (object)
    Aggregated totals of product costs, service costs and third party payments.

  - `object.data.total_cost.product` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.total_cost.product.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.total_cost.product.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.total_cost.product.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.total_cost.service` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.total_cost.service.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.total_cost.service.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.total_cost.service.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.total_cost.third_party` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.total_cost.third_party.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.total_cost.third_party.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.total_cost.third_party.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.total_cost.total` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.total_cost.total.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.total_cost.total.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.total_cost.total.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.product_cost` (object)
    All costs and associated charges related to the financial instrument.

  - `object.data.product_cost.one_off` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.product_cost.one_off.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.product_cost.one_off.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.product_cost.one_off.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.product_cost.ongoing` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.product_cost.ongoing.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.product_cost.ongoing.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.product_cost.ongoing.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.product_cost.transaction` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.product_cost.transaction.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.product_cost.transaction.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.product_cost.transaction.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.product_cost.incidental` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.product_cost.incidental.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.product_cost.incidental.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.product_cost.incidental.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.product_cost.total` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.product_cost.total.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.product_cost.total.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.product_cost.total.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.service_cost` (object)
    All costs and associated charges related to the investment service(s) and/or ancillary services.

  - `object.data.service_cost.one_off` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.service_cost.one_off.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.service_cost.one_off.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.service_cost.one_off.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.service_cost.ongoing` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.service_cost.ongoing.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.service_cost.ongoing.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.service_cost.ongoing.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.service_cost.transaction` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.service_cost.transaction.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.service_cost.transaction.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.service_cost.transaction.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.service_cost.ancillary` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.service_cost.ancillary.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.service_cost.ancillary.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.service_cost.ancillary.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.service_cost.incidental` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.service_cost.incidental.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.service_cost.incidental.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.service_cost.incidental.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.service_cost.total` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.service_cost.total.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.service_cost.total.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.service_cost.total.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.third_party_payments` (object)
    Third-party payments associated with the investment service.

  - `object.data.third_party_payments.total` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.third_party_payments.total.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.third_party_payments.total.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.third_party_payments.total.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.third_party_payments.received_by_client` (object)
    A cost figure, given both as a cash amount and as a percentage of the amount invested.

  - `object.data.third_party_payments.received_by_client.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.third_party_payments.received_by_client.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.third_party_payments.received_by_client.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.data.third_party_payments.received_by_upvest` (object)
    The share of the third-party payments received by Upvest, as a cost figure.

  - `object.data.third_party_payments.received_by_upvest.cash_amount` (string)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.data.third_party_payments.received_by_upvest.currency` (string)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.data.third_party_payments.received_by_upvest.as_percentage` (string)
    The cost value represented as a percentage.

  - `object.type` (string, required)
    The type of report must be “ORDER_EX_ANTE_COST”. Savings plan ex-ante reports are not supported for business entities.
    Enum: "ORDER_EX_ANTE_COST"

  - `object.data` (object)
    Contents of the order ex-ante cost report for a business.

  - `object.data.business` (object, required)
    The business that the report is addressed to.

  - `object.data.business.company_name` (string)
    Name of the company.

  - `object.data.business.address` (object)
    Address. Must not be a P.O. box or c/o address.

  - `object.data.business.address.address_line1` (string, required)
    First address line of the address.

  - `object.data.business.address.address_line2` (string)
    Second address line of the address.

  - `object.data.business.address.postcode` (string, required)
    Postal code (postcode, PIN or ZIP code)

  - `object.data.business.address.country` (string, required)
    Accepted country code. [ISO 3166-1 alpha-2 codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Enum: "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "XK", "YE", "YT", "ZA", "ZM", "ZW"

  - `object.data.business.address.state` (string)
    State, province, county. [ISO 3166 alpha-2 Codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `object.data.business.address.city` (string, required)
    The name of a city, as it appears in a postal address.

  - `object.data.third_party_payments` (object)
    Third party payments associated with the investment service.

  - `webhook_id` (string, required)
    Webhook unique identifier.

## Request examples:

  - `User report` (unknown)

  - `Business report` (unknown)

## Response 200:

  - `200` (unknown)
    Request has been processed successfully.