> ## Documentation Index > Fetch the complete documentation index at: https://developers.dwolla.com/llms.txt > Use this file to discover all available pages before exploring further. # List mass payments for customer > Retrieve all previously created mass payments for a Verified Customer account with optional correlation ID filtering and pagination support. Mass payments are returned ordered by date created with most recent appearing first. Returns paginated results including mass payment status, metadata, source funding information, and item links. Supports standard pagination parameters and correlation ID search for enhanced traceability. ## OpenAPI ````yaml get /customers/{id}/mass-payments openapi: 3.1.0 info: title: Dwolla API description: Dwolla API Documentation contact: name: Dwolla Developer Relations Team url: https://developers.dwolla.com email: api@dwolla.com version: '2.0' termsOfService: https://www.dwolla.com/legal/tos/ license: name: MIT url: https://github.com/Dwolla/dwolla-openapi/blob/master/LICENSE servers: - url: https://api.dwolla.com description: Production server - url: https://api-sandbox.dwolla.com description: Sandbox server security: - clientCredentials: [] tags: - name: tokens description: Operations related to Application Access Tokens - name: root description: Root API operations - name: accounts description: Operations related to Accounts - name: customers description: Operations related to Customers - name: kba description: Operations related to Knowledge-Based Authentication - name: beneficial owners description: Operations related to Beneficial Owners - name: documents description: Operations related to Documents - name: exchanges description: Operations related to Exchanges - name: exchange sessions description: Operations related to Exchange Sessions - name: funding sources description: Operations related to Funding Sources - name: transfers description: Operations related to Transfers - name: labels description: Operations related to Labels - name: mass payments description: Operations related to Mass Payments - name: events description: Operations related to Events - name: webhook subscriptions description: Operations related to Webhook Subscriptions - name: webhooks description: Operations related to Webhooks - name: client tokens description: Operations related to Client Tokens - name: sandbox simulations description: Sandbox-only operations for simulating processing of bank transfers paths: /customers/{id}/mass-payments: get: tags: - mass payments summary: List mass payments for customer description: >- Retrieve all previously created mass payments for a Verified Customer account with optional correlation ID filtering and pagination support. Mass payments are returned ordered by date created with most recent appearing first. Returns paginated results including mass payment status, metadata, source funding information, and item links. Supports standard pagination parameters and correlation ID search for enhanced traceability. operationId: listCustomerMassPayments parameters: - name: id in: path description: Customer ID to get mass payments for required: true schema: type: string - name: correlationId in: query description: >- A string value to search on if `correlationId` was specified for a transaction required: false schema: type: string - name: limit in: query description: Number of search results to return. Defaults to 25 required: false schema: type: integer - name: offset in: query description: Number of search results to skip. Use for pagination required: false schema: type: integer - $ref: '#/components/parameters/Accept' responses: '200': description: successful operation headers: {} content: application/vnd.dwolla.v1.hal+json: schema: $ref: '#/components/schemas/MassPayments' '403': description: Not authorized to list mass payments headers: {} content: application/vnd.dwolla.v1.hal+json: schema: type: object properties: code: type: string example: NotAuthorized message: type: string example: Not authorized to list mass payments. '404': description: Customer not found headers: {} content: application/vnd.dwolla.v1.hal+json: schema: type: object properties: code: type: string example: NotFound message: type: string example: Customer not found. x-codeSamples: - lang: bash source: > GET https://api-sandbox.dwolla.com/customers/39e21228-5958-4c4f-96fe-48a4bf11332d/mass-payments Accept: application/vnd.dwolla.v1.hal+json Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY - lang: javascript source: | // Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node var customerUrl = "https://api-sandbox.dwolla.com/customers/ca32853c-48fa-40be-ae75-77b37504581b"; dwolla .get(`${customerUrl}/mass-payments`, { limit: 10 }) .then((res) => res.body._embedded["mass-payments"][0].status); // => "complete" - lang: python source: > # Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python customer_url = 'https://api-sandbox.dwolla.com/customers/ca32853c-48fa-40be-ae75-77b37504581b' mass_payments = app_token.get('%s/mass-payments' % customer_url) mass_payments.body['_embedded']['mass-payments'][0]['status'] # => 'complete' - lang: php source: > getByCustomer($customerUrl); $masspayments->_embedded->{'mass-payments'}[0]->status; # => "complete" ?> - lang: ruby source: > # Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby customer_url = 'https://api-sandbox.dwolla.com/customers/ca32853c-48fa-40be-ae75-77b37504581b' mass_payments = app_token.get "#{customer_url}/mass-payments", limit: 10 mass_payments._embedded['mass-payments'][0].status # => "complete" components: parameters: Accept: name: Accept in: header required: true description: >- The media type of the response. Must be application/vnd.dwolla.v1.hal+json schema: type: string enum: - application/vnd.dwolla.v1.hal+json default: application/vnd.dwolla.v1.hal+json schemas: MassPayments: title: MassPayments type: object properties: _links: type: object additionalProperties: $ref: '#/components/schemas/HalLink' _embedded: type: object properties: mass-payments: type: array items: $ref: '#/components/schemas/MassPayment' total: type: integer example: 100 HalLink: title: HalLink type: object properties: href: type: string example: https://api.dwolla.com type: type: string example: application/vnd.dwolla.v1.hal+json resource-type: type: string example: resource-type MassPayment: title: MassPayment type: object properties: _links: type: object additionalProperties: $ref: '#/components/schemas/HalLink' id: type: string example: 11ac4051-7b76-44fc-87ab-ae23012393f0 status: type: string example: complete created: type: string format: date-time example: '2022-01-20T17:41:41.000Z' metaData: type: object total: $ref: '#/components/schemas/TransferAmount' totalFees: $ref: '#/components/schemas/TransferAmount' correlationId: type: string example: CID-8a2cdc8d-629d-4a24-98ac-40b735229fe2 TransferAmount: title: TransferAmount type: object required: - value - currency properties: value: type: string example: '5.00' currency: type: string example: USD securitySchemes: clientCredentials: type: oauth2 flows: clientCredentials: tokenUrl: /token x-speakeasy-token-endpoint-authentication: client_secret_basic scopes: {} ````