1. Virtual IBANs
Payswix | Agents API
  • Finance account
    • Getting started
    • Validation rules
    • Virtual IBANs
      • NACE codes
      • Create vIBAN for person or company
        POST
      • Get a list of vIBANs
        GET
    • Transactions
      • Create a SEPA transfer
      • Get transfer fee
      • Get all existing recipients
      • Get transaction information
      • Get a filtered list of transactions
    • Companies
      • Get specific company details
    • Accounts
      • Create a new account
      • Get all user accounts
      • Get user account information by account number
    • Other
      • Check if the server is alive
    • Webhooks
      • Transaction webhook
    • Schemas
      • Company vIBAN
      • Person vIBAN
      • Transaction
  • Standard account
    • Transactions
      • Create a SEPA transfer
      • Create a SWIFT transfer
    • Schemas
      • Transaction
  1. Virtual IBANs

Get a list of vIBANs

GET
/agents/v1/companies/{clientId}/ibans

Request

Authorization
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
or
Path Params

Responses

🟢200OK
application/json
OK
Bodyapplication/json

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://demo-api.payswix.com/agents/v1/companies/{{clientId}}/ibans' \
--header 'X-API-KEY: <api-key>'
Response Response Example
200 - Success
{
    "is_success": true,
    "data": [
        {
            "type": "company",
            "company_name": "UAB Baltic Trading",
            "website": [
                "https://www.baltictrading.example.com"
            ],
            "risk_level": "low",
            "system_id": "",
            "address_street": "Gedimino pr. 12-5",
            "address_city": "Vilnius",
            "address_country": "LTU",
            "payments_to_country": [],
            "payments_from_country": [],
            "main_business_activity": "K_62.00.00",
            "type_of_industry": "K_62.10.00 Computer programming activities",
            "expected_monthly_turnover": "0 - 10 000",
            "ubos": [
                {
                    "firstname": "John",
                    "lastname": "Smith",
                    "date_of_birth": "1990-05-15",
                    "ownership_percentage": "100",
                    "address_street": "Gedimino pr. 1-10",
                    "address_city": "Vilniaus",
                    "address_country": "LTU"
                }
            ],
            "directors": [
                {
                    "firstname": "John",
                    "lastname": "Smith",
                    "date_of_birth": "1990-05-15",
                    "ownership_percentage": null,
                    "address_street": "Gedimino pr. 1-10",
                    "address_city": "Vilniaus",
                    "address_country": "LTU"
                }
            ],
            "iban": "LT743880009208239802",
            "status": "activated"
        },
        {
            "type": "company",
            "risk_level": "medium",
            "system_id": "COMP-2026-0001",
            "address_street": "Gedimino pr 1t",
            "address_city": "Vilnius",
            "address_country": "LTU",
            "payments_to_country": [
                "AFG",
                "UKR",
                "BHR"
            ],
            "payments_from_country": [
                "AFG",
                "AFG",
                "CYP"
            ],
            "expected_monthly_turnover": "0 - 10 000",
            "odd_due_date": "2026-10-11",
            "expected_money_flow": "0 - 10 000",
            "company_name": "UAB Example Logistics",
            "main_business_activity": "H_49.00.00",
            "type_of_industry": "H_49.39.00 Other passenger land transport n.e.c.",
            "website": "https://example-logistics.com",
            "company_description": "Freight and logistics services across EU",
            "ubos": [
                {
                    "firstname": "Jane",
                    "lastname": "Smith",
                    "date_of_birth": "1980-01-01",
                    "ownership_percentage": 25,
                    "address_street": "456 Elm St",
                    "address_city": "Othertown",
                    "address_country": "USA"
                }
            ],
            "directors": [
                {
                    "firstname": "Alice",
                    "lastname": "Johnson",
                    "date_of_birth": "1975-02-02",
                    "address_street": "789 Oak St",
                    "address_city": "Sometown",
                    "address_country": "USA"
                }
            ],
            "iban": "LT173880005087983371",
            "status": "activated"
        }
    ],
    "message": null
}
Previous
Create vIBAN for person or company
Next
Create a SEPA transfer
Built with