> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get payment methods

> Use GET /billing/pmethods in the Bright Data Account Management API to list active, confirmed payment methods and whether each supports auto-recharge.

The `GET /billing/pmethods` endpoint returns the active, confirmed payment methods on your Bright Data account. Use the `id` of a payment method to turn on auto-recharge with [Set regular auto-recharge](https://docs.brightdata.com/api-reference/account-management-api/Set_regular_auto_recharge.md) or [Set dataset auto-recharge](https://docs.brightdata.com/api-reference/account-management-api/Set_dataset_auto_recharge.md).

> [!TIP]
>
> Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](https://docs.brightdata.com/api-reference/authentication.md#how-do-i-generate-a-new-api-key%3F).

## Which API key permission does this endpoint need?

`GET /billing/pmethods` requires the `billing.read` permission. API keys with the **Admin** or **Finance** [permission level](https://docs.brightdata.com/api-reference/authentication.md#what-permissions-level-does-an-api-key-have) have it. Without it, the endpoint returns HTTP 403 with a plain-text message. Manage API key permissions in [Account settings](https://brightdata.com/cp/setting/users).

## How do I list my payment methods?

Call `GET /billing/pmethods`. The endpoint takes no parameters:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.brightdata.com/billing/pmethods"
```

The response contains a `pmethods` array with one entry per payment method.

## How is the response structured?

Each entry in the `pmethods` array describes one payment method:

| Field | Type | Description |
| - | - | - |
| `id` | string | Payment method ID. Pass this value as `pmethod_id` to the auto-recharge endpoints |
| `type` | string | Payment method type, for example `ccard` |
| `primary` | boolean | `true` for the primary payment method of the account |
| `autorecharge_supported` | boolean | `true` when the API can turn on auto-recharge with this payment method |
| `card` | object | Card payment methods only: `brand`, `last4`, `exp_month` and `exp_year` |
| `paypal` | object | PayPal payment methods only: `email` |

## Which payment method can I use for auto-recharge?

Use a payment method where `autorecharge_supported` is `true`. To print only those payment methods, filter the response with [jq](https://jqlang.org/):

```bash theme={null}
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.brightdata.com/billing/pmethods" \
  | jq '.pmethods[] | select(.autorecharge_supported)'
```

The auto-recharge endpoints reject a payment method that does not support auto-recharge with HTTP 400 and `error_code` `pmethod_not_supported`.

## What are the rate limits for the billing endpoints?

The billing endpoints allow 1,000 requests per minute and 5,000 requests per hour. Over the limit, the endpoint returns HTTP 429 with a plain-text body.

## Related endpoints

* [Get auto-recharge settings](https://docs.brightdata.com/api-reference/account-management-api/Get_auto_recharge_settings.md). Current regular and dataset auto-recharge settings.
* [Set regular auto-recharge](https://docs.brightdata.com/api-reference/account-management-api/Set_regular_auto_recharge.md). Turn regular auto-recharge on or off, or change its amount.
* [Total balance](https://docs.brightdata.com/api-reference/account-management-api/Get_total_balance_through_API.md). Account balance, credit, prepayment and pending usage costs.


## OpenAPI

````yaml api-reference/openapi GET /billing/pmethods
openapi: 3.0.1
info:
  title: Bright Data API
  description: >-
    Integrate Bright Data APIs to your pipeline and secure high-end scraping
    precision
  version: 1.0.0
servers:
  - url: https://api.brightdata.com
security:
  - bearerAuth: []
paths:
  /billing/pmethods:
    get:
      description: >-
        Get the active, confirmed payment methods of your account. Requires the
        `billing.read` permission.
      operationId: listPaymentMethods
      responses:
        '200':
          description: Payment methods
          content:
            application/json:
              schema:
                type: object
                required:
                  - pmethods
                properties:
                  pmethods:
                    type: array
                    items:
                      $ref: '#/components/schemas/BillingPaymentMethod'
        '401':
          description: Authentication failed
          content:
            text/plain:
              schema:
                type: string
              example: User authentication is required
        '403':
          description: The API key lacks the required permission
          content:
            text/plain:
              schema:
                type: string
              example: >-
                Your API key lacks the required permissions for this action. You
                can change your token permissions at
                https://brightdata.com/cp/setting/users
        '429':
          description: Rate limit exceeded (1,000 requests per minute, 5,000 per hour)
          content:
            text/plain:
              schema:
                type: string
components:
  schemas:
    BillingPaymentMethod:
      type: object
      description: A payment method of your account.
      required:
        - id
        - type
        - primary
        - autorecharge_supported
      properties:
        id:
          type: string
          description: Payment method ID
          example: 64f0c2a1e4b0a1b2c3d4e5f6
        type:
          type: string
          description: Payment method type
          example: ccard
        primary:
          type: boolean
          description: '`true` for the primary payment method of the account.'
        autorecharge_supported:
          type: boolean
          description: '`true` when the API can enable auto-recharge on this payment method.'
        card:
          type: object
          description: Card details. Only for card payment methods.
          required:
            - brand
            - last4
            - exp_month
            - exp_year
          properties:
            brand:
              type: string
              example: visa
            last4:
              type: string
              pattern: ^[0-9]{4}$
              example: '4242'
            exp_month:
              type: integer
              minimum: 1
              maximum: 12
            exp_year:
              type: integer
              example: 2028
        paypal:
          type: object
          description: PayPal details. Only for PayPal payment methods.
          required:
            - email
          properties:
            email:
              type: string
              format: email
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Use your Bright Data API Key as a Bearer token in the Authorization
        header.


        **How to authenticate:**

        1. Obtain your API Key from the Bright Data account settings at
        https://brightdata.com/cp/setting/users

        2. Include the API Key in the Authorization header of your requests

        3. Format: `Authorization: Bearer YOUR_API_KEY`


        **Example:**

        ```

        Authorization: Bearer
        b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df

        ```


        Learn how to get your Bright Data API key:
        https://docs.brightdata.com/api-reference/authentication
      bearerFormat: API Key

````