Increase Inbound Fednow Transfers API
The Inbound Fednow Transfers API from Increase — 2 operation(s) for inbound fednow transfers.
OpenAPI Specification
openapi: 3.1.0
info:
description: Anything that you can achieve with PDFs, presence, and persistence in a bank branch you can do with our API. We've always wanted a fully programmatic bank so we built one. Our API faithfully exposes the data and capabilities of the Federal Reserve, Visa, The Clearing House, depository networks, and accounting tools. It's lovingly boring and exceptionally powerful. If you have any questions or want to get started, don't hesitate to ping us at sales@increase.com. We can't wait to see what you build!
title: Increase Account Numbers Inbound Fednow Transfers API
version: 0.0.1
servers:
- url: https://api.increase.com
- url: https://sandbox.increase.com
security:
- bearerAuth: []
tags:
- name: Inbound Fednow Transfers
paths:
/inbound_fednow_transfers:
get:
operationId: list_inbound_fednow_transfers
parameters:
- in: query
name: cursor
required: false
schema:
description: Return the page of entries after this one.
type: string
x-documentation-priority: low
- in: query
name: limit
required: false
schema:
description: Limit the size of the list that is returned. The default (and maximum) is 100 objects.
minimum: 1
type: integer
x-documentation-priority: low
- example: account_in71c4amph0vgo2qllky
in: query
name: account_id
required: false
schema:
description: Filter Inbound FedNow Transfers to those belonging to the specified Account.
type: string
x-documentation-priority: default
x-id-reference-to: Accounts
- in: query
name: account_number_id
required: false
schema:
description: Filter Inbound FedNow Transfers to ones belonging to the specified Account Number.
type: string
x-documentation-priority: default
x-id-reference-to: Account Numbers
- in: query
name: created_at.after
required: false
schema:
description: Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
format: date-time
type: string
x-documentation-priority: low
- in: query
name: created_at.before
required: false
schema:
description: Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
format: date-time
type: string
x-documentation-priority: low
- in: query
name: created_at.on_or_after
required: false
schema:
description: Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
format: date-time
type: string
x-documentation-priority: low
- in: query
name: created_at.on_or_before
required: false
schema:
description: Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
format: date-time
type: string
x-documentation-priority: low
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/inbound_fednow_transfer_list'
description: Inbound FedNow Transfer List
4XX:
$ref: '#/components/responses/errorResponse'
5XX:
$ref: '#/components/responses/errorResponse'
summary: List Inbound FedNow Transfers
x-sandbox-only: false
x-tag: Inbound FedNow Transfers
tags:
- Inbound Fednow Transfers
/inbound_fednow_transfers/{inbound_fednow_transfer_id}:
get:
operationId: retrieve_an_inbound_fednow_transfer
parameters:
- example: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
in: path
name: inbound_fednow_transfer_id
required: true
schema:
description: The identifier of the Inbound FedNow Transfer to get details for.
type: string
x-documentation-priority: default
x-id-reference-to: Inbound FedNow Transfers
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/inbound_fednow_transfer'
description: Inbound FedNow Transfer
4XX:
$ref: '#/components/responses/errorResponse'
5XX:
$ref: '#/components/responses/errorResponse'
summary: Retrieve an Inbound FedNow Transfer
x-sandbox-only: false
x-tag: Inbound FedNow Transfers
tags:
- Inbound Fednow Transfers
components:
schemas:
inbound_fednow_transfer:
additionalProperties: false
description: An Inbound FedNow Transfer is a FedNow transfer initiated outside of Increase to your account.
example:
account_id: account_in71c4amph0vgo2qllky
account_number_id: account_number_v18nkfqm6afpsrvy82b2
amount: 100
confirmation:
transfer_id: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
created_at: '2020-01-31T23:59:59Z'
creditor_name: Ian Crease
currency: USD
debtor_account_number: '987654321'
debtor_name: National Phonograph Company
debtor_routing_number: '101050001'
decline:
reason: account_number_disabled
transfer_id: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
id: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
status: confirmed
transaction_id: transaction_uyrp7fld2ium70oa7oi
type: inbound_fednow_transfer
unstructured_remittance_information: Invoice 29582
properties:
account_id:
description: The Account to which the transfer was sent.
type: string
x-documentation-priority: default
x-id-reference-to: Accounts
account_number_id:
description: The identifier of the Account Number to which this transfer was sent.
type: string
x-documentation-priority: default
x-id-reference-to: Account Numbers
amount:
description: The amount in USD cents.
type: integer
x-documentation-priority: default
confirmation:
anyOf:
- additionalProperties: true
description: If your transfer is confirmed, this will contain details of the confirmation.
example:
transfer_id: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
properties:
transfer_id:
description: The identifier of the FedNow Transfer that led to this Transaction.
type: string
x-documentation-priority: default
x-id-reference-to: Inbound FedNow Transfers
required:
- transfer_id
title: Inbound FedNow Transfer Inbound FedNow Transfer Confirmation
type: object
x-documentation-priority: default
x-event-categories: []
x-stainless-empty-object: false
x-title-plural: Inbound FedNow Transfer Confirmations
- type: 'null'
created_at:
description: The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was created.
format: date-time
type: string
x-documentation-priority: default
creditor_name:
description: The name the sender of the transfer specified as the recipient of the transfer.
type: string
x-documentation-priority: default
currency:
description: The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code of the transfer's currency. This will always be "USD" for a FedNow transfer.
enum:
- USD
type: string
x-documentation-priority: default
x-enum-descriptions:
- US Dollar (USD)
debtor_account_number:
description: The account number of the account that sent the transfer.
type: string
x-documentation-priority: default
debtor_name:
description: The name provided by the sender of the transfer.
type: string
x-documentation-priority: default
debtor_routing_number:
description: The routing number of the account that sent the transfer.
type: string
x-documentation-priority: default
decline:
anyOf:
- additionalProperties: true
description: If your transfer is declined, this will contain details of the decline.
example:
reason: account_number_disabled
transfer_id: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
properties:
reason:
description: Why the transfer was declined.
enum:
- account_number_canceled
- account_number_disabled
- account_restricted
- group_locked
- entity_not_active
- fednow_not_enabled
type: string
x-documentation-priority: default
x-enum-descriptions:
- The account number is canceled.
- The account number is disabled.
- Your account is restricted.
- Your account is inactive.
- The account's entity is not active.
- Your account is not enabled to receive FedNow transfers.
transfer_id:
description: The identifier of the FedNow Transfer that led to this declined transaction.
type: string
x-documentation-priority: default
x-id-reference-to: Inbound FedNow Transfers
required:
- reason
- transfer_id
title: Inbound FedNow Transfer Inbound FedNow Transfer Decline
type: object
x-documentation-priority: default
x-event-categories: []
x-stainless-empty-object: false
x-title-plural: Inbound FedNow Transfer Declines
- type: 'null'
id:
description: The inbound FedNow transfer's identifier.
type: string
x-documentation-priority: default
x-id-reference-to: Inbound FedNow Transfers
status:
description: The lifecycle status of the transfer.
enum:
- pending_confirming
- timed_out
- confirmed
- declined
- requires_attention
type: string
x-documentation-priority: default
x-enum-descriptions:
- The transfer is pending confirmation.
- The transfer was not responded to in time.
- The transfer has been received successfully and is confirmed.
- The transfer has been declined.
- The transfer requires attention from an Increase operator.
transaction_id:
anyOf:
- description: The identifier of the Transaction object created when the transfer was confirmed.
type: string
x-documentation-priority: default
x-id-reference-to: Transactions
- type: 'null'
type:
description: A constant representing the object's type. For this resource it will always be `inbound_fednow_transfer`.
enum:
- inbound_fednow_transfer
type: string
x-documentation-priority: default
unstructured_remittance_information:
anyOf:
- description: Additional information included with the transfer.
type: string
x-documentation-priority: default
- type: 'null'
required:
- type
- id
- amount
- currency
- creditor_name
- debtor_name
- debtor_account_number
- debtor_routing_number
- unstructured_remittance_information
- status
- account_id
- account_number_id
- created_at
- transaction_id
- decline
- confirmation
title: Inbound FedNow Transfer
type: object
x-event-categories:
- inbound_fednow_transfer.created
- inbound_fednow_transfer.updated
x-stainless-empty-object: false
x-tag: Inbound FedNow Transfers
x-title-plural: Inbound FedNow Transfers
error:
anyOf:
- properties:
detail:
anyOf:
- type: string
- type: 'null'
status:
enum:
- 404
type: integer
title:
type: string
type:
enum:
- api_method_not_found_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
status:
enum:
- 403
type: integer
title:
type: string
type:
enum:
- environment_mismatch_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
resource_id:
description: ''
type: string
x-documentation-priority: default
status:
enum:
- 409
type: integer
title:
type: string
type:
enum:
- idempotency_key_already_used_error
type: string
required:
- type
- title
- detail
- status
- resource_id
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
status:
enum:
- 403
type: integer
title:
type: string
type:
enum:
- insufficient_permissions_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
status:
enum:
- 500
type: integer
title:
type: string
type:
enum:
- internal_server_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
reason:
description: ''
enum:
- deleted_credential
- expired_credential
- ip_not_allowed
- no_credential
- no_header
- no_api_access
- wrong_environment
type: string
x-documentation-priority: default
x-enum-descriptions:
- deleted_credential
- expired_credential
- ip_not_allowed
- no_credential
- no_header
- no_api_access
- wrong_environment
status:
enum:
- 401
type: integer
title:
type: string
type:
enum:
- invalid_api_key_error
type: string
required:
- type
- title
- detail
- status
- reason
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
status:
enum:
- 409
type: integer
title:
type: string
type:
enum:
- invalid_operation_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
errors:
description: All errors related to parsing the request parameters.
items:
additionalProperties: true
properties: {}
title: ErrorsElement
type: object
x-event-categories: []
x-stainless-empty-object: false
x-title-plural: ErrorsElements
type: array
x-documentation-priority: default
status:
enum:
- 400
type: integer
title:
type: string
type:
enum:
- invalid_parameters_error
type: string
required:
- type
- title
- detail
- status
- errors
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
status:
enum:
- 400
type: integer
title:
type: string
type:
enum:
- malformed_request_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
status:
enum:
- 404
type: integer
title:
type: string
type:
enum:
- object_not_found_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
status:
enum:
- 403
type: integer
title:
type: string
type:
enum:
- private_feature_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
- properties:
detail:
anyOf:
- type: string
- type: 'null'
retry_after:
anyOf:
- description: ''
type: integer
x-documentation-priority: default
- type: 'null'
status:
enum:
- 429
type: integer
title:
type: string
type:
enum:
- rate_limited_error
type: string
required:
- type
- title
- detail
- status
type: object
x-event-categories: []
inbound_fednow_transfer_list:
additionalProperties: true
description: A list of Inbound FedNow Transfer objects.
example:
data:
- account_id: account_in71c4amph0vgo2qllky
account_number_id: account_number_v18nkfqm6afpsrvy82b2
amount: 100
confirmation:
transfer_id: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
created_at: '2020-01-31T23:59:59Z'
creditor_name: Ian Crease
currency: USD
debtor_account_number: '987654321'
debtor_name: National Phonograph Company
debtor_routing_number: '101050001'
decline:
reason: account_number_disabled
transfer_id: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
id: inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20
status: confirmed
transaction_id: transaction_uyrp7fld2ium70oa7oi
type: inbound_fednow_transfer
unstructured_remittance_information: Invoice 29582
next_cursor: v57w5d
properties:
data:
description: The contents of the list.
items:
$ref: '#/components/schemas/inbound_fednow_transfer'
type: array
x-documentation-priority: default
next_cursor:
anyOf:
- description: 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`.
type: string
x-documentation-priority: default
- type: 'null'
required:
- data
- next_cursor
title: Inbound FedNow Transfer List
type: object
x-event-categories: []
x-stainless-empty-object: false
x-title-plural: Inbound FedNow Transfer Lists
responses:
errorResponse:
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/error'
description: Error
securitySchemes:
bearerAuth:
scheme: bearer
type: http
x-tagGroups:
- name: Accounts
tags:
- Accounts
- Account Numbers
- Account Transfers
- name: Transactions
tags:
- Transactions
- Pending Transactions
- Declined Transactions
- name: Ach Transfers
tags:
- ACH Transfers
- Inbound ACH Transfers
- ACH Prenotifications
- name: Check Transfers
tags:
- Check Transfers
- Inbound Check Deposits
- name: Real Time Payments Transfers
tags:
- Real-Time Payments Transfers
- Inbound Real-Time Payments Transfers
- name: Fednow Transfers
tags:
- FedNow Transfers
- Inbound FedNow Transfers
- name: Swift Transfers
tags:
- Swift Transfers
- name: Wire Transfers
tags:
- Wire Transfers
- Inbound Wire Transfers
- Wire Drawdown Requests
- Inbound Wire Drawdown Requests
- name: Card Transfers
tags:
- Card Tokens
- Card Push Transfers
- Card Validations
- name: Check Deposits
tags:
- Check Deposits
- Lockbox Addresses
- Lockbox Recipients
- Inbound Mail Items
- name: Cards
tags:
- Cards
- Card Payments
- Card Purchase Supplements
- Card Disputes
- Physical Cards
- Digital Card Profiles
- Physical Card Profiles
- Digital Wallet Tokens
- name: Compliance
tags:
- Entities
- Beneficial Owners
- Supplemental Documents
- Entity Onboarding Sessions
- Programs
- name: Events and Webhooks
tags:
- Events
- Event Subscriptions
- Real-Time Decisions
- name: External Accounts
tags:
- Routing Numbers
- External Accounts
- name: Files and Exports
tags:
- Account Statements
- Files
- File Links
- Exports
- name: OAuth
tags:
- Groups
- OAuth Applications
- OAuth Connections
- OAuth Tokens
- name: Intrafi
tags:
- IntraFi Account Enrollments
- IntraFi Balances
- IntraFi Exclusions