# BMGetButtonDetails API Operation (NVP) (/api/nvp-soap/get-button-details-nvp) Shows information about a hosted PayPal Payments Standard button. > **Note:** **Important:** > > The Button Manager API is deprecated. For new integrations, see the associated topic. > > | Button | See | > | ----------------------------------------------- | ------------------------------------------------------------------------------------ | > | **Buy Now**
| [PayPal Checkout Overview](/checkout)
| > | **Add to Cart**
| [Solution Providers](https://www.paypal.com/us/webapps/mpp/solution-providers)
| > | **Donate**
| [Create a Donate button](/api/nvp-soap/paypal-payments-pro)
| > | **Automatic Billing**
**Subscribe**
| [Subscriptions Overview](/subscriptions/about)
| You can use this information to set the fields that have not changed when updating a button. ## BMGetButtonDetails request [#bmgetbuttondetails-request] The request includes only the ID of the hosted button whose details you want to obtain. ### BMGetButtonDetails request parameters [#bmgetbuttondetails-request-parameters] | Field
| Description
| | ---------------------- | -------------------------------------------------------------------------------- | | `METHOD`
| *(Required)* `BMGetButtonDetails`
| | `HOSTEDBUTTONID`
| *(Required)* The ID of the hosted button whose details you want to obtain.
| ## BMGetButtonDetails response [#bmgetbuttondetails-response] The response fields contain all non-inventory information related to the button. ### BMGetButtonDetails response fields [#bmgetbuttondetails-response-fields] | Field
| Description
| | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `BUTTONTYPE`
| The kind of button. Value is:

`BUYNOW`. The **Buy Now** button.
`CART`. The **Add to Cart** button.
`SUBSCRIBE`. The **Subscribe** button.
`DONATE`. The **Donate** button.
`UNSUBSCRIBE`. The **Unsubscribe** button.
`VIEWCART`. The **View Cart** button.
`AUTOBILLING`. The **Automatic Billing** button. Since version 63.0.
| | `BUTTONCODE`
| The kind of button code. Value is:

`HOSTED`. A secure button stored on PayPal.
`ENCRYPTED`. An encrypted button, not stored on PayPal.
`CLEARTEXT`. An unencrypted button, not stored on PayPal.
| | `BUTTONSUBTYPE`
| The use of button. Value is:

`PRODUCTS`. The button is used to purchase products.
`SERVICES`. The button to purchase services.
| | `HOSTEDBUTTONID`
| ID of a PayPal-hosted button.
| | `WEBSITECODE`
| HTML code for web pages
| | `EMAILLINK`
| Code for email links and links in other documents that support external links
| | `L_BUTTONVARn`
| HTML standard button variables
| ### Option details fields [#option-details-fields] | Field
| Description
| | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OPTIONnNAME`
| *(Optional)* The menu name.
It is one or more variables, in which n is a digit between 0 and 4, inclusive, for hosted buttons; otherwise, it is a digit between 0 and 9, inclusive.
| ### Option selection details fields [#option-selection-details-fields] | Field | Description | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `L_OPTIONnSELECTx`
| *(Optional)* The menu item's name
It is a list of variables for each `OPTIONnNAME`, in which x is a digit between 0 and 9, inclusive
| | `L_OPTION0PRICEx`
| *(Optional)* The price associated with the first menu item.
It is a list of variables for each `OPTION0NAME`, in which x is a digit between 0 and 9, inclusive
> **Note:** **Note:** If you specify a price, you cannot set a button variable to `amount`. | ## BMGetButtonDetails errors [#bmgetbuttondetails-errors] | Error code | Short and long messages | User action | | ---------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 10001 | Internal Error
Internal Error | To learn more about possible causes and corrective actions, see [What is API error code 10001?](https://www.paypal-knowledge.com/infocenter/index?page=content\&expand=true\&locale=en_US\&id=FAQ1041). | | 11950 | Invalid Data
A hosted button ID must be specified. | | | 11951 | Invalid Argument
The hosted button ID specified is invalid. | | | 11951 | Operation Refused
Operation not supported for Sample Buttons. | | | 11992 | Invalid Argument
You do not have permissions to access this button. Verify the hosted button ID and try the request again. | |