# List Applications

Retrieve a list of . If there are no , an empty collection is returned. 

For details on how to query endpoints using the available parameters, see Query Parameters.

Endpoint: GET /applications
Version: 2022-02-01
Security: BasicAuth

## Header parameters:

  - `Accept` (string)

## Query parameters:

  - `before_cursor` (string)
    Return every resource created before the cursor value.

  - `after_cursor` (string)
    Return every resource created after the cursor value.

  - `limit` (integer)
    The numbers of items to return.
    Example: 3

  - `created_at.gte` (string)
    Filter where  is after the given date.
    Example: "2022-09-27T11:21:23"

  - `created_at.lte` (string)
    Filter where  is before the given date.
    Example: "2026-09-27T11:21:23"

  - `updated_at.gte` (string)
    Filter where  is after the given date.
    Example: "2022-09-27T11:21:23"

  - `updated_at.lte` (string)
    Filter where  is before the given date.
    Example: "2026-09-27T11:21:23"

  - `id` (string)
    Filter by the Application's ID.
    Example: "APgPDQrLD52TYvqazjHJJchM"

  - `name.like` (string)
    Filter by the Application's .
    Example: "Finix%20Flowers"

  - `owner_identity_business_name.like` (string)
    Filter by the Application Owner Identity's business name.
    Example: "Finix%20Flowers"

  - `owner_identity_doing_business_as.like` (string)
    Filter by the Application Owner Identity's Doing Business As (DBA).
    Example: "Finix%20Flowers%20Inc"

  - `owner_identity_email.like` (string)
    Filter by the Application Owner Identity's email.
    Example: "john.doe@finix.com"

  - `owner_identity_first_name.like` (string)
    Filter by the Application Owner Identity's first name.
    Example: "john"

  - `owner_identity_id` (string)
    Filter by the Application Owner Identity's ID.
    Example: "IDfuTjQubvNjKBwzp2k5WNmW"

  - `owner_identity_last_name.like` (string)
    Filter by the Application Owner Identity's last name.
    Example: "doe"

  - `processing_enabled` (boolean)
    Filter by whether the Application's processing is enabled.
    Example: true

  - `settlement_enabled` (boolean)
    Filter by whether the Application's settlements are enabled.
    Example: true

## Response 200 fields (application/json):

  - `page` (object)
    Details the page that's returned.

  - `page.limit` (integer)
    The number of entries to return.

  - `page.next_cursor` (string,null)
    The cursor to use for the next page of results.

  - `_embedded` (object)
    List of  resources.

  - `_embedded.applications` (array)
    resources.

  - `_embedded.applications.id` (string)
    ID of the  resource.
    Example: "APxxxxxxxxxxxxxxxxxx"

  - `_embedded.applications.created_at` (string)
    Point in time when this object was created.

  - `_embedded.applications.updated_at` (string)
    Point in time when this object was most recently updated.

  - `_embedded.applications.account_updater_enabled` (boolean)
    When enabled at the -level, Finix automatically checks for updates with card networks for all payment cards created after the feature is activated. This Account Updater functionality:

- Automatically updates card details (e.g., number or expiration date) to maintain continuity of charges, increasing authorization rates.
- Saves cardholders the hassle of updating card details across merchants.
- Applies to all payment instruments by default but can be disabled for specific cards.

The default value is  as explicit opt-in is required.

: Cards created before the feature is enabled are unaffected by default. To include these cards, you can manually enable the Account Updater functionality for each card individually using a PUT request. Once enabled, you can link the card to this API call to trigger updates with card networks.

  - `_embedded.applications.card_cvv_required` (boolean)
    Details if the  requires CVV code.

  - `_embedded.applications.card_expiration_date_required` (boolean)
    Details if the  requires the card's expiration date.

  - `_embedded.applications.creating_transfer_from_report_enabled` (boolean)
    Details if the  is automatically set to create  once settlement reports get generated.

  - `_embedded.applications.disbursements_ach_pull_enabled` (boolean)
    Indicates whether ACH pull disbursements (debits) are enabled, allowing funds to be withdrawn from an account via ACH transfer.

  - `_embedded.applications.disbursements_ach_push_enabled` (boolean)
    Indicates whether ACH push disbursements (credits) are enabled, allowing funds to be sent to an account via ACH transfer.

  - `_embedded.applications.disbursements_card_pull_enabled` (boolean)
    Indicates whether card pull disbursements (debits) are enabled, allowing funds to be withdrawn from a card.

  - `_embedded.applications.disbursements_card_push_enabled` (boolean)
    Indicates whether card push disbursements (credits) are enabled, allowing funds to be sent to a card.

  - `_embedded.applications.disbursements_same_day_ach_pull_enabled` (boolean)
    Indicates whether same-day ACH pull disbursements (debits) are enabled, allowing funds to be withdrawn from an account via same-day ACH transfer.

  - `_embedded.applications.disbursements_same_day_ach_push_enabled` (boolean)
    Indicates whether same-day ACH push disbursements (credits) are enabled, allowing funds to be sent to an account via same-day ACH transfer.

  - `_embedded.applications.enabled` (boolean)
    Details if the  is enabled and active. Set to  to disable the .

  - `_embedded.applications.fee_ready_to_settle_upon` (string,null)
    Details when the  of  submitted under the  will be ready to settle.
    Enum: "RECONCILIATION", "SUCCESSFUL_CAPTURE", "PROCESSOR_WINDOW", "CONFIGURABLE_WINDOW"

  - `_embedded.applications.instant_payouts_card_push_enabled` (boolean)
    Set to  if you want to allow the merchant to be enabled for settlement instant payouts.

  - `_embedded.applications.name` (string)
    The name of the .

  - `_embedded.applications.network_token_enabled` (boolean)
    When enabled at the  level, "network tokens" replace raw card details (e.g., the 16-digit PAN and expiration date) for transactions. Network tokens have several benefits:

- Network tokens offer increased authorization rates, even for lost or stolen cards, as they remain valid while the physical card is replaced.
- Visa reduces interchange fees when using network tokens.
- Tokens enhance security by replacing card details with a non-sensitive string that is usable only within the Finix system.

The default value is  as explicit opt-in is required.

: Cards created before the feature is enabled are unaffected. To include them, update an individual . Then, you can insert the hyperlink on the "update".

  - `_embedded.applications.owner` (string)
    ID of the  resource that created the .
    Example: "IDxxxxxxxxxxxxxxxxxx"

  - `_embedded.applications.processing_enabled` (boolean)
    Details if transaction processing is enabled for the .

  - `_embedded.applications.ready_to_settle_upon` (string,null)
    Details when transactions submitted under the  will be ready to settle.
    Enum: "RECONCILIATION", "SUCCESSFUL_CAPTURE", "PROCESSOR_WINDOW", "CONFIGURABLE_WINDOW"

  - `_embedded.applications.ready_to_settle_upon_delay_alignment` (string)
    Indicates whether transaction settlement should be delayed to synchronize the timing of all transactions, including both card and ACH, ensuring they are settled together.

Possible values include:

-  - Align all transactions to match the timing of ACH settlements, so card transactions settle at the same speed as ACH transactions.
-  - Default behavior where card transactions settle the next day (T+1) and ACH transactions settle two days later (T+2).
    Enum: "ACH", "NONE"

  - `_embedded.applications.settlement_approval_enabled` (boolean)
    Indicates whether manual approval is required before settlements are processed.

  - `_embedded.applications.settlement_enabled` (boolean)
    Details if settlement approvals are enabled for the .

  - `_embedded.applications.settlement_funding_identifier` (string)
    Includes additional information (like the MID or  name) when submitting funding  to processors.
- : No additional details get provided to the processor.
- : The  of the  and the date the funding  was submitted (Date is in UTC). e.g 
- : The  of the  and the  (white spaces will be removed). e.g. 

These details appear alongside the seller's payout in their bank account as a description of the deposit.
    Enum: "UNSET", "MID_AND_DATE", "MID_AND_MERCHANT_NAME"

  - `_embedded.applications.settlement_queue_mode` (string)
    If  is set to , Finix will automatically place all transactions (Sales, Fees, Refunds, and ACH Returns) into a settlement queue that you can manage. Each transaction will have a .

When a  is created, it will not be placed into  until the  is explicitly released.

Note: We require the release of all settlement queue entries within 30 days of creation.
    Enum: "UNSET", "MANUAL"

  - `_embedded.applications.tags` (object,null)
    Include up to 50  pairs to annotate requests with custom metadata.
- Maximum character length for individual  is 40.
- Maximum character length for individual  is 500.
(For example, , , )

  - `_embedded.applications.unreferenced_refund_manual_entry_enabled` (boolean)
    Indicates if application is allowed to process unreferenced refunds initiated through manual card entry on Finix terminals.

  - `_embedded.applications._links` (object)
    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these  to make your follow-up requests and quickly access relevant IDs.

  - `_embedded.applications._links.authorizations` (object)

  - `_embedded.applications._links.authorizations.href` (string)

  - `_embedded.applications._links.application_profile` (object)

  - `_embedded.applications._links.disputes` (object)

  - `_embedded.applications._links.identities` (object)

  - `_embedded.applications._links.merchants` (object)

  - `_embedded.applications._links.owner_identity` (object)

  - `_embedded.applications._links.payment_instruments` (object)

  - `_embedded.applications._links.processors` (object)

  - `_embedded.applications._links.reversals` (object)

  - `_embedded.applications._links.self` (object)
    Link to the resource that was used in the request.

  - `_embedded.applications._links.settlements` (object)

  - `_embedded.applications._links.tokens` (object)

  - `_embedded.applications._links.transfers` (object)

  - `_embedded.applications._links.users` (object)

  - `_embedded.applications._links.webhooks` (object)

## Response 401 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "UNKNOWN"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.self` (object)

  - `_embedded.errors._links.self.href` (string)

  - `_embedded.errors._links.source` (object)

## Response 403 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "FORBIDDEN"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)

## Response 404 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "NOT_FOUND"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)

## Response 406 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "NOT_FOUND"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)