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

Create vIBAN for person or company

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

Request

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

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
OK
Bodyapplication/json

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff 'https://demo-api.payswix.com/agents/v1/companies/{{clientId}}/ibans' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "type": "company",
  "company_name": "UAB Example Logistics",
  "company_description": "Freight and logistics services across EU",
  "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"
  ],
  "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",
  "expected_monthly_turnover": "0 - 10 000",
  "expected_money_flow": "0 - 10 000",
  "odd_due_date": "2026-10-11",
  "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"
    }
  ]
}'
Response Response Example
200 - Success Company
{
    "is_success": true,
    "data": {
        "account_id": 686,
        "iban": null,
        "type": "company",
        "is_primary": 0,
        "name": "UAB Example Logistics",
        "data": {
            "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"
                }
            ]
        },
        "company_description": null,
        "created_at": "2026-04-07T10:27:02.000000Z",
        "updated_at": "2026-04-07T10:27:02.000000Z",
        "status": "pending",
        "fees_charged": null,
        "correspondent_account_id": "59208239802",
        "correspondent_name": "UAB Baltic Trading",
        "activated_at": null,
        "deactivated_at": null,
        "status_changes": null,
        "closure_code": null,
        "suspend_code": null,
        "activation_email_was_sent": 0,
        "restriction_type": null,
        "closure_reason": null,
        "suspension_reason": null
    },
    "message": null
}
Previous
NACE codes
Next
Get a list of vIBANs
Built with