GUgusto
Reverse Wire Transactions

Get all reverse wire transactions for a company

Changed on

Returns a paginated list of reverse wire (drawdown) transactions for a company. Reverse wires are debit transactions initiated by Gusto to pull funds from a partner's bank account to cover payroll or contractor payment obligations. Pagination is returned via the x-page, x-per-page, x-total-count, and x-total-pages response headers.

scope: reverse_wire_transactions:read

get/v1/companies/{company_uuid}/reverse_wire_transactions

Request

Path parameters

company_uuidstring required

The UUID of the company

Query parameters

payroll_uuidstring

Filter results to reverse wires associated with a specific payroll

pageinteger

The page that is requested. When unspecified, will load all objects unless endpoint forces pagination.

perinteger

Number of objects per page. For majority of endpoints will default to 25

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Example response

company_uuidstring required

Unique identifier of the company the reverse wire transaction belongs to

amountstring float required

The amount of money moved by the reverse wire, as a decimal string. Always non-negative.

status'pending_processing' | 'processed' | 'rejected' | 'failed' required

Current status of the reverse wire transaction.

  • pending_processing: The reverse wire has been initiated and is awaiting processing by the banking network.
  • processed: The reverse wire was successfully settled and funds have been received.
  • rejected: The reverse wire was rejected by the receiving bank (e.g. invalid account, insufficient funds).
  • failed: The reverse wire failed during processing due to a system or network error.
payment_direction'debit' required

The direction of the payment. Reverse wires are always debits from the company's account.

bank_namestring nullable

Name of the receiving bank. Null when the bank is not known.

payment_event_type'Payroll' | 'ContractorPayment' nullable

The type of payment event this reverse wire is associated with. Null when the wire is not linked to a payroll or contractor payment.

payment_event_uuidstring nullable

Unique identifier of the associated payroll or contractor payment. Null when the wire is not linked to a payment event.

payment_event_check_datestring nullable

The check date of the associated payment event. Null when the wire is not linked to a payment event.

created_atstring required

The date the reverse wire record was created.

Changes