# BMButtonSearch API Operation (NVP) (/api/nvp-soap/button-search-nvp)



Lists your hosted PayPal Payments Standard buttons.

> **Note:** **Important:**
> The Button Manager API is deprecated. For new integrations, see the associated topic.
>
> | Button                                          | See                                                                               |
> | ----------------------------------------------- | --------------------------------------------------------------------------------- |
> | **Buy Now**<br />                               | [PayPal Checkout Overview](/checkout)<br />                                       |
> | **Add to Cart**<br />                           | [Solution Providers](https://www.paypal.com/webapps/mpp/solution-providers)<br /> |
> | **Donate**<br />                                | [Create a Donate button](/api/nvp-soap/paypal-payments-pro)<br />                 |
> | **Automatic Billing**<br /> **Subscribe**<br /> | [Subscriptions Overview](/subscriptions/about)<br />                              |

## BMButtonSearch request [#bmbuttonsearch-request]

The request contains optional fields that are not currently used. All hosted buttons are automatically requested.

## BMButtonSearch request parameters [#bmbuttonsearch-request-parameters]

| Field<br />       | Description<br />                                                                                                                                     |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `METHOD`<br />    | *(Required)* `BMButtonSearch`<br />                                                                                                                   |
| `STARTDATE`<br /> | *(Required)* Starting date for the search. The value must be in UTC/GMT format. For example, `2012-08-24T05:38:48Z`. No wild cards are allowed.<br /> |
| `ENDDATE`<br />   | *(Optional)* Ending date for the search. The value must be in UTC/GMT format. For example, `2013-05-01T05:38:48Z`. No wild cards are allowed.<br />   |

## BMButtonSearch response [#bmbuttonsearch-response]

The response lists all hosted buttons and their associated characteristics.

## BMButtonSearch response fields [#bmbuttonsearch-response-fields]

| Field                     | Description                                                                                                  |
| ------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `L_HOSTEDBUTTONIDn`<br /> | The hosted button ID<br /> Lists variables, where n is a digit between 0 and 9, inclusive.<br />             |
| `L_BUTTONTYPEn`<br />     | The hosted button ID<br /> Lists variables, where n is a digit between 0 and 9, inclusive.<br />             |
| `L_ITEMNAMEn`<br />       | The item name<br /> Lists variables, where n is a digit between 0 and 9, inclusive.<br />                    |
| `L_MODIFYDATEn`<br />     | The date created or last changed<br /> Lists variables, where n is a digit between 0 and 9, inclusive.<br /> |

## BMButtonSearch errors [#bmbuttonsearch-errors]

| Error code | Short and long messages                                                                                                               | User action                                                                                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 10001      | Internal Error<br />Internal Error                                                                                                    | To learn more about possible causes and corrective actions, see [What is API error code 10001?](https://www.paypal.com/selfhelp/article/what-is-api-error-code-10001-ts1041/3?channel=MTS). |
| 11994      | Search Warning<br />You have exceeded the maximum number of buttons that can be returned. If required, adjust your search parameters. |                                                                                                                                                                                             |
| 11997      | Invalid Argument<br />You must specify a start date.                                                                                  |                                                                                                                                                                                             |
| 11998      | Invalid Argument<br />The start date is invalid.                                                                                      |                                                                                                                                                                                             |
| 11999      | Invalid Argument<br />The end date is invalid.                                                                                        |                                                                                                                                                                                             |