--- title: "GET /user/{userID}/monetary-account/{monetary-accountID}/currency-conversion/{itemId}" method: GET path: "/user/{userID}/monetary-account/{monetary-accountID}/currency-conversion/{itemId}" tags: ["currency-conversion"] --- # GET /user/{userID}/monetary-account/{monetary-accountID}/currency-conversion/{itemId} `GET /user/{userID}/monetary-account/{monetary-accountID}/currency-conversion/{itemId}` ## Request - Base URL: `https://public-api.sandbox.bunq.com/v1` - URL: `https://public-api.sandbox.bunq.com/v1/user/{userID}/monetary-account/{monetary-accountID}/currency-conversion/{itemId}` - Auth: none declared. Required headers: `User-Agent`, `X-Bunq-Client-Authentication` Endpoint for managing currency conversions. ## Path parameters - `userID` integer, required - `monetary-accountID` integer, required - `itemId` integer, required ## Headers - `Cache-Control` string - `User-Agent` string, required - `X-Bunq-Language` string - `X-Bunq-Region` string - `X-Bunq-Client-Request-Id` string - `X-Bunq-Geolocation` string - `X-Bunq-Client-Authentication` string, required ## Response `200` Endpoint for managing currency conversions. - CurrencyConversionRead - `id` integer: The id of the conversion. - `created` string: The timestamp of the conversion's creation. - `updated` string: The timestamp of the conversion's last update. - `status` string: The status of the conversion. - `date_delivery_expected` string: The expected delivery date of the conversion. - `rate` string: The rate of the conversion. - `amount` Amount - `value` string: The amount formatted to two decimal places. - `currency` string: The currency of the amount. It is an ISO 4217 formatted currency code. - `counter_amount` Amount - `value` string: The amount formatted to two decimal places. - `currency` string: The currency of the amount. It is an ISO 4217 formatted currency code. - `group_uuid` string: The group uuid of the conversion. - `type` string: The type of this conversion. - `order_type` string: The order type, buying or selling. - `label_monetary_account` LabelMonetaryAccount - `iban` string: The IBAN of the monetary account. - `display_name` string: The name to display with this monetary account. - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - `attachment_public_uuid` string: The public UUID of the public attachment containing the image. - `content_type` string: The content-type as a MIME filetype. - `height` integer: The image height in pixels. - `width` integer: The image width in pixels. - `style` string: The style (if applicable) for this Avatar. - `label_user` LabelUser - `uuid` string: The public UUID of the label-user. - `display_name` string: The name to be displayed for this user, as it was given on the request. - `country` string: The country of the user. 000 stands for "unknown" - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - `attachment_public_uuid` string: The public UUID of the public attachment containing the image. - `content_type` string: The content-type as a MIME filetype. - `height` integer: The image height in pixels. - `width` integer: The image width in pixels. - `style` string: The style (if applicable) for this Avatar. - `public_nick_name` string: The current nickname of the user. - `country` string: The country of the user. Formatted as a ISO 3166-1 alpha-2 country code. - `bunq_me` Pointer - `type` string: The alias type, can be: EMAIL|PHONE_NUMBER|IBAN. - `value` string: The alias value. - `name` string: The alias name. - `service` string: The pointer service. Only required for external counterparties. - `is_light` boolean: Whether or not the monetary account is light. - `swift_bic` string: The BIC used for a SWIFT payment. - `swift_account_number` string: The account number used for a SWIFT payment. May or may not be an IBAN. - `transferwise_account_number` string: The account number used for a Transferwise payment. May or may not be an IBAN. - `transferwise_bank_code` string: The bank code used for a Transferwise payment. May or may not be a BIC. - `merchant_category_code` string: The merchant category code. - `counter_label_monetary_account` LabelMonetaryAccount - `iban` string: The IBAN of the monetary account. - `display_name` string: The name to display with this monetary account. - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - `attachment_public_uuid` string: The public UUID of the public attachment containing the image. - `content_type` string: The content-type as a MIME filetype. - `height` integer: The image height in pixels. - `width` integer: The image width in pixels. - `style` string: The style (if applicable) for this Avatar. - `label_user` LabelUser - `uuid` string: The public UUID of the label-user. - `display_name` string: The name to be displayed for this user, as it was given on the request. - `country` string: The country of the user. 000 stands for "unknown" - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - `attachment_public_uuid` string: The public UUID of the public attachment containing the image. - `content_type` string: The content-type as a MIME filetype. - `height` integer: The image height in pixels. - `width` integer: The image width in pixels. - `style` string: The style (if applicable) for this Avatar. - `public_nick_name` string: The current nickname of the user. - `country` string: The country of the user. Formatted as a ISO 3166-1 alpha-2 country code. - `bunq_me` Pointer - `type` string: The alias type, can be: EMAIL|PHONE_NUMBER|IBAN. - `value` string: The alias value. - `name` string: The alias name. - `service` string: The pointer service. Only required for external counterparties. - `is_light` boolean: Whether or not the monetary account is light. - `swift_bic` string: The BIC used for a SWIFT payment. - `swift_account_number` string: The account number used for a SWIFT payment. May or may not be an IBAN. - `transferwise_account_number` string: The account number used for a Transferwise payment. May or may not be an IBAN. - `transferwise_bank_code` string: The bank code used for a Transferwise payment. May or may not be a BIC. - `merchant_category_code` string: The merchant category code. - `payment` Payment - `amount` Amount - `value` string: The amount formatted to two decimal places. - `currency` string: The currency of the amount. It is an ISO 4217 formatted currency code. - `counterparty_alias` LabelMonetaryAccount - `iban` string: The IBAN of the monetary account. - `display_name` string: The name to display with this monetary account. - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - `attachment_public_uuid` string: The public UUID of the public attachment containing the image. - `content_type` string: The content-type as a MIME filetype. - `height` integer: The image height in pixels. - `width` integer: The image width in pixels. - `style` string: The style (if applicable) for this Avatar. - `label_user` LabelUser - `uuid` string: The public UUID of the label-user. - `display_name` string: The name to be displayed for this user, as it was given on the request. - `country` string: The country of the user. 000 stands for "unknown" - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - `attachment_public_uuid` string: The public UUID of the public attachment containing the image. - `content_type` string: The content-type as a MIME filetype. - `height` integer: The image height in pixels. - `width` integer: The image width in pixels. - `style` string: The style (if applicable) for this Avatar. - `public_nick_name` string: The current nickname of the user. - `country` string: The country of the user. Formatted as a ISO 3166-1 alpha-2 country code. - `bunq_me` Pointer - `type` string: The alias type, can be: EMAIL|PHONE_NUMBER|IBAN. - `value` string: The alias value. - `name` string: The alias name. - `service` string: The pointer service. Only required for external counterparties. - `is_light` boolean: Whether or not the monetary account is light. - `swift_bic` string: The BIC used for a SWIFT payment. - `swift_account_number` string: The account number used for a SWIFT payment. May or may not be an IBAN. - `transferwise_account_number` string: The account number used for a Transferwise payment. May or may not be an IBAN. - `transferwise_bank_code` string: The bank code used for a Transferwise payment. May or may not be a BIC. - `merchant_category_code` string: The merchant category code. - `description` string: The description for the Payment. Maximum 140 characters for Payments to external IBANs, 9000 characters for Payments to only other bunq MonetaryAccounts. - `attachment` AttachmentMonetaryAccountPayment[]: The Attachments attached to the Payment. - `id` integer: The id of the attached Attachment. - `monetary_account_id` integer: The id of the MonetaryAccount this Attachment is attached from. - `merchant_reference` string: Optional data included with the Payment specific to the merchant. - `allow_bunqto` boolean: Whether or not sending a bunq.to payment is allowed. - `id` integer: The id of the created Payment. - `created` string: The timestamp when the Payment was done. - `updated` string: The timestamp when the Payment was last updated (will be updated when chat messages are received). - `monetary_account_id` integer: The id of the MonetaryAccount the Payment was made to or from (depending on whether this is an incoming or outgoing Payment). - `alias` LabelMonetaryAccount - `iban` string: The IBAN of the monetary account. - `display_name` string: The name to display with this monetary account. - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - `attachment_public_uuid` string: The public UUID of the public attachment containing the image. - `content_type` string: The content-type as a MIME filetype. - `height` integer: The image height in pixels. - `width` integer: The image width in pixels. - `style` string: The style (if applicable) for this Avatar. - `label_user` LabelUser - `uuid` string: The public UUID of the label-user. - `display_name` string: The name to be displayed for this user, as it was given on the request. - `country` string: The country of the user. 000 stands for "unknown" - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - `attachment_public_uuid` string: The public UUID of the public attachment containing the image. - `content_type` string: The content-type as a MIME filetype. - `height` integer: The image height in pixels. - `width` integer: The image width in pixels. - `style` string: The style (if applicable) for this Avatar. - `public_nick_name` string: The current nickname of the user. - `country` string: The country of the user. Formatted as a ISO 3166-1 alpha-2 country code. - `bunq_me` Pointer - `type` string: The alias type, can be: EMAIL|PHONE_NUMBER|IBAN. - `value` string: The alias value. - `name` string: The alias name. - `service` string: The pointer service. Only required for external counterparties. - `is_light` boolean: Whether or not the monetary account is light. - `swift_bic` string: The BIC used for a SWIFT payment. - `swift_account_number` string: The account number used for a SWIFT payment. May or may not be an IBAN. - `transferwise_account_number` string: The account number used for a Transferwise payment. May or may not be an IBAN. - `transferwise_bank_code` string: The bank code used for a Transferwise payment. May or may not be a BIC. - `merchant_category_code` string: The merchant category code. - `type` string: The type of Payment, can be BUNQ, EBA_SCT, EBA_SDD, IDEAL, SWIFT or FIS (card). - `sub_type` string: The sub-type of the Payment, can be PAYMENT, WITHDRAWAL, REVERSAL, REQUEST, BILLING, SCT, SDD or NLO. - `payment_arrival_expected` PaymentArrivalExpected - `status` string: Indicates when we expect the payment to arrive. - `time` string: The time when the payment is expected to arrive. - `bunqto_status` string: The status of the bunq.to payment. - `bunqto_sub_status` string: The sub status of the bunq.to payment. - `bunqto_share_url` string: The status of the bunq.to payment. - `bunqto_expiry` string: When bunq.to payment is about to expire. - `bunqto_time_responded` string: The timestamp of when the bunq.to payment was responded to. - `batch_id` integer: The id of the PaymentBatch if this Payment was part of one. - `scheduled_id` integer: The id of the JobScheduled if the Payment was scheduled. - `address_shipping` Address - `street` string: The street. - `house_number` string: The house number. - `po_box` string: The PO box. - `postal_code` string: The postal code. - `city` string: The city. - `country` string: The country as an ISO 3166-1 alpha-2 country code. - `extra` string: The apartment, building or other extra information for addresses. - `mailbox_name` string: The name on the mailbox (only used for Postal and Shipping addresses). - `province` string: The province according to local standard. - `is_user_address_updated` boolean: To show whether user created or updated her address for app event listing. - `address_billing` Address - `street` string: The street. - `house_number` string: The house number. - `po_box` string: The PO box. - `postal_code` string: The postal code. - `city` string: The city. - `country` string: The country as an ISO 3166-1 alpha-2 country code. - `extra` string: The apartment, building or other extra information for addresses. - `mailbox_name` string: The name on the mailbox (only used for Postal and Shipping addresses). - `province` string: The province according to local standard. - `is_user_address_updated` boolean: To show whether user created or updated her address for app event listing. - `geolocation` Geolocation - `latitude` integer: The latitude for a geolocation restriction. - `longitude` integer: The longitude for a geolocation restriction. - `altitude` integer: The altitude for a geolocation restriction. - `radius` integer: The radius for a geolocation restriction. - `request_reference_split_the_bill` RequestInquiryReference[]: The reference to the object used for split the bill. Can be RequestInquiry or RequestInquiryBatch - `type` string: The type of request inquiry. Can be RequestInquiry or RequestInquiryBatch. - `id` integer: The id of the request inquiry (batch). - `balance_after_mutation` Amount - `value` string: The amount formatted to two decimal places. - `currency` string: The currency of the amount. It is an ISO 4217 formatted currency code. - `payment_auto_allocate_instance` PaymentAutoAllocateInstance - `id` integer: The id of the PaymentAutoAllocateInstance. - `created` string: The timestamp when the PaymentAutoAllocateInstance was created. - `updated` string: The timestamp when the PaymentAutoAllocateInstance was last updated. - `payment_auto_allocate_id` integer: The ID of the payment auto allocate this instance belongs to. - `status` string: The status of the payment auto allocate instance. SUCCEEDED or FAILED. - `error_message` Error[]: The error message, if the payment auto allocating failed. - object[] - `error_description` string: The error description in English. - `error_description_translated` string: The error description translated to the user's language. - `payment_batch` PaymentBatch - `payments` PaymentBatchAnchoredPayment - `Payment` Payment[] - `payment_id` integer: The ID of the payment that triggered the allocating of the payments. - `all_ginmon_transaction_order` GinmonTransaction[]: All Ginmon transaction orders executed with this instance. - `status` string: The status of the transaction. - `status_description` string: The status of the transaction. - `status_description_translated` string: The translated status of the transaction. - `amount_billing` Amount - `value` string: The amount formatted to two decimal places. - `currency` string: The currency of the amount. It is an ISO 4217 formatted currency code. - `amount_billing_original` Amount - `value` string: The amount formatted to two decimal places. - `currency` string: The currency of the amount. It is an ISO 4217 formatted currency code. - `isin` string: The ISIN of the security. - `external_identifier` string: External identifier of this order at Ginmon. - `label_user` LabelUser - `uuid` string: The public UUID of the label-user. - `display_name` string: The name to be displayed for this user, as it was given on the request. - `country` string: The country of the user. 000 stands for "unknown" - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - … - `style` string: The style (if applicable) for this Avatar. - `public_nick_name` string: The current nickname of the user. - `label_monetary_account` LabelMonetaryAccount - `iban` string: The IBAN of the monetary account. - `display_name` string: The name to display with this monetary account. - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - … - `style` string: The style (if applicable) for this Avatar. - `label_user` LabelUser - `uuid` string: The public UUID of the label-user. - `display_name` string: The name to be displayed for this user, as it was given on the request. - `country` string: The country of the user. 000 stands for "unknown" - `avatar` Avatar - … - `public_nick_name` string: The current nickname of the user. - `country` string: The country of the user. Formatted as a ISO 3166-1 alpha-2 country code. - `bunq_me` Pointer - `type` string: The alias type, can be: EMAIL|PHONE_NUMBER|IBAN. - `value` string: The alias value. - `name` string: The alias name. - `service` string: The pointer service. Only required for external counterparties. - `is_light` boolean: Whether or not the monetary account is light. - `swift_bic` string: The BIC used for a SWIFT payment. - `swift_account_number` string: The account number used for a SWIFT payment. May or may not be an IBAN. - `transferwise_account_number` string: The account number used for a Transferwise payment. May or may not be an IBAN. - `transferwise_bank_code` string: The bank code used for a Transferwise payment. May or may not be a BIC. - `merchant_category_code` string: The merchant category code. - `counter_label_monetary_account` LabelMonetaryAccount - `iban` string: The IBAN of the monetary account. - `display_name` string: The name to display with this monetary account. - `avatar` Avatar - `uuid` string: The public UUID of the avatar. - `anchor_uuid` string: The public UUID of object this avatar is anchored to. - `image` Image[]: The actual image information of this avatar. - … - `style` string: The style (if applicable) for this Avatar. - `label_user` LabelUser - `uuid` string: The public UUID of the label-user. - `display_name` string: The name to be displayed for this user, as it was given on the request. - `country` string: The country of the user. 000 stands for "unknown" - `avatar` Avatar - … - `public_nick_name` string: The current nickname of the user. - `country` string: The country of the user. Formatted as a ISO 3166-1 alpha-2 country code. - `bunq_me` Pointer - `type` string: The alias type, can be: EMAIL|PHONE_NUMBER|IBAN. - `value` string: The alias value. - `name` string: The alias name. - `service` string: The pointer service. Only required for external counterparties. - `is_light` boolean: Whether or not the monetary account is light. - `swift_bic` string: The BIC used for a SWIFT payment. - `swift_account_number` string: The account number used for a SWIFT payment. May or may not be an IBAN. - `transferwise_account_number` string: The account number used for a Transferwise payment. May or may not be an IBAN. - `transferwise_bank_code` string: The bank code used for a Transferwise payment. May or may not be a BIC. - `merchant_category_code` string: The merchant category code. - `event_id` integer: The id of the event of transaction. - `payment_suspended_outgoing` PaymentSuspendedOutgoing - `status` string: The status of the payment. - `monetary_account_id` string: The ID of the monetary account the payment was sent from. - `time_execution` string: The time this payment should be executed. - `payment_fee` PaymentFee - `value` string: The amount formatted to two decimal places. - `currency` string: The currency of the amount. It is an ISO 4217 formatted currency code. - `invoice_id` integer: The id of the invoice related to possible payment fee. ## Other responses - `400`: This is how the error response looks like for 4XX response codes ## Changes - **2025-03-14** `0b53e77a0d7f`: 1 info - added the optional property `payment/payment_fee` to the response with the `200` status - **2024-12-11** `e80b8853e0f0`: 1 info - added the optional property `payment/payment_auto_allocate_instance/all_ginmon_transaction_order` to the response with the `200` status - **2024-06-24** `9c41c6df0fad`: 1 info - added the optional property `payment/payment_suspended_outgoing` to the response with the `200` status - **2024-05-27** `e1c769be8a97`: 1 info - added the optional property `payment/payment_arrival_expected` to the response with the `200` status - **2024-01-08** `8dfb44c77ea0`: 4 warning - removed the optional property `payment/payment_arrival_expected` from the response with the `200` status - removed the optional property `payment/payment_auto_allocate_instance/all_ginmon_transaction_order` from the response with the `200` status - removed the optional property `payment/payment_fee` from the response with the `200` status - removed the optional property `payment/payment_suspended_outgoing` from the response with the `200` status [Operation history](https://skmtc.dev/bunq/apis/bunq-api/changes/user/:userID/monetary-account/:monetary-accountID/currency-conversion/:itemId/get.md) --- [API](https://skmtc.dev/bunq/apis/bunq-api.md) - [All operations](https://skmtc.dev/bunq/apis/bunq-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunq/apis/bunq-api/revisions/369477c7bd26?raw)