---
updatedAt: 2026-05-27T08:29:42.000Z
agentTools:
  projectIndex: https://docs.bridgeapi.io/llms.txt
---

# List beneficiaries

Return a list of your beneficiaries

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Bridge API",
    "version": "2025-01-15",
    "description": "Bridge provides an Open Banking API to initiate payments and aggregate financial data.  \nOur API uses standards such as HTTP verbs, RESTful routing and JSON for payloads.",
    "license": {
      "name": "Proprietary",
      "url": "https://docs.bridgeapi.io"
    },
    "contact": {
      "name": "BridgeAPI",
      "url": "https://bridgeapi.io",
      "email": "support@bridgeapi.io"
    }
  },
  "servers": [
    {
      "description": "Production",
      "url": "https://api.bridgeapi.io"
    }
  ],
  "tags": [
    {
      "name": "Payment account",
      "description": "Our Payment Account service empowers you to effortlessly collect payments and efficiently manage refunds and payouts.\nWe handle the intricacies of payment management on your behalf, simplifying your financial operations."
    }
  ],
  "paths": {
    "/v3/payment/payment-account/beneficiaries": {
      "summary": "Payout beneficiaries",
      "parameters": [
        {
          "$ref": "#/components/parameters/version"
        }
      ],
      "get": {
        "operationId": "ListBeneficiaries",
        "summary": "List beneficiaries",
        "description": "Return a list of your beneficiaries",
        "tags": [
          "Payment account"
        ],
        "responses": {
          "200": {
            "description": "List of your beneficiaries",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "type": "object",
                      "properties": {
                        "resources": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "example": "90da9c34-9baf-401d-8191-250841667fe6"
                              },
                              "first_name": {
                                "type": "string",
                                "example": "John"
                              },
                              "last_name": {
                                "type": "string",
                                "example": "Doe"
                              },
                              "company_name": {
                                "type": "string",
                                "example": "YourCompany"
                              },
                              "bank_name": {
                                "type": "string",
                                "example": "DemoBank"
                              },
                              "iban": {
                                "type": "string",
                                "example": "FR66XXXXXXXXXXXXXXXXXXXXC26"
                              },
                              "bic": {
                                "type": "string",
                                "example": "SMOEFRP3"
                              }
                            }
                          }
                        }
                      }
                    },
                    {
                      "$ref": "#/components/schemas/paginated-result"
                    }
                  ]
                },
                "example": {
                  "resources": [
                    {
                      "id": "90da9c34-9baf-401d-8191-250841667fe6",
                      "iban": "FR66XXXXXXXXXXXXXXXXXXXXC26",
                      "bic": "SMOEFRP3",
                      "bank_name": "DemoBank",
                      "company_name": "YourCompany"
                    },
                    {
                      "id": "5c1aa75c-d688-43be-8a44-0772cf0a79c7",
                      "iban": "FR86XXXXXXXXXXXXXXXXXXXXG67",
                      "bic": "SMOEFRP3",
                      "bank_name": "DemoBank",
                      "company_name": "YourCompany"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "paginated-result": {
        "title": "Pagination response",
        "description": "Represent paginated collection of resources.",
        "type": "object",
        "properties": {
          "resources": {
            "type": "array",
            "items": {}
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_uri": {
                "type": [
                  "null",
                  "string"
                ],
                "example": null
              }
            }
          }
        }
      }
    },
    "parameters": {
      "version": {
        "in": "header",
        "name": "Bridge-Version",
        "schema": {
          "type": "string",
          "enum": [
            "2025-01-15"
          ],
          "default": "2025-01-15"
        },
        "required": true,
        "description": "The Bridge API version"
      }
    },
    "securitySchemes": {
      "clientIdAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Client-Id"
      },
      "clientSecretAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Client-Secret"
      }
    }
  },
  "security": [
    {
      "clientIdAuth": [],
      "clientSecretAuth": []
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false
  }
}
```