Home
Providers
iBanFirst
iBanFirst
iBanFirst is a Brussels-headquartered cross-border payment and foreign-exchange platform for businesses, licensed as a payment institution by the National Bank of Belgium (company number 0849.872.824) and operating across Belgium, France, the Netherlands, Germany, Spain, Romania, Bulgaria, Italy, Hungary and the United Kingdom. It provides multi-currency "augmented currency accounts" with dedicated IBANs, SWIFT and SEPA payments with payment tracking, spot FX in 30+ currencies, and fixed forward payment contracts for currency-risk hedging. Its developer surface is a public REST API (iBanFirst API 1.6.0, 38 operations over accounts, financial movements, beneficiaries, payments, spot trades, fixed forwards, documents and webhook subscriptions), X-WSSE token authentication, HMAC-SHA256-signed webhooks for payment and trade events, a separate eIDAS/QWAC-gated PSD2 XS2A API for AIS and PIS third-party providers, and a hosted first-party remote MCP server that gives agents read access to treasury data.
iBanFirst publishes 11 API contracts indexed on the APIs.io network, including Accounts API, Beneficiaries API, Documents API, and 8 more. Tagged areas include Company, Fintech Insurtech, Cross-Border Payments, Foreign Exchange, and B2B Payments.
The iBanFirst catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 1 Spectral governance ruleset.
iBanFirst’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, pricing, signup flow, and 39 more developer resources.
2 published contracts
1 MCP Servers
On this page
Kin Score
APIs 11
MCP Servers 1
Pricing Plans 1
Rate Limits 1
Event Specs 1
Vocabularies 1
Spectral Rules 1
Overlays 1
JSON Schema 30
Security Posture 3
Agentic Access 1
Resources 46
apis.yml
Business capabilities this provider's published APIs can perform, derived from its own
contracts. Browse all capabilities →
45 Operational Transparency
0 Create-or-Update Ergonomics
Composite quality — 63.8/100 · strong
Agent readiness — 55/100 · agent ready
Markets this provider is in provisional
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Market Position Depth Registered MCP server Declares compatibility
Open Banking
undeclared
-
-
-
Registered MCP server and declares compatibility are report only — not weighted .
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 11
Model Context Protocol servers that expose these APIs to AI agents.
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
AsyncAPI definitions for this provider's event-driven and streaming APIs.
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
Standalone JSON Schema definitions for this provider's data models.
Scroll for all 30
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Recommended x-agentic-access execution contracts for AI agents.
Get Started 5
Portal, sign-up, and the first successful call
Documentation 2
Reference material describing how the API behaves
Agent Surfaces 6
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 9
Pagination, idempotency, versioning, errors, and events
Scroll for all 9
Build 2
SDKs, sample code, and the tooling you integrate with
Access & Security 6
Authentication, authorization, and security posture
Operate 5
Status, limits, changes, and where to get help
Commercial 4
Pricing, plans, and the legal terms of use
Company 3
The organization behind the API
Other 4
Properties that don't map to a standard resource type
Source (apis.yml)
aid: ibanfirst
name: iBanFirst
description: iBanFirst is a Brussels-headquartered cross-border payment and foreign-exchange platform for businesses, licensed
as a payment institution by the National Bank of Belgium (company number 0849.872.824) and operating across Belgium, France,
the Netherlands, Germany, Spain, Romania, Bulgaria, Italy, Hungary and the United Kingdom. It provides multi-currency "augmented
currency accounts" with dedicated IBANs, SWIFT and SEPA payments with payment tracking, spot FX in 30+ currencies, and fixed
forward payment contracts for currency-risk hedging. Its developer surface is a public REST API (iBanFirst API 1.6.0, 38
operations over accounts, financial movements, beneficiaries, payments, spot trades, fixed forwards, documents and webhook
subscriptions), X-WSSE token authentication, HMAC-SHA256-signed webhooks for payment and trade events, a separate eIDAS/QWAC-gated
PSD2 XS2A API for AIS and PIS third-party providers, and a hosted first-party remote MCP server that gives agents read access
to treasury data.
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
label: Freemium · Self-serve signup
confidence: high
source:
- plans
- authentication
- rate-limits
- security
- sandbox
generated: '2026-09-02'
method: derived
image: https://ibanfirst.com/_next/static/media/iban-og-image.1rlnmbejef6_m.jpg
url: https://raw.githubusercontent.com/api-evangelist/ibanfirst/refs/heads/main/apis.yml
x-type: company
x-source: serena-portfolio
specificationVersion: '0.23'
created: '2026-08-17'
modified: '2026-08-17'
x-docs-platform: redocly
x-docs-platform-confidence: high
x-docs-platform-checked: 2026-10-03
tags:
- Company
- Fintech Insurtech
- Cross-Border Payments
- Foreign Exchange
- B2B Payments
- Treasury
- multi-currency-accounts
- SEPA
- PSD2
- Open Banking
- currency-risk-management
- Webhook
- MCP
- Belgium
- Europe
- SWIFT
tags_raw:
- Company
- Fintech Insurtech
- cross-border-payments
- foreign-exchange
- b2b-payments
- treasury
- multi-currency-accounts
- sepa
- psd2
- open-banking
- currency-risk-management
- webhooks
- mcp
- belgium
- europe
- SWIFT
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
- FN: APIs.json
email: info@apis.io
common:
- type: AgenticAccess
url: agentic-access/ibanfirst-agentic-access.yml
- type: Spectral
url: rules/ibanfirst-rules.yml
- type: JSONLD
url: json-ld/ibanfirst-context.jsonld
- type: Vocabulary
url: vocabulary/ibanfirst-vocabulary.yml
- type: Deprecation
url: lifecycle/ibanfirst-lifecycle.yml
- type: Hosts
url: hosts/ibanfirst-hosts.yml
- type: Vendors
url: vendors/ibanfirst-vendors.yml
- type: Newsroom
url: https://ibanfirst.com/newsroom
- type: CapabilityMap
url: capabilities/ibanfirst-capability-edges.yml
name: iBanFirst Business Capability Map
- type: Website
url: https://www.ibanfirst.com/
- type: DeveloperPortal
url: https://docs.ibanfirst.com/
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Support
url: https://support.ibanfirst.com/en/
- type: Blog
url: https://blog.ibanfirst.com/en
- type: GitHubOrganization
url: https://github.com/iBanFirst
- type: Pricing
url: https://ibanfirst.com/fees
- type: SignUp
url: https://info.ibanfirst.com/en/request-an-account
- type: Login
url: https://platform.ibanfirst.com/login?lang=en
- type: TermsOfService
url: https://ibanfirst.com/terms
- type: PrivacyPolicy
url: https://ibanfirst.com/privacy-policy
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: ChangeLog
url: https://docs.ibanfirst.com/changelog
- type: ChangeLog
url: changelog/ibanfirst-changelog.yml
- type: LLMsTxt
url: llms/ibanfirst-llms.txt
- type: LLMsTxt
url: https://www.ibanfirst.com/llms.txt
- type: WellKnown
url: well-known/ibanfirst-well-known.yml
- type: SecurityTxt
url: well-known/ibanfirst-security.txt
- type: Security
url: https://ibanfirst.com/security-policy.html
- type: VulnerabilityDisclosure
url: security/ibanfirst-vulnerability-disclosure.yml
- type: DomainSecurity
url: security/ibanfirst-domain-security.yml
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: Conformance
url: conformance/ibanfirst-conformance.yml
- type: Compliance
url: https://ibanfirst.com/psd2-api
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: Lifecycle
url: lifecycle/ibanfirst-lifecycle.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Plans
url: plans/ibanfirst-plans-pricing.yml
- type: RateLimits
url: rate-limits/ibanfirst-rate-limits.yml
- type: AgentSkill
url: skills/_index.yml
- type: MCPServer
url: mcp/ibanfirst-mcp.yml
- type: Overlay
url: overlays/ibanfirst-clientapi-overlay.yaml
apis:
- name: iBanFirst MCP Connector
description: First-party hosted remote MCP server, launched with API 1.7.0 on 2026-06-05, exposing 16 read tools over wallets,
balances, financial movements, payments, live FX rates, spot trades, fixed forwards and beneficiaries. Documented as a
Claude.ai / Claude Desktop custom connector; authentication is OAuth 2.0 with dynamic client registration (RFC 8414 +
RFC 9728 metadata served at the endpoint). tools/list is OAuth-gated. No write tools are exposed.
humanURL: https://docs.ibanfirst.com/guides/mcp-connector
baseURL: https://mcp.ibanfirst.com/mcp
tags:
- MCP
- Agent-Native
- Treasury
- Foreign Exchange
- Cross-Border Payments
tags_raw:
- mcp
- agent-native
- treasury
- foreign-exchange
- cross-border-payments
properties:
- type: MCPServer
url: mcp/ibanfirst-mcp.yml
- type: MCPServer
url: https://mcp.ibanfirst.com/mcp
- type: ToolCrosswalk
url: mcp/ibanfirst-tool-crosswalk.yml
- type: Documentation
url: https://docs.ibanfirst.com/guides/mcp-connector
- type: Authentication
url: authentication/ibanfirst-authentication.yml
aid: ibanfirst:ibanfirst-mcp-connector
- name: iBanFirst PSD2 XS2A API
description: PSD2 access-to-account API for registered third-party providers, covering account information services (AIS),
payment initiation services (PIS) and strong customer authentication. A sandbox is published for TPP development and testing.
Access requires a qualified eIDAS QWAC certificate; onboarding is by request to open-api@ibanfirst.com. The sandbox host
terminates anonymous TLS handshakes, so no machine-readable specification for this API could be retrieved without a client
certificate.
humanURL: https://ibanfirst.com/psd2-api
baseURL: https://open-api-sdbx.ibanfirst.com/Banking/API
tags:
- PSD2
- Open Banking
- Account Information
- Payment Initiation
- Regulatory
tags_raw:
- psd2
- open-banking
- account-information
- payment-initiation
- regulatory
properties:
- type: Documentation
url: https://ibanfirst.com/psd2-api
- type: Compliance
url: https://ibanfirst.com/psd2-api
- type: Support
url: mailto:open-api@ibanfirst.com
aid: ibanfirst:ibanfirst-psd2-xs2a-api
- aid: ibanfirst:ibanfirst-accounts-api
name: iBanFirst Accounts API
description: "Each of your accounts has its own specific currency and IBAN. The API allows you to get details and balances\
\ about each account in real time. \n\n **Note :** ***accounts*** are also labelled as ***wallets*** in the iBanFirst\
\ API."
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Account
tags_raw:
- Accounts
properties:
- type: OpenAPI
url: openapi/ibanfirst-accounts-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-wallet-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-holder-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-balance-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-amount-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-id-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-currency-schema.json
- aid: ibanfirst:ibanfirst-beneficiaries-api
name: iBanFirst Beneficiaries API
description: 'A beneficiary can be either your own account in another bank or a third party recipient account. Beneficiaries
can be created or deleted through the API.
**Note :** ***beneficiaries*** are also labelled as ***externalBankAccounts*** in the iBanFirst API.'
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Beneficiaries
properties:
- type: OpenAPI
url: openapi/ibanfirst-beneficiaries-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-external-bank-account-vop-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-holder-bank-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-external-bank-account-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-holder-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-process-result-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-currency-schema.json
- aid: ibanfirst:ibanfirst-documents-api
name: iBanFirst Documents API
description: "The API allows you to access your documents stored on the iBanFirst platform through a one-time access link.\n\
\n Documents must be generated on the platform before being available through the API."
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Documents
properties:
- type: OpenAPI
url: openapi/ibanfirst-documents-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-document-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-datetime-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-id-schema.json
- aid: ibanfirst:ibanfirst-financial-movements-api
name: iBanFirst Financial movements API
description: The API allows you to retrieve all financial movements from your accounts.
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Financial movements
properties:
- type: OpenAPI
url: openapi/ibanfirst-financial-movements-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-financial-movement-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-datetime-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-amount-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-id-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-date-schema.json
- aid: ibanfirst:ibanfirst-fixed-forward-payment-contract-api
name: iBanFirst Fixed forward payment contract API
description: "Book a fixed forward payment contracts instantly on iBanFirst without manual intervention.\n\n- Available\
\ currency pairs:\n - **EUR/USD**\n - **EUR/GBP**\n - **GBP/USD**\n\n - Maturities: **up to 6 months**.\n\n - Transaction\
\ limit: **1M EUR** equivalent per transaction.\n\nBefore using fixed forward, you must have:\n - Credit approval.\n -\
\ Collateral in place.\n - Accepted the Autonomous Forward disclaimer.\n\nThe `deliveryDate` must satisfy the following\
\ conditions:\n - **Minimum date**: current date + 3 business days.\n - **Maximum date**: earlier between [current date\
\ + 6 months] and maximum maturity date allowed."
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Fixed forward payment contract
properties:
- type: OpenAPI
url: openapi/ibanfirst-fixed-forward-payment-contract-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-fixed-forward-trade-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-fixed-forward-quote-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-id-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-quote-ref-schema.json
- aid: ibanfirst:ibanfirst-logs-api
name: iBanFirst Logs API
description: The Logs API from iBanFirst — 2 operation(s) for logs.
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Logs
properties:
- type: OpenAPI
url: openapi/ibanfirst-logs-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-log-schema.json
- aid: ibanfirst:ibanfirst-payments-api
name: iBanFirst Payments API
description: "Sending funds from one of your iBanFirst accounts to your own external bank account or a third-party recipient\
\ involves two steps:\n\n1. Generate the payment object with the 'Create payment' method. \nA unique id is assigned to\
\ each payment. \n\n2. Use the 'Confirm Payment' method to send the payment for processing. \nWhen you confirm a payment,\
\ make sure you have sufficient funds in your account balance. \n\n**Caution:** Payments are automatically rolled to the\
\ next closest working days if not confirmed in the scheduled date of operation. If the balance of your account is not\
\ sufficient to cover the payment amount, funds may be locked-in by iBanFirst."
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Payments
properties:
- type: OpenAPI
url: openapi/ibanfirst-payments-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-payment-vop-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-payment-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-payment-option-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-amount-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-id-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-currency-schema.json
- aid: ibanfirst:ibanfirst-spot-trades-api
name: iBanFirst Spot trades API
description: 'The API provides a deliverable FX facility and deliverable FX liquidity. You will become counterparty to iBanFirst
and can market and sell deliverable FX services to corporate and private clients as well as using such services on their
behalf.
FX trades are always made between two accounts of a unique counterparty. iBanFirst will automatically debit the source
account and credit the delivery account at the date specified in the FX trade instructions. If the delivery date has been
scheduled, the delivery is automatically processed in the morning before 00:30 am Paris time. If the delivery date is
today (TOD), the funds is available on your account by the next 20mn.
A FX trades also involves an amount, which includes both the numeric amount and the currency in order to define if this
amount is the nominal to be bought or sold, for example: ''100000.00+GBP''.'
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Spot trades
properties:
- type: OpenAPI
url: openapi/ibanfirst-spot-trades-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-trade-reconciliation-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-trade-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-quote-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-currency-pair-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-amount-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-id-schema.json
- aid: ibanfirst:ibanfirst-webhook-subscriptions-api
name: iBanFirst Webhook subscriptions API
description: "**1. WHAT IS A WEBHOOK ?**\n\n - Webhooks are events based real-time notifications providing updates on transactions\
\ and removing the need for periodic polling.\n\n - Webhook notifications are sent as HTTPS POST requests to a URL of\
\ your choice.\n\n**2. WEBHOOK SUBSCRIPTIONS**\n\n - Each webhook subscription allows you to receive notifications for\
\ one or more event types :\n\n - **Outgoing payment :**`PAYMENT_PLANIFIED` `PAYMENT_FINALIZED` `PAYMENT_WAITING_SIGNATURE`\
\ `PAYMENT_AWAITING_CONFIRMATION` `PAYMENT_CANCELED` `PAYMENT_BLOCKED` `PAYMENT_WAITING_JUSTIFICATION` `PAYMENT_INCOMING`\n\
\n - **Spot trade** : `TRADE_PLANIFIED` `TRADE_FINALIZED` `TRADE_CANCELED` `TRADE_BLOCKED`\n\n - You may have up to\
\ 10 active subscriptions at the same time.\n\n **3. IMPLEMENTATION**\n\n - **Delivery and retries**\n - Webhook notifications\
\ may not be delivered in order, your implementation should not assume sequential delivery.\n - If a notification delivery\
\ fails (HTTP status code 400 or 500), it will be retried twice, with a 60-second delay between attempts. This results\
\ in a maximum of three delivery attempts per event.\n - **Acknowledgement**\n - We recommend responding with a HTTP\
\ `204` code (No Content) to acknowledge receipt of a notification.\n - **Whitelisting**\n - To ensure webhook notifications\
\ reach your URL, you may need to whitelist the following IP (production and demo): **51.158.86.1**. \n\n**4. SECURITY**\n\
\n- Each webhook notification includes an HMAC-256 signature in the request header to let you **validate its authenticity**.\n\
\ - To verify the signature, recontruct the signed message by concatenating the exact timestamp and request raw body\
\ as received : `x-ibanfirst-timestamp.{Body}`.\n - Compute an HMAC-SHA256 hash of this string using the subscription\
\ secret key and compare the result with the `x-ibanfirst-signature` provided in the notification header.\n - You must\
\ **reject** the notification if the signatures do not match.\n - Recommended best practices :\n - Always validate\
\ the signature before processing any webhook notification.\n - Webhook notification payloads must be stored on a private\
\ server to protect sensitive data.\n\n**5. WEBHOOK NOTIFICATION CONTENT**\n\n Notifications contain the relevant object\
\ as described in each reconciliation service.\n - [Get payment details](https://docs.ibanfirst.com/api/clientapi/payments/paths/~1payments~1%7Bid%7D/get)\n\
\ - [Get trade detail](https://docs.ibanfirst.com/api/clientapi/trades/paths/~1trades~1%7Bid%7D/get)\n\n```json\n{\n \"\
event\": event_label,\n \"payload\": {\n see get payment details, get trade details\n },\n\"webhookId\": \"e35b6e8d-67ef-4973-945d-c3190a60d0aa\"\
\n}\n```"
humanURL: https://docs.ibanfirst.com/api/clientapi
baseURL: https://api.ibanfirst.com/api
tags:
- Webhook Subscriptions
tags_raw:
- Webhook subscriptions
properties:
- type: OpenAPI
url: openapi/ibanfirst-webhook-subscriptions-api-openapi.yml
- type: Documentation
url: https://docs.ibanfirst.com/
- type: APIReference
url: https://docs.ibanfirst.com/api/clientapi
- type: GettingStarted
url: https://docs.ibanfirst.com/guides/quickstart
- type: Postman
url: https://www.postman.com/productibf/ibanfirst-rest-api-workspace/collection/d24hl8d/ibanfirst-rest-api
- type: Authentication
url: authentication/ibanfirst-authentication.yml
- type: Conventions
url: conventions/ibanfirst-conventions.yml
- type: ErrorCatalog
url: errors/ibanfirst-problem-types.yml
- type: DataModel
url: data-model/ibanfirst-data-model.yml
- type: Webhooks
url: asyncapi/ibanfirst-webhooks.yml
- type: Sandbox
url: sandbox/ibanfirst-sandbox.yml
- type: Glossary
url: https://docs.ibanfirst.com/glossary
- type: JSONSchema
url: json-schema/ibanfirst-webhook-failed-notification-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-events-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-webhook-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-webhook-id-schema.json
- type: JSONSchema
url: json-schema/ibanfirst-url-schema.json
x-enrichment:
date: '2026-10-12'
status: enriched
artifacts_added: 1
pass: local-v5
x-tags-removed:
- Swift
Every provider here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for providers
9 MCP tools reach this
find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This provider
curl "https://apis.io/api/v1/providers/ibanfirst"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/ibanfirst/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/ibanfirst/evidence"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms .
A second provider on the same verified email joins the account you already have.