--- title: "Approve a FedNow Transfer" method: POST path: "/fednow_transfers/{fednow_transfer_id}/approve" --- # Approve a FedNow Transfer `POST /fednow_transfers/{fednow_transfer_id}/approve` ## Path parameters - `fednow_transfer_id` string, required — The identifier of the FedNow Transfer to approve. ## Response `200` FedNow Transfer - FednowTransfer — FedNow transfers move funds, within seconds, between your Increase account and any other account supporting FedNow. - `account_id` string, required — The Account from which the transfer was sent. - `account_number` string, required — The destination account number. - `acknowledgement` object, nullable, required — If the transfer is acknowledged by the recipient bank, this will contain supplemental details. - `acknowledged_at` string, date-time, required — When the transfer was acknowledged. - `amount` integer, required — The transfer amount 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 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_address` object, nullable, required — The creditor's address. - `city` string, nullable, required — The city, district, town, or village of the address. - `line1` string, nullable, required — The first line of the address. - `postal_code` string, nullable, required — The ZIP code of the address. - `state` string, nullable, required — The address state. - `creditor_name` string, required — The name of the transfer's recipient. This is set by the sender when creating the transfer. - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transfer's currency. For FedNow transfers this is always equal to `USD`. - `debtor_address` object, nullable, required — The debtor's address. - `city` string, nullable, required — The city, district, town, or village of the address. - `line1` string, nullable, required — The first line of the address. - `postal_code` string, nullable, required — The ZIP code of the address. - `state` string, nullable, required — The address state. - `debtor_name` string, required — The name of the transfer's sender. If not provided, defaults to the name of the account's entity. - `external_account_id` string, nullable, required — The identifier of the External Account the transfer was made to, if any. - `id` string, required — The FedNow 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). - `pending_transaction_id` string, nullable, required — The ID for the pending transaction representing the transfer. - `rejection` object, nullable, required — If the transfer is rejected by FedNow or the destination financial institution, this will contain supplemental details. - `reject_reason_additional_information` string, nullable, required — Additional information about the rejection provided by the recipient bank. - `reject_reason_code` 'account_closed' | 'account_blocked' | 'invalid_creditor_account_type' | 'invalid_creditor_account_number' | 'invalid_creditor_financial_institution_identifier' | 'end_customer_deceased' | 'narrative' | 'transaction_forbidden' | 'transaction_type_not_supported' | 'amount_exceeds_bank_limits' | 'invalid_creditor_address' | 'invalid_debtor_address' | 'timeout' | 'processing_error' | 'other', required — The reason the transfer was rejected as provided by the recipient bank or the FedNow network. - `rejected_at` string, date-time, nullable, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was rejected. - `routing_number` string, required — The destination American Bankers' Association (ABA) Routing Transit Number (RTN). - `source_account_number_id` string, required — The Account Number the recipient will see as having sent the transfer. - `status` 'pending_submitting' | 'pending_reviewing' | 'canceled' | 'reviewing_rejected' | 'requires_attention' | 'pending_approval' | 'pending_response' | 'complete' | 'rejected', required — The lifecycle status of the transfer. - `submission` object, nullable, required — After the transfer is submitted to FedNow, this will contain supplemental details. - `message_identification` string, required — The FedNow network identification of the message submitted. - `submitted_at` string, date-time, nullable, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was submitted to FedNow. - `transaction_id` string, nullable, required — The Transaction funding the transfer once it is complete. - `type` 'fednow_transfer', required — A constant representing the object's type. For this resource it will always be `fednow_transfer`. - `unique_end_to_end_transaction_reference` string, required — The Unique End-to-end Transaction Reference ([UETR](https://www.swift.com/payments/what-unique-end-end-transaction-reference-uetr)) of the transfer. - `unstructured_remittance_information` string, required — Unstructured information that will show on the recipient's bank statement. ## 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)