1. Transactions
Payswix | Agents API
  • Finance account
    • Getting started
    • Validation rules
    • Virtual IBANs
      • NACE codes
      • Create vIBAN for person or company
      • Get a list of vIBANs
    • Transactions
      • Create a SEPA transfer
        POST
      • Get transfer fee
        POST
      • Get all existing recipients
        GET
      • Get transaction information
        GET
      • Get a filtered list of transactions
        POST
    • 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. Transactions

Get a filtered list of transactions

POST
/agents/v1/transactions/{clientId}/get-filtered

Request

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

Body Params application/json

Examples

Responses

🟢200OK
application/json
OK
Bodyapplication/json

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://demo-api.payswix.com/agents/v1/transactions//get-filtered' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "createdFrom": "2026-01-01",
    "createdTo": "2026-01-31",
    "updatedFrom": "2026-01-01",
    "updatedTo": "2026-01-31",
    "finalizedFrom": "2026-01-01",
    "finalizedTo": "2026-01-31",
    "account": "",
    "statuses": [
        "1",
        "2",
        "3",
        "4"
    ],
    "types": [
        "1",
        "2",
        "4",
        "6",
        "7"
    ],
    "currency": "EUR",
    "partnerId": "",
    "iban": "",
    "debit": true,
    "credit": false,
    "page": "1",
    "limit": "100",
    "pagination": true
}'
Response Response Example
200 - Success
{
    "is_success": true,
    "data": [
        {
            "paymentMethod": null,
            "currencyType": 1,
            "referenceTransaction": null,
            "referencedBy": [
                "dc214414-3ef4-4596-9c48-037af149a485"
            ],
            "parameters": [],
            "clientDeclineReason": null,
            "fromAccountIban": "LT173880005087983371",
            "beneficiaryAccountIban": "LT613880005539913436",
            "providerType": "internal",
            "isSelfTransfer": false,
            "isDynamicTransfer": false,
            "isScheduled": false,
            "transferMethod": null,
            "counterpartyId": "72e5fe0c-1688-484d-b7d5-6313dde60bf4",
            "id": "fcca0766-14a3-49ec-9433-97fe789e2575",
            "account": {
                "discriminator": 0,
                "clientType": 1,
                "clientName": "UAB Baltic Trading",
                "iban": "LT743880009208239802",
                "beneficiaryType": 2,
                "metadata": {
                    "status_changed_by": {
                        "actor": "Jonas Jonaitis"
                    }
                },
                "providerCurrency": "",
                "external": false,
                "dynamicPayment": false,
                "providerRequisites": {
                    "": {
                        "bankCode": null,
                        "bankAccountNumber": "LT173880005087983371"
                    }
                },
                "number": "59208239802",
                "type": 1,
                "cards": [],
                "status": 1,
                "primary": true,
                "name": "Primary account",
                "provider": {
                    "cardIssuer": false,
                    "name": "litas_sepa",
                    "currency": null,
                    "currencies": [],
                    "externalId": null
                },
                "providerNumber": "LT743880009208239802",
                "createdAt": "2026-04-07T10:21:22+00:00",
                "dormant": false,
                "default_fee_activation_date": 0,
                "balances": [],
                "totalEquivalentBalance": null,
                "prohibitedOperations": []
            },
            "status": 2,
            "state": 8,
            "type": 4,
            "provider": "internal",
            "providerId": null,
            "providerEndToEndId": null,
            "remitterName": "UAB Example Logistics",
            "remitterAccountNumber": "59208239802",
            "beneficiaryType": 1,
            "remitterType": 2,
            "beneficiaryName": "Person Autotest Monday",
            "beneficiaryAccountNumber": "75539913436",
            "amount": -10.3,
            "currency": "EUR",
            "description": "For payment of services",
            "bankDetails": {
                "purposeLabel": null,
                "categoryPurposeLabel": null,
                "beneficiaryName": "Person Autotest Monday",
                "beneficiaryCode": null,
                "beneficiaryTaxCode": null,
                "beneficiaryAdditionalCode": null,
                "beneficiaryAddress": "Pavasario g 48",
                "beneficiaryCity": "Vilnius",
                "beneficiaryPostalCode": "10321",
                "beneficiaryState": null,
                "beneficiaryCountryCode": "LT",
                "remitterAddress": "Gedimino pr. 12-5",
                "remitterCity": "Vilnius",
                "remitterPostalCode": "01103",
                "remitterState": null,
                "remitterCountryCode": "LT",
                "bankName": "PAYSWIX, UAB",
                "bankCountryCode": "LT",
                "bankAddress": "LVIVO G. 25-104",
                "bic": "GLUALT22XXX",
                "bankAccountNumber": "LT613880005539913436",
                "correspondentBankName": "PAYSWIX, UAB",
                "correspondentBankAccountNumber": "LT613880005539913436",
                "correspondentBankCode": null,
                "sortCode": null,
                "bankCode": null,
                "ultimateDebtorName": null,
                "ultimateBeneficiaryName": null,
                "bankAccountNumberTag": null,
                "purpose": null,
                "categoryPurpose": null,
                "paymentPurpose": null,
                "lei": null
            },
            "createdAt": "2026-04-07T11:10:26+00:00",
            "executionTime": null,
            "processingTime": null,
            "updatedAt": "2026-04-07T11:10:36+00:00",
            "chargeType": null,
            "urgency": null,
            "partnerId": null,
            "settlementDate": "2026-04-07T00:00:00+00:00",
            "directDebitMandateId": null,
            "directDebitPaymentId": null,
            "initiatedAt": "2026-04-07T11:10:27+00:00",
            "finalizedAt": "2026-04-07T11:10:36+00:00"
        },
        {
            "paymentMethod": null,
            "currencyType": 1,
            "referenceTransaction": "7688032c-3e30-4a6c-9b66-71c9ba492157",
            "referencedBy": [],
            "parameters": [],
            "clientDeclineReason": null,
            "fromAccountIban": "LT613880005539913436",
            "beneficiaryAccountIban": "LT743880009208239802",
            "providerType": "internal",
            "isSelfTransfer": false,
            "isDynamicTransfer": false,
            "isScheduled": false,
            "transferMethod": null,
            "counterpartyId": "32ee74e0-c576-4de0-b8ea-b24291c83f23",
            "id": "0bdde3e8-e329-4a56-9669-7d18616e5f39",
            "account": {
                "discriminator": 0,
                "clientType": 1,
                "clientName": "UAB Baltic Trading",
                "iban": "LT743880009208239802",
                "beneficiaryType": 2,
                "metadata": {
                    "status_changed_by": {
                        "actor": "Jonas Jonaitis"
                    }
                },
                "providerCurrency": "",
                "external": false,
                "dynamicPayment": false,
                "providerRequisites": {
                    "": {
                        "bankCode": null,
                        "bankAccountNumber": "LT173880005087983371"
                    }
                },
                "number": "59208239802",
                "type": 1,
                "cards": [],
                "status": 1,
                "primary": true,
                "name": "Primary account",
                "provider": {
                    "cardIssuer": false,
                    "name": "litas_sepa",
                    "currency": null,
                    "currencies": [],
                    "externalId": null
                },
                "providerNumber": "LT743880009208239802",
                "createdAt": "2026-04-07T10:21:22+00:00",
                "dormant": false,
                "default_fee_activation_date": 0,
                "balances": [],
                "totalEquivalentBalance": null,
                "prohibitedOperations": []
            },
            "status": 2,
            "state": 8,
            "type": 4,
            "provider": "internal",
            "providerId": null,
            "providerEndToEndId": null,
            "remitterName": "Person Autotest Monday",
            "remitterAccountNumber": "75539913436",
            "beneficiaryType": 2,
            "remitterType": 1,
            "beneficiaryName": "UAB Baltic Trading",
            "beneficiaryAccountNumber": "59208239802",
            "amount": 100,
            "currency": "EUR",
            "description": "for better start",
            "bankDetails": {
                "purposeLabel": null,
                "categoryPurposeLabel": null,
                "beneficiaryName": "Person Autotest Monday",
                "beneficiaryCode": null,
                "beneficiaryTaxCode": "",
                "beneficiaryAdditionalCode": null,
                "beneficiaryAddress": "Gedimino pr. 12-5",
                "beneficiaryCity": "Vilnius",
                "beneficiaryPostalCode": "01103",
                "beneficiaryState": null,
                "beneficiaryCountryCode": "LT",
                "remitterAddress": "kaimo g 48756",
                "remitterCity": "Vilnius",
                "remitterPostalCode": "10321",
                "remitterState": null,
                "remitterCountryCode": "LT",
                "bankName": "PAYSWIX, UAB",
                "bankCountryCode": "LT",
                "bankAddress": "LVIVO G. 25-104",
                "bic": "GLUALT22XXX",
                "bankAccountNumber": "LT613880005539913436",
                "correspondentBankName": "PAYSWIX, UAB",
                "correspondentBankAccountNumber": "LT743880009208239802",
                "correspondentBankCode": null,
                "sortCode": null,
                "bankCode": null,
                "ultimateDebtorName": null,
                "ultimateBeneficiaryName": null,
                "bankAccountNumberTag": null,
                "purpose": null,
                "categoryPurpose": null,
                "paymentPurpose": null,
                "lei": null
            },
            "createdAt": "2026-04-07T11:00:40+00:00",
            "executionTime": null,
            "processingTime": null,
            "updatedAt": "2026-04-07T11:00:49+00:00",
            "chargeType": null,
            "urgency": null,
            "partnerId": null,
            "settlementDate": "2026-04-07T00:00:00+00:00",
            "directDebitMandateId": null,
            "directDebitPaymentId": null,
            "initiatedAt": "2026-04-07T11:00:41+00:00",
            "finalizedAt": "2026-04-07T11:00:49+00:00"
        },
        {
            "paymentMethod": null,
            "currencyType": 1,
            "referenceTransaction": null,
            "referencedBy": [],
            "parameters": [],
            "clientDeclineReason": null,
            "fromAccountIban": "LT743880009208239802",
            "beneficiaryAccountIban": null,
            "providerType": "sepa",
            "isSelfTransfer": false,
            "isDynamicTransfer": false,
            "isScheduled": false,
            "transferMethod": null,
            "counterpartyId": null,
            "id": "44803932-95c0-45be-b31f-f43940316392",
            "account": {
                "discriminator": 0,
                "clientType": 1,
                "clientName": "UAB Baltic Trading",
                "iban": "LT743880009208239802",
                "beneficiaryType": 2,
                "metadata": {
                    "status_changed_by": {
                        "actor": "Jonas Jonaitis"
                    }
                },
                "providerCurrency": "",
                "external": false,
                "dynamicPayment": false,
                "providerRequisites": {
                    "": {
                        "bankCode": null,
                        "bankAccountNumber": "LT173880005087983371"
                    }
                },
                "number": "59208239802",
                "type": 1,
                "cards": [],
                "status": 1,
                "primary": true,
                "name": "Primary account",
                "provider": {
                    "cardIssuer": false,
                    "name": "litas_sepa",
                    "currency": null,
                    "currencies": [],
                    "externalId": null
                },
                "providerNumber": "LT743880009208239802",
                "createdAt": "2026-04-07T10:21:22+00:00",
                "dormant": false,
                "default_fee_activation_date": 0,
                "balances": [],
                "totalEquivalentBalance": null,
                "prohibitedOperations": []
            },
            "status": 1,
            "state": 19,
            "type": 4,
            "provider": "sepa_manual",
            "providerId": null,
            "providerEndToEndId": null,
            "remitterName": null,
            "remitterAccountNumber": null,
            "beneficiaryType": 2,
            "remitterType": 0,
            "beneficiaryName": "UAB Baltic Trading",
            "beneficiaryAccountNumber": "59208239802",
            "amount": 100,
            "currency": "EUR",
            "description": "For testing",
            "bankDetails": null,
            "createdAt": "2026-04-07T10:46:21+00:00",
            "executionTime": null,
            "processingTime": null,
            "updatedAt": "2026-04-07T10:46:22+00:00",
            "chargeType": null,
            "urgency": null,
            "partnerId": null,
            "settlementDate": "2026-04-07T00:00:00+00:00",
            "directDebitMandateId": null,
            "directDebitPaymentId": null,
            "initiatedAt": "2026-04-07T10:46:22+00:00",
            "finalizedAt": null
        }
    ],
    "message": null
}
Previous
Get transaction information
Next
Get specific company details
Built with