# Reports events

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

Endpoint: POST Reports events
Version: 1.111.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) — one of:
    - User Report:
      - `id` (string, required)
        Report unique identifier.
      - `user_id` (string, required)
        User unique identifier.
      - `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)
      - `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
* GENERIC_COMMUNICATION - Generic communication
* INCOME_DISTRIBUTION - Income distribution report
* MONTHLY_BILLING_STATEMENT - Monthly billing activities statement
* 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_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)
* FRENCH_IFU - French tax statement (Imprimé fiscal unique)
        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", "GENERIC_COMMUNICATION", "INCOME_DISTRIBUTION", "MONTHLY_BILLING_STATEMENT", "QUARTERLY_ACCOUNT_STATEMENT", "REVOKED_ORDER", "SECURITIES_TRANSFER_INCOMING", "SECURITIES_TRANSFER_OUTGOING", "SELL_ORDER", "TAX_PAYMENT", "TAX_PREPAYMENT_DE", "TAX_PREPAYMENT_DE_CANCELLATION", "TAX_REFUND", "FRENCH_IFU"
      - `substituted_report_id` (any, required)
      - `data` (object)
        Contents of the report.
      - `data.account` (object)
        Account information.
      - `data.account.id` (string)
        Account unique identifier.
      - `data.references` (array)
      - `data.references.id` (string)
      - `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"
    - Business Report:
      - `id` (string, required)
        Report unique identifier.
      - `business_id` (string, required)
        Unique identifier for the business.
      - `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)
      - `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
* GENERIC_COMMUNICATION - Generic communication
* INCOME_DISTRIBUTION - Income distribution report
* MONTHLY_BILLING_STATEMENT - Monthly billing activities statement
* 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_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)
* FRENCH_IFU - French tax statement (Imprimé fiscal unique)
        Enum: same as `type` in "User Report" (25 values)
      - `substituted_report_id` (any, required)
      - `data` (object)
        Contents of the report.
      - `data.account` (object)
        Account information.
      - `data.account.id` (string)
        Account unique identifier.
      - `data.references` (array)
      - `data.references.id` (string)
      - `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: same as `data.references.type` in "User Report" (4 values)
    - User Report - Order ex-ante cost:
      - `id` (string, required)
        Report unique identifier.
      - `user_id` (string, required)
        User unique identifier.
      - `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)
      - `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"
      - `substituted_report_id` (any, required)
      - `data` (object)
        Contents of the order-ex-ante cost report for a user.
      - `data.user` (object, required)
        User details.
      - `data.user.first_name` (string)
        First name of the user.
      - `data.user.last_name` (string)
        Last name of the user.
      - `data.user.salutation` (string)
        Salutation of the user used in reports and statements.
* (empty string) - 
* SALUTATION_MALE - 
* SALUTATION_FEMALE - 
* SALUTATION_FEMALE_MARRIED - 
* SALUTATION_DIVERSE -
        Enum: "", "SALUTATION_MALE", "SALUTATION_FEMALE", "SALUTATION_FEMALE_MARRIED", "SALUTATION_DIVERSE"
      - `data.user.title` (string)
        Addressed user's title is used in reports and statements.
* (empty string) - 
* DR - Doctor
* PROF - Professor
* PROF_DR - 
* DIPL_ING - Graduate engineer (Diplom-Ingenieur)
* MAGISTER -
        Enum: "", "DR", "PROF", "PROF_DR", "DIPL_ING", "MAGISTER"
      - `data.user.address` (object)
        User residential address.
      - `data.user.address.address_line1` (string)
        First line of the address.
      - `data.user.address.address_line2` (string)
        Second line of the address.
      - `data.user.address.postcode` (string)
        Postal code (postcode, PIN or ZIP code)
      - `data.user.address.country` (string)
        Country code. [ISO 3166 alpha-2 Codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
      - `data.user.address.state` (string)
        State, province, county. [ISO 3166 alpha-2 Codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
      - `data.user.address.city` (string)
      - `data.holding_period` (object)
        Holding period.
      - `data.holding_period.unit` (string)
        Unit of time. 
* YEAR -
        Enum: "YEAR"
      - `data.holding_period.quantity` (integer)
        Quantity of time units.
      - `data.instrument` (object)
        Instrument details.
      - `data.instrument.isin` (string)
        International securities identification number defined by [ISO 6166](https://en.wikipedia.org/wiki/International_Securities_Identification_Number).
      - `data.instrument.short_name` (string)
        Instrument short name.
      - `data.venue` (object)
        Venue details.
      - `data.venue.name` (string)
        Venue name.
      - `data.account` (object)
        Account details.
      - `data.account.id` (string)
        Account unique identifier.
      - `data.account.account_number` (integer)
        The serial account number of the account in the account group.
      - `data.account_group` (object)
        Account group details.
      - `data.account_group.id` (string)
        Account group unique identifier.
      - `data.account_group.securities_account_number` (string)
        Securities account number.
      - `data.order` (object)
        Order details.
      - `data.order.user_id` (string)
        The ID of the user.
      - `data.order.account_id` (string)
        The ID of the account that owns the order.
      - `data.order.cash_amount` (string)
        Cash amount for a nominal order.
      - `data.order.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"
      - `data.order.side` (string)
        Side of the order.
* BUY - 
* SELL -
        Enum: "BUY", "SELL"
      - `data.order.instrument_id` (string)
        International securities identification number defined by [ISO 6166](https://en.wikipedia.org/wiki/International_Securities_Identification_Number).
      - `data.order.instrument_id_type` (string)
        The type of the ID used in the request.
* ISIN -
        Enum: "ISIN"
      - `data.order.order_type` (string)
        Order type.
* MARKET - 
* LIMIT - 
* STOP -
        Enum: "MARKET", "LIMIT", "STOP"
      - `data.order.quantity` (string)
        Quantity of securities for the order.
      - `data.order.limit_price` (string)
        The limit price for orders of the type 'limit'.
      - `data.order.stop_price` (string)
        The stop price for orders of the type 'stop'.
      - `data.order.price` (string)
        The estimated price for the order. In case of LIMIT or STOP order provided LIMIT/STOP price will be used.
      - `data.return_impact` (object)
        Return impact.
      - `data.return_impact.year_one` (object)
      - `data.return_impact.year_one.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.return_impact.year_one.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.return_impact.year_two` (object)
      - `data.return_impact.year_two.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.return_impact.year_two.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.return_impact.year_three` (object)
      - `data.return_impact.year_three.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.return_impact.year_three.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.total_cost` (object)
        Aggregated totals of product costs, service costs and third party payments.
      - `data.total_cost.product` (object)
      - `data.total_cost.product.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.total_cost.product.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.total_cost.service` (object)
      - `data.total_cost.service.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.total_cost.service.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.total_cost.third_party` (object)
      - `data.total_cost.third_party.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.total_cost.third_party.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.total_cost.total` (object)
      - `data.total_cost.total.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.total_cost.total.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost` (object)
        All costs and associated charges related to the financial instrument.
      - `data.product_cost.one_off` (object)
      - `data.product_cost.one_off.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.one_off.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost.ongoing` (object)
      - `data.product_cost.ongoing.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.ongoing.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost.transaction` (object)
      - `data.product_cost.transaction.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.transaction.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost.incidental` (object)
      - `data.product_cost.incidental.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.incidental.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost.total` (object)
      - `data.product_cost.total.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.total.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost` (object)
        All costs and associated charges related to the investment service(s) and/or ancillary services.
      - `data.service_cost.one_off` (object)
      - `data.service_cost.one_off.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.one_off.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.ongoing` (object)
      - `data.service_cost.ongoing.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.ongoing.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.transaction` (object)
      - `data.service_cost.transaction.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.transaction.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.ancillary` (object)
      - `data.service_cost.ancillary.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.ancillary.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.incidental` (object)
      - `data.service_cost.incidental.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.incidental.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.total` (object)
      - `data.service_cost.total.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.total.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.third_party_payments` (object)
        Third-party payments associated with the investment service.
      - `data.third_party_payments.total` (object)
      - `data.third_party_payments.total.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.third_party_payments.total.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.third_party_payments.received_by_client` (object)
      - `data.third_party_payments.received_by_client.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.third_party_payments.received_by_client.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.third_party_payments.received_by_upvest` (object)
      - `data.third_party_payments.received_by_upvest.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.third_party_payments.received_by_upvest.as_percentage` (string)
        The cost value represented as a percentage.
    - Business Report - Order ex-ante cost:
      - `id` (string, required)
        Report unique identifier.
      - `business_id` (string, required)
        Unique identifier for the business.
      - `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)
      - `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"
      - `substituted_report_id` (any, required)
      - `data` (object)
        Contents of the order ex-ante cost report for a business.
      - `data.business` (object, required)
        Business details.
      - `data.business.company_name` (string)
        Name of the company.
      - `data.business.address` (object)
        Address. Must not be a P.O. box or c/o address.
      - `data.business.address.address_line1` (string, required)
        First address line of the address.
      - `data.business.address.postcode` (string, required)
        Postal code (postcode, PIN or ZIP code)
      - `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"
      - `data.business.address.city` (string, required)
      - `data.business.address.address_line2` (string)
        Second address line of the address.
      - `data.business.address.state` (string)
        State, province, county. [ISO 3166 alpha-2 Codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
      - `data.holding_period` (object)
        Holding period.
      - `data.holding_period.unit` (string)
        Unit of time. 
* YEAR -
        Enum: same as `data.holding_period.unit` in "User Report - Order ex-ante cost" (1 values)
      - `data.holding_period.quantity` (integer)
        Quantity of time units.
      - `data.instrument` (object)
        Instrument details.
      - `data.instrument.isin` (string)
        International securities identification number defined by [ISO 6166](https://en.wikipedia.org/wiki/International_Securities_Identification_Number).
      - `data.instrument.short_name` (string)
        Instrument short name.
      - `data.venue` (object)
        Venue details.
      - `data.venue.name` (string)
        Venue name.
      - `data.account` (object)
        Account details.
      - `data.account.id` (string)
        Account unique identifier.
      - `data.account.account_number` (integer)
        The serial account number of the account in the account group.
      - `data.account_group` (object)
        Account group details.
      - `data.account_group.id` (string)
        Account group unique identifier.
      - `data.account_group.securities_account_number` (string)
        Securities account number.
      - `data.order` (object)
        Order details.
      - `data.order.business_id` (string)
        The ID of the business.
      - `data.order.account_id` (string)
        The ID of the account that owns the order.
      - `data.order.cash_amount` (string)
        Cash amount for a nominal order.
      - `data.order.currency` (string)
        Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR - Euro
* GBP - Pound Sterling
        Enum: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.order.side` (string)
        Side of the order.
* BUY - 
* SELL -
        Enum: same as `data.order.side` in "User Report - Order ex-ante cost" (2 values)
      - `data.order.instrument_id` (string)
        International securities identification number defined by [ISO 6166](https://en.wikipedia.org/wiki/International_Securities_Identification_Number).
      - `data.order.instrument_id_type` (string)
        The type of the ID used in the request.
* ISIN -
        Enum: same as `data.order.instrument_id_type` in "User Report - Order ex-ante cost" (1 values)
      - `data.order.order_type` (string)
        Order type.
* MARKET - 
* LIMIT - 
* STOP -
        Enum: same as `data.order.order_type` in "User Report - Order ex-ante cost" (3 values)
      - `data.order.quantity` (string)
        Quantity of securities for the order.
      - `data.order.limit_price` (string)
        The limit price for orders of the type 'limit'.
      - `data.order.stop_price` (string)
        The stop price for orders of the type STOP.
      - `data.order.price` (string)
        The estimated price for the order. In case of LIMIT or STOP order provided LIMIT/STOP price will be used.
      - `data.return_impact` (object)
        Return impact.
      - `data.return_impact.year_one` (object)
      - `data.return_impact.year_one.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.return_impact.year_one.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.return_impact.year_two` (object)
      - `data.return_impact.year_two.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.return_impact.year_two.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.return_impact.year_three` (object)
      - `data.return_impact.year_three.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.return_impact.year_three.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.total_cost` (object)
        Aggregated totals of product costs, service costs and third party payments.
      - `data.total_cost.product` (object)
      - `data.total_cost.product.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.total_cost.product.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.total_cost.service` (object)
      - `data.total_cost.service.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.total_cost.service.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.total_cost.third_party` (object)
      - `data.total_cost.third_party.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.total_cost.third_party.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.total_cost.total` (object)
      - `data.total_cost.total.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.total_cost.total.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost` (object)
        All costs and associated charges related to the financial instrument.
      - `data.product_cost.one_off` (object)
      - `data.product_cost.one_off.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.one_off.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost.ongoing` (object)
      - `data.product_cost.ongoing.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.ongoing.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost.transaction` (object)
      - `data.product_cost.transaction.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.transaction.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost.incidental` (object)
      - `data.product_cost.incidental.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.incidental.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.product_cost.total` (object)
      - `data.product_cost.total.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.product_cost.total.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost` (object)
        All costs and associated charges related to the investment service(s) and/or ancillary services.
      - `data.service_cost.one_off` (object)
      - `data.service_cost.one_off.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.one_off.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.ongoing` (object)
      - `data.service_cost.ongoing.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.ongoing.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.transaction` (object)
      - `data.service_cost.transaction.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.transaction.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.ancillary` (object)
      - `data.service_cost.ancillary.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.ancillary.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.incidental` (object)
      - `data.service_cost.incidental.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.incidental.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.service_cost.total` (object)
      - `data.service_cost.total.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.service_cost.total.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.third_party_payments` (object)
        Third party payments associated with the investment service.
      - `data.third_party_payments.total` (object)
      - `data.third_party_payments.total.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.third_party_payments.total.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.third_party_payments.received_by_client` (object)
      - `data.third_party_payments.received_by_client.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.third_party_payments.received_by_client.as_percentage` (string)
        The cost value represented as a percentage.
      - `data.third_party_payments.received_by_upvest` (object)
      - `data.third_party_payments.received_by_upvest.cash_amount` (string)
      - `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: same as `data.order.currency` in "User Report - Order ex-ante cost" (2 values)
      - `data.third_party_payments.received_by_upvest.as_percentage` (string)
        The cost value represented as a percentage.

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


## Response 200 fields