# Fire Business API Documentation ## Guides - [Get started with accounts](https://docs.fire.com/docs/payments-accounts.md): After creating your Fire account with the help of our sales team and integrating with our API, you can start reviewing your account details and create recurring payments. - [SWIFT accounts](https://docs.fire.com/docs/swift.md): The SWIFT network is a global messaging network allowing members to exchange information. It enables Fire customers to receive international payments directly to their Fire account. - [Get started with debit cards](https://docs.fire.com/docs/debit-cards.md): Manage your business expenses and subscriptions. Fire is a principal issuer of MasterCard® since 2016, making us one of the first payment institutions to be authorised as a member. Our debit cards can be used for in-store payments, online shopping, and ATM cash withdrawals. We employ security protocols such as Strong Customer Authentication (SCA) and 3D Secure (3DS) to bolster the safety of our debit cards. We ensure that our customers' transactions are protected against unauthorised access, reinforcing our commitment to providing a trusted and secure financial experience. - [Get started with FX](https://docs.fire.com/docs/fx-international-transfers.md): Reduce your FX costs with our competitive rates. Use the Fire Payments API to view our rates, and pair with our payment endpoints. - [Authentication](https://docs.fire.com/docs/authentication.md): Once you have a library set-up, you'll need to authenticate your application information. - [Get a client SDK](https://docs.fire.com/docs/get-an-sdk.md): In order to use the Fire Payments API, you will need access to our OpenAPI specification. - [Overview](https://docs.fire.com/docs/getting-started.md): Fire provides access to a range of payment services, including accounts, bank transfers, debit cards, FX, and open banking payments. With our platform and licences, we deliver solutions that automate payment processing and make reconciliation easier, more cost-effective and secure. The Fire Payments API enables you to deeply integrate Business Account features into your application or back-office systems. Whether initiating payments out, segregating funds or automating reconciliation, our powerful API can be used to enhance and simplify a range of payment processes. - [Get started with open banking](https://docs.fire.com/docs/open-banking-payments.md): Get paid faster, lower your fees and reduce fraud. Fire is among the first companies in Ireland and the UK to offer open banking payment acceptance, viewing it as the initial stage of account-based payments. We anticipate further innovation and regulatory changes leading to the evolution of account-based payments beyond open banking. As a dually regulated business, Fire uses its own technology and licences to provide payment services and is dedicated to introducing this new payment method to the Irish and UK markets. - [Get started with batches](https://docs.fire.com/docs/accounts-1.md): Transfer funds into your Fire account for automatic distribution to employees or contractors. - [Verification of Payee](https://docs.fire.com/docs/vop.md): Verification of Payee (VoP) will come into affect in October 2025. This page summarises the impacts and effects for users of the Fire Payments API. - [Get started with webhooks](https://docs.fire.com/docs/webhooks.md): Fire offers webhooks that provide real-time notifications on events, enabling you to trigger specific API actions such as automatically transferring funds across accounts based on predefined rules. ## API Reference - [Create a new Fire Account.](https://docs.fire.com/reference/addaccount.md): This endpoint will create a new Fire account on your profile. You will need to enable PERM_BUSINESS_POST_ACCOUNTS to use this endpoint. **Please note there is a charge associated with creating a new account.** - [Get details of an account](https://docs.fire.com/reference/getaccountbyid.md): This endpoint will return an array of information about the account. You can retrieve the details of a Fire Account by its `ican`. You will need to enable PERM_BUSINESS_GET_ACCOUNT to use this endpoint. - [Get details of an account (V2)](https://docs.fire.com/reference/getaccountbyidv2.md): This endpoint will return an array of information about the account. You can retrieve the details of a Fire Account by its `ican`. You will need to enable PERM_BUSINESS_GET_ACCOUNT to use this endpoint. - [List accounts](https://docs.fire.com/reference/getaccounts.md): This endpoint returns all the accounts on your Fire profile. Ordered by Alias ascending. Can be paginated. You will need to enable PERM_BUSINESS_GET_ACCOUNTS to use this endpoint. - [List accounts (V2)](https://docs.fire.com/reference/getaccountsv2.md): This endpoint returns all the accounts on your Fire profile. Ordered by Alias ascending. Can be paginated. You will need to enable PERM_BUSINESS_GET_ACCOUNTS to use this endpoint. - [Get activity](https://docs.fire.com/reference/getactivities.md): This endpoint will retrieve the details of all activity on your Fire Accounts. You will need to enable PERM_BUSINESS_GET_ACTIVITIES to use this endpoint. - [Request international account details](https://docs.fire.com/reference/requestinternationaldetails.md): This endpoint will request international account details to be added to your Fire account. You will need to enable PERM_BUSINESS_PUT_ACCOUNT_INTERNATIONALDETAILS to use this endpoint. - [Update account configuration](https://docs.fire.com/reference/updateaccountconfig.md): This endpoint changes the name associated with an account. You will need to enable PERM_BUSINESS_PUT_ACCOUNT to use this endpoint. - [Create an API Application](https://docs.fire.com/reference/createapiapplication.md): This endpoint will create a new API Application on your Fire account with your chosen specified permissions. Please note that if there is no batch approval permissions included, the approval fields must be set to null. You will need to enable PERM_BUSINESS_POST_APPS to use this endpoint. - [List all permissions for API applications](https://docs.fire.com/reference/getallpermissions.md): This endpoint will list all permissions available for any API application you have created on your Fire account. You will need to enable PERM_BUSINESS_GET_APPS_PERMISSIONS to use this endpoint. - [List all API applications](https://docs.fire.com/reference/getapiapplications.md): This endpoint returns a list of API applications created under your Fire account. You will need to enable PERM_BUSINESS_GET_APPS to use this endpoint. - [List all permissions for an API application](https://docs.fire.com/reference/getpermissions.md): This endpoint will return all permissions you selected for a specific API application on your Fire account. You will need to enable PERM_BUSINESS_GET_APP_PERMISSIONS to use this endpoint. - [List all webhooks](https://docs.fire.com/reference/getwebhookevents.md): This endpoint lists all webhooks on your Fire account. You will need to enable PERM_BUSINESS_GET_WEBHOOKS to use this endpoint. - [Send test webhooks](https://docs.fire.com/reference/sendtestwebhook.md): This endpoint sends a test webhook response for a selected event to the chosen URL. You will need to enable PERM_BUSINESS_GET_WEBHOOK_EVENT_TEST to use this endpoint. - [Authenticate with the API.](https://docs.fire.com/reference/authenticate.md): This endpoint is needed to generate your access token. Access to the API is by Bearer Access Tokens. These are valid for 15 minutes. You can have multiple Access Tokens active at the same time if needed. See the [Guide to Authentication](/docs/authentication) for full details. - [Add a bank transfer to a batch.](https://docs.fire.com/reference/addbanktransferbatchpayment.md): This endpoint will add a new bank transfer payment to a batch. There are two ways to process bank transfers - by Payee ID (**Mode 1**) or by Payee Account Details (**Mode 2**). **Mode 1:** Use the payee IDs of existing approved payees set up against your account. These batches can be approved in the normal manner. **Mode 2:** Use the account details of the payee. In the event that these details correspond to an existing approved payee, the batch can be approved as normal. If the account details are new, a batch of New Payees will automatically be created. This batch will need to be approved before the Payment batch can be approved. These payees will then exist as approved payees for future batches. You will need to enable PERM_BUSINESS_POST_BATCH_BANKTRANSFERS to use this endpoint. - [Add an internal transfer to a Batch](https://docs.fire.com/reference/addinternaltransferbatchpayment.md): This endpoint will add an internal transfer payment to an existing batch. Simply specify the source account, destination account, amount and a reference. You will need to enable PERM_BUSINESS_POST_BATCH_INTERNALTRANSFERS to use this endpoint. - [Add an international transfer to a Batch](https://docs.fire.com/reference/addinternationaltransferbatchpayment.md): This endpoint allows you to add an international transfer to a batch. International transfers must be added to a batch using the Payee ID (**Mode 1**). Payees must be set up using the web application. **Mode 1:** Use the payee IDs of existing approved payees set up against your account. These batches can be approved in the normal manner. - [Cancel a batch](https://docs.fire.com/reference/cancelbatchpayment.md): This endpoint will cancel a Batch from being processed. You can only cancel a batch before it is submitted for approval (while it is in the OPEN state). You will need to enable PERM_BUSINESS_DELETE_BATCH to use this endpoint. - [Create a new batch](https://docs.fire.com/reference/createbatchpayment.md): This endpoint will create a new batch. This opens a new batch container to hold specific transaction types in a certain currency. You will need to enable PERM_BUSINESS_POST_BATCHES to use this endpoint. - [Remove a bank transfer from a batch.](https://docs.fire.com/reference/deletebanktransferbatchpayment.md): This endpoint will remove a payment from the Batch (Bank Transfers). You can only remove payments before the batch is submitted for approval (while it is in the OPEN state). You will need to enable PERM_BUSINESS_DELETE_BATCH_BANKTRANSFERS to use this endpoint. - [Remove an internal transfer from a batch](https://docs.fire.com/reference/deleteinternaltransferbatchpayment.md): This endpoint will remove a Payment from the Batch (Internal Transfer). You can only remove payments before the batch is submitted for approval (while it is in the OPEN state). You will need to enable PERM_BUSINESS_DELETE_BATCH_INTERNALTRANSFERS to use this endpoint. - [Remove an international transfer from a batch](https://docs.fire.com/reference/deleteinternationaltransferbatchpayment.md): This endpoint will remove a payment from an existing Batch (International Transfers). You can only remove payments before the batch is submitted for approval (while it is in the OPEN state). You will need to enable PERM_BUSINESS_DELETE_BATCH_INTERNATIONALTRANSFERS to use this endpoint. - [List all batches](https://docs.fire.com/reference/getbatches.md): This endpoint will return a list of batches with the specified types and statuses. You will need to enable PERM_BUSINESS_GET_BATCHES to use this endpoint. - [Get the details of a batch](https://docs.fire.com/reference/getdetailssinglebatch.md): This endpoint will return the details of the batch specified in the API endpoint - {batchUuid}. You will need to enable PERM_BUSINESS_GET_BATCH to use this endpoint. - [List items for a bank transfer batch](https://docs.fire.com/reference/getitemsbatchbanktransfer.md): This endpoint returns a paginated list of items in the specified batch. You will need to enable PERM_BUSINESS_GET_BATCH_BANKTRANSFERS to use this endpoint. - [List items for an internal transfer batch](https://docs.fire.com/reference/getitemsbatchinternaltrasnfer.md): This endpoint returns returns a paginated list of items in the specified batch. You will need to enable PERM_BUSINESS_GET_BATCH_INTERNALTRANSFERS to use this endpoint. - [List items for an international transfer batch](https://docs.fire.com/reference/getitemsbatchinternationaltransfer.md): Returns a paginated list of items in the specified batch. You will need to enable PERM_BUSINESS_GET_BATCH_INTERNATIONALTRANSFERS to use this endpoint. - [List approvals for a batch.](https://docs.fire.com/reference/getlistofapproversforbatch.md): This endpoint will return a list of the approvers for the selected batch. You will need to enable PERM_BUSINESS_GET_BATCH_APPROVALS to use this endpoint. - [List new payees in a batch](https://docs.fire.com/reference/getnewpayeebatch.md): This endpoint will retrieve a list of details of batch items with new payees. You will need to enable PERM_BUSINESS_GET_BATCH_NEWPAYEES to use this endpoint. - [Submit a batch](https://docs.fire.com/reference/submitbatch.md): This endpoint allows you to submit a Batch (for approval in the case of a **BANK_TRANSFER** or **INTERNATIONAL_TRANSFER**). If this is an **INTERNAL_TRANSFER** batch, the transfers are immediately queued for processing. If this is a **BANK_TRANSFER** or **INTERNATIONAL_TRANSFER** batch, this will trigger requests for approval to the firework mobile apps of authorised users. Once those users approve the batch, it is queued for processing. You can only submit a batch while it is in the OPEN state. You will need to enable PERM_BUSINESS_PUT_BATCH to use this endpoint. - [Block a Fire debit card](https://docs.fire.com/reference/blockcard.md): This endpoint allows you to block a card on your Fire account. This updates the status of an existing card to block which prevents any transactions being carried out with that card. You will need to enable PERM_BUSINESS_POST_MY_CARD_BLOCK to use this endpoint. - [Create a new Fire debit card](https://docs.fire.com/reference/createnewcard.md): This endpoint allows you to create a debit card to be linked to your Fire account. You can create multiple debit cards which can be linked to your Fire accounts. You will need to enable PERM_BUSINESS_POST_CARDS to use this endpoint. - [List debit cards](https://docs.fire.com/reference/getlistofcards.md): This endpoint returns a list of cards related to your Fire account. You will need to enable PERM_BUSINESS_GET_CARDS to use this endpoint. - [Get a list of debit card transactions](https://docs.fire.com/reference/getlistofcardtransactions.md): This endpoint returns a list of cards transactions related to your Fire card. You will need to enable PERM_BUSINESS_GET_MY_CARD_TRANSACTIONS to use this endpoint. - [Unblock a Fire debit card](https://docs.fire.com/reference/unblockcard.md): This endpoint updates status of an existing card to unblock which means that transactions can be carried out with that card. You will need to enable PERM_BUSINESS_POST_MY_CARD_UNBLOCK to use this endpoint. - [Activate a direct debit mandate](https://docs.fire.com/reference/activatemandate.md): This endpoint can only be used to activate a direct debit mandate when it is in the status REJECT_REQUESTED (even if the account has direct debits disabled). This action will also enable the account for direct debits if it was previously set to be disabled. You will need to enable PERM_BUSINESS_POST_MANDATE_ACTIVATE to use this endpoint. - [Cancel a direct debit mandate](https://docs.fire.com/reference/cancelmandatebyuuid.md): This endpoint allows you to cancel a direct debit mandate. You will need to enable PERM_BUSINESS_POST_MANDATE_CANCEL to use this endpoint. - [Get the details of a direct debit](https://docs.fire.com/reference/getdirectdebitbyuuid.md): This endpoint will retrieve all details of a single direct debit collection/payment, whether successful or not. You will need to enable PERM_BUSINESS_GET_DIRECT_DEBIT to use this endpoint. - [List all direct debit mandates](https://docs.fire.com/reference/getdirectdebitmandates.md): This endpoint will list all mandates on your Fire account. You will need to enable PERM_BUSINESS_GET_MANDATES to use this endpoint. - [List all direct debits](https://docs.fire.com/reference/getdirectdebitsformandateuuid.md): This endpoint will retrieve all direct debit payments associated with a direct debit mandate. You will need to enable PERM_BUSINESS_GET_DIRECT_DEBITS to use this endpoint. - [Get the details of a direct debit mandate](https://docs.fire.com/reference/getmandate.md): This endpoint will allow you to retrieve all details for a direct debit mandate. You will need to enable PERM_BUSINESS_GET_MANDATE to use this endpoint. - [Reject a direct debit](https://docs.fire.com/reference/rejectdirectdebit.md): This endpoint allows you to reject a direct debit payment where the status is still set to RECEIVED. You will need to enable PERM_BUSINESS_POST_DIRECT_DEBIT_REJECT to use this endpoint. - [Update direct debit mandate alias](https://docs.fire.com/reference/updatemandatealias.md): This endpoint allows you to update Direct Debit Mandate Alias. You will need to enable PERM_BUSINESS_PUT_MANDATE to use this endpoint. - [Get FX rates](https://docs.fire.com/reference/getfxrates.md): This endpoint returns the exchange rate between two currencies. You will need to enable PERM_BUSINESS_GET_FX_RATE to use this endpoint. - [Get list of ASPSPs / Banks](https://docs.fire.com/reference/getlistofaspsps.md): This endpoint will return all ASPSPs (Account Servicing Payment Service Provider) / banks available to you for open banking payments. The list can be filtered by currency. You will need to enable PERM_BUSINESS_GET_ASPSPS to use this endpoint.***This endpoint is only required if you intend to host the “Select ASPSP / bank” page yourself.*** - [Get payment details](https://docs.fire.com/reference/getpaymentdetailsv2.md): This endpoint will return the details of a specific open banking payment. You will need to enable PERM_BUSINESS_GET_PAYMENT to use this endpoint. As your customer goes through the payment submission journey, the payment status will change. The endpoint will return one of the following statuses: * `AWAITING_AUTHORISATION` - This is the initial status of all payments, indicating that the user has consented to be directed to their ASPSP/Bank's application. Payments remaining at this status may be considered abandoned. * `AWAITING_MULTI_AUTHORISATION` - Some business accounts require dual authorisation for payments. * `NOT_AUTHORISED` - This is a final status, and indicates that the payment initiation was cancelled by the customer, rejected by the ASPSP/Bank, an error response returned by the ASPSP/Bank, eg. low balance in the customers account. * `PENDING` - The customer has authorised the payment in their app, but their ASPSP/bank may want to carry out an internal check before funding the transaction. * `AUTHORISED` - The payment is successfully initiated, having been authorised by your customer and their ASPSP/Bank. Once the payment is successfully initiated, ie. `AUTHORISED`, the ASPSP/Bank should settle the funds, which are then applied to your Fire account. * `FUNDS_CONFIRMED` - This status is currently available for GBP payments only. The payment has been received by Fire and will be applied to your account in the next file run. * `SETTLED` - This is a final status, indicating that funds have been applied to your Fire GBP or EUR account. - [Get payment request details](https://docs.fire.com/reference/getpaymentrequestdetails.md): This endpoint will retrieve the details of an Open Banking Payment request. You will need to enable PERM_BUSINESS_GET_PAYMENT_REQUEST to use this endpoint. - [Get list of all payment attempts related to a payment request](https://docs.fire.com/reference/getpaymentrequestpaymentsv2.md): This endpoint will retrieve the list of payments attempted against an Open Banking Payment request. You will need to enable PERM_BUSINESS_GET_PAYMENT_REQUEST_PAYMENTS to use this endpoint. - [Get a report from a payment request](https://docs.fire.com/reference/getpaymentrequestreportv2.md): This endpoint will retrieve a report for an Open Banking Payment request. You will need to enable PERM_BUSINESS_GET_PAYMENT_REQUEST_REPORTS to use this endpoint. - [Get a list of payment request transactions](https://docs.fire.com/reference/getpaymentrequestssentv2.md): This endpoint will retrieve the list of open banking payment requests made on your account. You will need to enable PERM_BUSINESS_GET_PAYMENT_REQUEST_TRANSACTIONS to use this endpoint. - [List details of a public payment request](https://docs.fire.com/reference/getpublicpaymentrequest.md): This endpoint returns an object of payment request information. You will need to enable PERM_BUSINESS_GET_PUBLIC_PAYMENT_REQUEST to use this endpoint. - [Create a payment request](https://docs.fire.com/reference/newpaymentrequest.md): This endpoint creates a new Open Banking Payment request. A code is returned that can be shared to your customers as a URL by any channel you wish. See our [Guide to Fire Open Payments](/docs/fire-open-payments) for more details. You will need to enable PERM_BUSINESS_POST_PAYMENT_REQUEST to use this endpoint. - [Update the status of a payment request](https://docs.fire.com/reference/updatepaymentrequest.md): This endpoint will update the status of a payment request. The payment request should be active or removed. You will need to enable PERM_BUSINESS_PUT_PAYMENT_REQUEST_STATUS to use this endpoint. - [Get details of a payee](https://docs.fire.com/reference/getpayeedetails.md): This endpoint will retrieve the details of a specific payee. You will need to enable PERM_BUSINESS_GET_FUNDING_SOURCE to use this endpoint. - [List payees](https://docs.fire.com/reference/getpayees.md): This endpoint will return all payees on your account. You will need to enable PERM_BUSINESS_GET_FUNDING_SOURCES to use this endpoint. - [List transaction for a payee account](https://docs.fire.com/reference/getpayeetransactions.md): This endpoint retrieves the list of transactions and transaction information associated with a payee. You will need to enable PERM_BUSINESS_GET_FUNDING_SOURCE_TRANSACTIONS to use this endpoint. - [List all limits](https://docs.fire.com/reference/getlimits.md): This endpoint returns an array of limit information. You will need to enable PERM_BUSINESS_GET_LIMITS to use this endpoint. - [Get service Fees and info](https://docs.fire.com/reference/getservicefees.md): This endpoint returns an array of the services and fees associated with them. You will need to enable PERM_BUSINESS_GET_SERVICES to use this endpoint. - [Get the details of a user](https://docs.fire.com/reference/getuser.md): This endpoint will retrieve the details of a specific Fire user. You will need to enable PERM_BUSINESS_GET_USER to use this endpoint. - [Get the address of a user](https://docs.fire.com/reference/getuseraddress.md): This endpoint will return the address of a specific Fire user. You will need to enable PERM_BUSINESS_GET_USER_ADDRESS to use this endpoint. - [List all users](https://docs.fire.com/reference/getusers.md): This endpoint will retrieve the details of all Fire users on your account. You will need to enable PERM_BUSINESS_GET_USERS to use this endpoint. - [List transactions for an account](https://docs.fire.com/reference/gettransactionsbyaccountidv3.md): This endpoint will retrieve a list of transactions against an account. Initially, use the optional `limit`, `dateRangeFrom` and `dateRangeTo` query params to limit your query, then use the embedded `next` or `prev` links in the response to get newer or older pages. You will need to enable PERM_BUSINESS_GET_ACCOUNT_TRANSACTIONS to use this endpoint. - [Event Webhook](https://docs.fire.com/reference/post_webhook.md): Webhooks allow you to be notified of events as they happen on your Fire accounts. The below sample response shows how a webhook from Fire will arrive at your server. See our 'Webhooks' guide for more detailed information. ## Recipes - [Automate your payouts with batches](https://docs.fire.com/recipes/automate-your-payouts-with-batches.md) - [Create a new API application](https://docs.fire.com/recipes/create-a-new-api-application.md) - [Create a payment request](https://docs.fire.com/recipes/create-a-payment-request.md) - [Get FX rates](https://docs.fire.com/recipes/get-fx-rates.md) - [List Accounts and Balances](https://docs.fire.com/recipes/list-accounts-and-balances-1.md) - [List all payments associated with a Direct Debit](https://docs.fire.com/recipes/list-all-payments-associated-with-a-direct-debit.md) - [List all users](https://docs.fire.com/recipes/list-all-users.md) - [List Payee Transactions](https://docs.fire.com/recipes/list-payee-transactions.md) - [List the cards on your account](https://docs.fire.com/recipes/list-the-cards-on-your-account.md) - [List Transactions](https://docs.fire.com/recipes/list-transactions.md)