> ## 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 items for a mass payment > Retrieve individual payment items within a mass payment with optional status filtering and pagination support. Each item represents a distinct payment with status indicators (failed, pending, success) showing whether a transfer was successfully created. Returns paginated item details including amount, destination, metadata, and error information for failed items. Supports filtering by status and standard pagination. ## OpenAPI ````yaml get /mass-payments/{id}/items 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: /mass-payments/{id}/items: get: tags: - mass payments summary: List items for a mass payment description: >- Retrieve individual payment items within a mass payment with optional status filtering and pagination support. Each item represents a distinct payment with status indicators (failed, pending, success) showing whether a transfer was successfully created. Returns paginated item details including amount, destination, metadata, and error information for failed items. Supports filtering by status and standard pagination. operationId: listMassPaymentItems parameters: - name: id in: path description: Mass payment unique identifier required: true schema: type: string - name: limit in: query description: How many results to return required: false schema: type: string - name: offset in: query description: How many results to skip required: false schema: type: string - name: status in: query description: Filter by item status required: false schema: type: string - $ref: '#/components/parameters/Accept' responses: '200': description: successful operation headers: {} content: application/vnd.dwolla.v1.hal+json: schema: type: object properties: _links: type: object properties: self: type: object properties: href: type: string example: >- https://api.dwolla.com/mass-payments/eb467252-808c-4bc0-b86f-a5cd01454563/items first: type: object properties: href: type: string example: >- https://api.dwolla.com/mass-payments/eb467252-808c-4bc0-b86f-a5cd01454563/items?limit=25&offset=0 last: type: object properties: href: type: string example: >- https://api.dwolla.com/mass-payments/eb467252-808c-4bc0-b86f-a5cd01454563/items?limit=25&offset=0 _embedded: type: object properties: items: type: array items: $ref: '#/components/schemas/MassPaymentItem' total: type: integer format: int32 example: 3 '403': description: Not authorized to list mass payment items headers: {} content: application/vnd.dwolla.v1.hal+json: schema: type: object properties: code: type: string example: Forbidden message: type: string example: Not authorized to list mass payment items. '404': description: Mass payment not found headers: {} content: application/vnd.dwolla.v1.hal+json: schema: type: object properties: code: type: string example: NotFound message: type: string example: Mass payment not found. x-codeSamples: - lang: bash source: > GET https://api-sandbox.dwolla.com/mass-payments/eb467252-808c-4bc0-b86f-a5cd01454563/items 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 massPaymentUrl = "https://api-sandbox.dwolla.com/mass-payments/eb467252-808c-4bc0-b86f-a5cd01454563"; dwolla.get(`${massPaymentUrl}/items`).then((res) => res.body.total); // => 2 - lang: python source: > # Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python mass_payment_url = 'https://api-sandbox.dwolla.com/mass-payments/eb467252-808c-4bc0-b86f-a5cd01454563' mass_payment_items = app_token.get('%s/items' % mass_payment_url) mass_payment_items.body['total'] # => "2" - lang: php source: > getMassPaymentItems($massPaymentUrl); $massPaymentItems->total; # => "2" ?> - lang: ruby source: > # Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby mass_payment_url = 'https://api-sandbox.dwolla.com/mass-payments/eb467252-808c-4bc0-b86f-a5cd01454563' mass_payment_items = app_token.get "#{mass_payment_url}/items" mass_payment_items.total # => 2 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: MassPaymentItem: title: MassPaymentItem type: object properties: _links: type: object properties: self: type: object properties: href: type: string example: >- https://api.dwolla.com/mass-payment-items/c1c7d293-63ec-e511-80df-0aa34a9b2388 mass-payment: type: object properties: href: type: string example: >- https://api.dwolla.com/mass-payments/eb467252-808c-4bc0-b86f-a5cd01454563 destination: type: object properties: href: type: string example: >- https://api.dwolla.com/funding-sources/b442c936-1f87-465d-a4e2-a982164b26bd transfer: type: object properties: href: type: string example: >- https://api.dwolla.com/transfers/fa3999db-41ed-e511-80df-0aa34a9b2388 id: type: string example: 2f845bc9-41ed-e511-80df-0aa34a9b2388 status: type: string example: success amount: type: object properties: value: type: string example: '1.00' currency: type: string example: USD metadata: type: object properties: item1: type: string example: item1 processingChannel: type: object properties: destination: type: string example: real-time-payments securitySchemes: clientCredentials: type: oauth2 flows: clientCredentials: tokenUrl: /token x-speakeasy-token-endpoint-authentication: client_secret_basic scopes: {} ````