> ## Documentation Index > Fetch the complete documentation index at: https://docs.layerfi.com/llms.txt > Use this file to discover all available pages before exploring further. # List vendor refund payments > Fetches a list of vendor refund payments for a business. Results will be paginated, see [Pagination](/api-details/pagination) for details. ## OpenAPI ````yaml get /v1/businesses/{businessId}/bills/refunds/payments openapi: 3.0.1 info: title: API version: latest servers: [] security: - BearerAuth: [] tags: [] externalDocs: url: / paths: /v1/businesses/{businessId}/bills/refunds/payments: get: tags: - Vendor Refunds summary: List vendor refund payments description: >- Fetches a list of vendor refund payments for a business. Results will be paginated, see [Pagination](/api-details/pagination) for details. operationId: business.bills.refunds.payments.get parameters: - name: businessId in: path description: The UUID of the business to fetch vendor refund payments for. required: true schema: type: string format: uuid - name: external_id in: query description: >- Filter vendor refund payments by external ID (unique idempotency key). This will always yield zero or one result. schema: type: string - name: completed_at_start in: query description: >- Filter vendor refund payments by completion date. Payments completed on or after this date will be included. ISO 8601 date format. schema: type: string format: date-time - name: completed_at_end in: query description: >- Filter vendor refund payments by completion date. Payments completed on or before this date will be included. ISO 8601 date format. schema: type: string format: date-time - name: method in: query description: >- Filter vendor refund payments by payment method. Supported values are `CASH`, `CHECK`, `CREDIT_CARD`, `ACH`, `CREDIT_BALANCE`, `OTHER`. schema: type: string - name: processor in: query description: >- Filter vendor refund payments by payment processor (e.g. STRIPE, etc.). schema: type: string - name: min_amount in: query description: >- Filter vendor refund payments by minimum amount. Only payments with amounts greater than or equal to this value will be included. Must be a positive integer. schema: type: integer format: int64 minimum: 0 - name: max_amount in: query description: >- Filter vendor refund payments by maximum amount. Only payments with amounts less than or equal to this value will be included. Must be a positive integer. schema: type: integer format: int64 minimum: 0 - name: memo_contains in: query description: >- Filter vendor refund payments by memo content. Returns payments where the memo contains this string (case-sensitive). schema: type: string - name: memo in: query description: >- Filter vendor refund payments by exact memo match. Returns payments where the memo exactly matches this string. schema: type: string - name: reference_number in: query description: >- Filter by exact reference number match. Returns only records with this exact reference number. required: false schema: type: string - name: reference_numbers in: query description: >- Comma-separated list of reference numbers to filter vendor refund payments by. Only vendor refund payments with reference numbers matching any value in this list will be returned. required: false schema: type: string - name: included_in_payout in: query description: >- Filter vendor refund payments by whether they are included in a vendor payout. Set to `true` to show only payments that are part of a payout, `false` to show only payments not in any payout. schema: type: boolean - name: is_matched in: query description: >- Filter vendor refund payments by match status. If true, only matched payments will be returned. If false, only unmatched payments will be returned. Vendor refund payments are considered matched if they are matched directly, or if they are included in a vendor payout that is matched. schema: type: boolean - name: Content-Type in: header description: Content-Type must be set to application/json. schema: type: string responses: '200': description: List of vendor refund payments. content: application/json: schema: type: array items: $ref: '#/components/schemas/ApiVendorRefundPayment' components: schemas: ApiVendorRefundPayment: type: object properties: id: type: string format: uuid description: Unique identifier for the payment. external_id: type: string nullable: true description: >- Unique ID of the payment in your system for linking purposes. **Idempotency key**. example: payment-456 refunded_amount: type: integer format: int64 description: Amount refunded to the business in cents. refund_processing_fee: type: integer format: int64 nullable: true description: Fee charged for the refund processing in cents. completed_at: type: string format: date-time description: Time when the payment was completed. method: type: string description: Method of the payment. example: ACH processor: type: string nullable: true description: Processor used for the payment. example: STRIPE payment_clearing_account: $ref: '#/components/schemas/SingleApiChartAccount' description: >- The the ledger account to use for the payment (overrides the default determined by the payment method), if specified. transaction_tags: type: array items: $ref: '#/components/schemas/ApiTag' memo: type: string nullable: true description: >- Memo for any text you would like to associate with the vendor refund payment (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the vendor refund payment. Can be used to filter when listing vendor refund payments. description: >- A payment represents a transaction that moves value from a vendor to a business. A specific bill can be refunded or a general refund can be applied to a vendor. SingleApiChartAccount: type: object properties: id: $ref: '#/components/schemas/AccountIdentifier' name: type: string description: Name of the account. example: Current Assets account_number: type: string nullable: true description: Account number if configured. example: '4000' stable_name: $ref: '#/components/schemas/AccountStableName' normality: $ref: '#/components/schemas/BankTransactionDirection' account_type: $ref: '#/components/schemas/ApiLedgerAccountType' account_subtype: $ref: '#/components/schemas/ApiLedgerAccountSubtype' description: A single ledger account without nested children. ApiTag: type: object properties: id: type: string format: uuid description: ID for the tag. key: type: string description: Key for the tag. example: ExampleTagKey dimension_display_name: type: string nullable: true description: Display name for the tag dimension. value: type: string description: Value for the tag. example: ExampleTagValue value_display_name: type: string nullable: true description: Display name for the tag value definition. dimension_id: type: string format: uuid description: ID of the tag dimension this tag belongs to. definition_id: type: string format: uuid description: ID of the tag value definition. archived_at: type: string format: date-time nullable: true description: When the tag was archived. required: - id - key - value - dimension_id - definition_id PlatformDefinedJson: type: object description: Arbitrary JSON data defined by the caller, with a 1KB size constraint. additionalProperties: true example: custom_field: value any valid json: below 1kb nested: meaning of life: 42 array: [] AccountIdentifier: oneOf: - $ref: '#/components/schemas/AccountId' description: ID of the account. title: Account ID - $ref: '#/components/schemas/AccountStableName' description: Stable name associated with the account. title: Account Stable Name AccountStableName: type: object required: - type - stable_name properties: type: type: string enum: - StableName description: Resource type. Value will be `StableName`. example: StableName stable_name: type: string example: CURRENT_ASSETS description: Stable name of the account. BankTransactionDirection: type: string enum: - CREDIT - DEBIT ApiLedgerAccountType: type: object properties: value: $ref: '#/components/schemas/LedgerAccountType' description: Type of the account. display_name: type: string description: Display name of the account type. example: Asset ApiLedgerAccountSubtype: type: object properties: value: $ref: '#/components/schemas/LedgerAccountSubtype' display_name: type: string description: Display name of the account subtype. example: Current Assets AccountId: type: object required: - type - id properties: type: type: string enum: - AccountId description: Resource type. Value will be `AccountId`. example: AccountId id: type: string format: uuid description: ID of the account. LedgerAccountType: type: string enum: - ASSET - LIABILITY - EQUITY - REVENUE - COGS - EXPENSE LedgerAccountSubtype: type: string enum: - BANK_ACCOUNTS - ACCOUNTS_RECEIVABLE - INVENTORY - PAYMENT_PROCESSOR_CLEARING_ACCOUNT - FIXED_ASSET - ACCUMULATED_DEPRECIATION - CASH - UNDEPOSITED_FUNDS - CURRENT_ASSET - NON_CURRENT_ASSET - PREPAID_EXPENSES - DEVELOPMENT_COSTS - LOANS_RECEIVABLE - INTANGIBLE_ASSET - ACCOUNTS_PAYABLE - CREDIT_CARD - TAXES_PAYABLE - INCOME_TAXES_PAYABLE - SALES_TAXES_PAYABLE - OTHER_TAXES_PAYABLE - PAYROLL_TAXES_PAYABLE - UNEARNED_REVENUE - PAYROLL_LIABILITY - PAYROLL_CLEARING - LINE_OF_CREDIT - TIPS - REFUND_LIABILITIES - UNDEPOSITED_OUTFLOWS - OUTGOING_PAYMENT_CLEARING_ACCOUNT - OTHER_CURRENT_LIABILITY - LOANS_PAYABLE - NOTES_PAYABLE - SHAREHOLDER_LOAN - NON_CURRENT_LIABILITY - CONTRIBUTIONS - DISTRIBUTIONS - COMMON_STOCK - PREFERRED_STOCK - ADDITIONAL_PAID_IN_CAPITAL - RETAINED_EARNINGS - ACCUMULATED_ADJUSTMENTS - OPENING_BALANCE_EQUITY - OTHER_EQUITY - SALES - UNCATEGORIZED_REVENUE - RETURNS_ALLOWANCES - DIVIDEND_INCOME - INTEREST_INCOME - OTHER_INCOME - COGS - OPERATING_EXPENSES - PAYROLL - TAXES_LICENSES - UNCATEGORIZED_EXPENSE - CHARITABLE_CONTRIBUTIONS - LOAN_EXPENSES - FINANCE_COSTS - INTEREST_EXPENSES - DEPRECIATION - AMORTIZATION - BAD_DEBT - OTHER_EXPENSES securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ````