--- title: "PUT /user/{userID}/monetary-account/{monetary-accountID}/request-response/{itemId}" method: PUT path: "/user/{userID}/monetary-account/{monetary-accountID}/request-response/{itemId}" tags: ["request-response"] --- # PUT /user/{userID}/monetary-account/{monetary-accountID}/request-response/{itemId} `PUT /user/{userID}/monetary-account/{monetary-accountID}/request-response/{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}/request-response/{itemId}` - Auth: none declared. Required headers: `User-Agent`, `X-Bunq-Client-Authentication` Update the status to accept or reject the RequestResponse. ## 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 ## Request body - RequestResponse - `amount_responded` 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. - `status` string: The status of the RequestResponse. Can be ACCEPTED, PENDING, REJECTED, REFUND_REQUESTED, REFUNDED or REVOKED. - `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. - `currency_conversion_quote_id` integer: When the request is accepted on a monetary account with a different currency, a quote is expected to convert. - `id` integer: The id of the Request Response. - `created` string: The timestamp when the Request Response was created. - `updated` string: The timestamp when the Request Response was last updated (will be updated when chat messages are received). - `time_responded` string: The timestamp of when the RequestResponse was responded to. - `time_expiry` string: The timestamp of when the RequestResponse expired or will expire. - `time_refund_requested` string: The timestamp of when a refund request for the RequestResponse was claimed. - `time_refunded` string: The timestamp of when the RequestResponse was refunded. - `user_refund_requested` 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. - `monetary_account_id` integer: The id of the MonetaryAccount the RequestResponse was received on. - `amount_inquired` 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. - `description` string: The description for the RequestResponse provided by the requesting party. Maximum 9000 characters. - `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. - `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. - `attachment` Attachment[]: The Attachments attached to the RequestResponse. - `description` string: The description of the attachment. - `content_type` string: The content type of the attachment's file. - `urls` AttachmentUrl[]: The URLs where the file can be downloaded. - `type` string: The file type of attachment. - `url` string: The URL where the attachment can be downloaded. - `minimum_age` integer: The minimum age the user accepting the RequestResponse must have. - `require_address` string: Whether or not an address must be provided on accept. - `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. - `type` string: The type of the RequestInquiry. Can be DIRECT_DEBIT, DIRECT_DEBIT_B2B, IDEAL, SOFORT or INTERNAL. - `sub_type` string: The subtype of the RequestInquiry. Can be ONCE or RECURRING for DIRECT_DEBIT RequestInquiries and NONE for all other. - `redirect_url` string: The URL which the user is sent to after accepting or rejecting the Request. - `credit_scheme_identifier` string: The credit scheme id provided by the counterparty for DIRECT_DEBIT inquiries. - `mandate_identifier` string: The mandate id provided by the counterparty for DIRECT_DEBIT inquiries. - `registration_action` string: Recommended registration action after IdealIssuerTransaction from iDEAL issuer transaction. - `eligible_whitelist_id` integer: The whitelist id for this action or null. - `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). - `event_id` integer: The ID of the latest event for the request. - `monetary_account_preferred_id` integer: The ID of the monetary account this user prefers to pay the request from. ## Response `200` A RequestResponse is what a user on the other side of a RequestInquiry gets when he is sent one. So a RequestInquiry is the initiator and visible for the user that sent it and that wants to receive the money. A RequestResponse is what the other side sees, i.e. the user that pays the money to accept the request. The content is almost identical. - RequestResponseUpdate - `Id` BunqId - `id` integer: An integer ID of an object. Unique per object type. ## Other responses - `400`: This is how the error response looks like for 4XX response codes --- [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)