--- title: "Retrieve a Wire Transfer" method: GET path: "/wire_transfers/{wire_transfer_id}" --- # Retrieve a Wire Transfer `GET /wire_transfers/{wire_transfer_id}` ## Path parameters - `wire_transfer_id` string, required — The identifier of the Wire Transfer. ## Response `200` Wire Transfer - WireTransfer — Wire transfers move funds between your Increase account and any other account accessible by Fedwire. - `account_id` string, required — The Account to which the transfer belongs. - `account_number` string, required — The destination account number. - `amount` integer, required — The transfer amount in USD cents. - `approval` object, nullable, required — If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval. - `approved_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was approved. - `approved_by` string, nullable, required — If the Transfer was approved by a user in the dashboard, the email address of that user. - `cancellation` object, nullable, required — If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation. - `canceled_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Transfer was canceled. - `canceled_by` string, nullable, required — If the Transfer was canceled by a user in the dashboard, the email address of that user. - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was created. - `created_by` object, nullable, required — What object created the transfer, either via the API or the dashboard. - `api_key` object, nullable — If present, details about the API key that created the transfer. - `description` string, nullable, required — The description set for the API key when it was created. - `category` 'api_key' | 'oauth_application' | 'user', required — The type of object that created this transfer. - `oauth_application` object, nullable — If present, details about the OAuth Application that created the transfer. - `name` string, required — The name of the OAuth Application. - `user` object, nullable — If present, details about the User that created the transfer. - `email` string, required — The email address of the User. - `creditor` object, nullable, required — The person or business that is receiving the funds from the transfer. - `address` object, nullable, required — The person or business's address. - `unstructured` object, nullable, required — Unstructured address lines. - `line1` string, nullable, required — The first line. - `line2` string, nullable, required — The second line. - `line3` string, nullable, required — The third line. - `name` string, nullable, required — The person or business's name. - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transfer's currency. For wire transfers this is always equal to `usd`. - `debtor` object, nullable, required — The person or business whose funds are being transferred. - `address` object, nullable, required — The person or business's address. - `unstructured` object, nullable, required — Unstructured address lines. - `line1` string, nullable, required — The first line. - `line2` string, nullable, required — The second line. - `line3` string, nullable, required — The third line. - `name` string, nullable, required — The person or business's name. - `external_account_id` string, nullable, required — The identifier of the External Account the transfer was made to, if any. - `id` string, required — The wire transfer's 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). - `inbound_wire_drawdown_request_id` string, nullable, required — The ID of an Inbound Wire Drawdown Request in response to which this transfer was sent. - `network` 'wire', required — The transfer's network. - `pending_transaction_id` string, nullable, required — The ID for the pending transaction representing the transfer. A pending transaction is created when the transfer [requires approval](https://increase.com/documentation/transfer-approvals#transfer-approvals) by someone else in your organization. - `remittance` object, nullable, required — Remittance information sent with the wire transfer. - `category` 'unstructured' | 'tax', required — The type of remittance information being passed. - `tax` object, nullable — Internal Revenue Service (IRS) tax repayment information. Required if `category` is equal to `tax`. - `date` string, date, required — The month and year the tax payment is for, in YYYY-MM-DD format. The day is ignored. - `identification_number` string, required — The 9-digit Tax Identification Number (TIN) or Employer Identification Number (EIN). - `type_code` string, required — The 5-character tax type code. - `unstructured` object, nullable — Unstructured remittance information. Required if `category` is equal to `unstructured`. - `message` string, required — The message to the beneficiary. - `reversal` object, nullable, required — If your transfer is reversed, this will contain details of the reversal. - `amount` integer, required — The amount that was reversed in USD cents. - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the reversal was created. - `debtor_routing_number` string, nullable, required — The debtor's routing number. - `description` string, required — The description on the reversal message from Fedwire, set by the reversing bank. - `input_cycle_date` string, date, required — The Fedwire cycle date for the wire reversal. The "Fedwire day" begins at 9:00 PM Eastern Time on the evening before the `cycle date`. - `input_message_accountability_data` string, required — The Fedwire transaction identifier. - `input_sequence_number` string, required — The Fedwire sequence number. - `input_source` string, required — The Fedwire input source identifier. - `instruction_identification` string, nullable, required — The sending bank's identifier for the reversal. - `return_reason_additional_information` string, nullable, required — Additional information about the reason for the reversal. - `return_reason_code` string, nullable, required — A code provided by the sending bank giving a reason for the reversal. The common return reason codes are [documented here](/documentation/wire-reversals#reversal-reason-codes). - `return_reason_code_description` string, nullable, required — An Increase-generated description of the `return_reason_code`. - `transaction_id` string, required — The ID for the Transaction associated with the transfer reversal. - `wire_transfer_id` string, required — The ID for the Wire Transfer that is being reversed. - `routing_number` string, required — The American Bankers' Association (ABA) Routing Transit Number (RTN). - `source_account_number_id` string, nullable, required — The Account Number that was passed to the wire's recipient. - `status` 'pending_approval' | 'canceled' | 'pending_creating' | 'pending_reviewing' | 'rejected' | 'requires_attention' | 'reversed' | 'submitted' | 'complete', required — The lifecycle status of the transfer. - `submission` object, nullable, required — After the transfer is submitted to Fedwire, this will contain supplemental details. - `input_message_accountability_data` string, required — The accountability data for the submission. - `submitted_at` string, date-time, required — When this wire transfer was submitted to Fedwire. - `transaction_id` string, nullable, required — The ID for the transaction funding the transfer. - `type` 'wire_transfer', required — A constant representing the object's type. For this resource it will always be `wire_transfer`. - `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 transfer. ## 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)