---
title: "List Wire Drawdown Requests"
method: GET
path: "/wire_drawdown_requests"
---

# List Wire Drawdown Requests

`GET /wire_drawdown_requests`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `status.in` string[] — Filter Wire Drawdown Requests for those with the specified status. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`.
- `idempotency_key` string — Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

## Response `200`

Wire Drawdown Request List

- WireDrawdownRequestList — A list of Wire Drawdown Request objects.
  - `data` WireDrawdownRequest[], required — The contents of the list.
    - `account_number_id` string, required — The Account Number to which the debtor—the recipient of this request—is being requested to send funds.
    - `amount` integer, required — The amount being requested in cents.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the wire drawdown request was created.
    - `creditor_address` object, required — The creditor's address.
      - `city` string, required — The city, district, town, or village of the address.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code for the country of the address.
      - `line1` string, required — The first line of the address.
      - `line2` string, nullable, required — The second line of the address.
      - `postal_code` string, nullable, required — The postal code of the address.
      - `state` string, nullable, required — The address state.
    - `creditor_name` string, required — The creditor's name.
    - `currency` string, required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the amount being requested. Will always be "USD".
    - `debtor_account_number` string, required — The debtor's account number.
    - `debtor_address` object, required — The debtor's address.
      - `city` string, required — The city, district, town, or village of the address.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code for the country of the address.
      - `line1` string, required — The first line of the address.
      - `line2` string, nullable, required — The second line of the address.
      - `postal_code` string, nullable, required — The postal code of the address.
      - `state` string, nullable, required — The address state.
    - `debtor_external_account_id` string, nullable, required — The debtor's external account identifier.
    - `debtor_name` string, required — The debtor's name.
    - `debtor_routing_number` string, required — The debtor's routing number.
    - `end_to_end_identification` string, nullable, required — A free-form reference string set by the sender, to be mirrored back in the subsequent wire transfer.
    - `fulfillment_inbound_wire_transfer_id` string, nullable, required — If the recipient fulfills the drawdown request by sending funds, then this will be the identifier of the corresponding Transaction.
    - `id` string, required — The Wire drawdown request identifier.
    - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
    - `status` 'pending_submission' | 'fulfilled' | 'pending_response' | 'refused', required — The lifecycle status of the drawdown request.
    - `submission` object, nullable, required — After the drawdown request is submitted to Fedwire, this will contain supplemental details.
      - `input_message_accountability_data` string, required — The input message accountability data (IMAD) uniquely identifying the submission with Fedwire.
    - `type` 'wire_drawdown_request', required — A constant representing the object's type. For this resource it will always be `wire_drawdown_request`.
    - `unique_end_to_end_transaction_reference` string, nullable, required — The unique end-to-end transaction reference ([UETR](https://www.swift.com/payments/what-unique-end-end-transaction-reference-uetr)) of the drawdown request.
    - `unstructured_remittance_information` string, required — Remittance information the debtor will see as part of the drawdown request.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)
