vrtx Docs
Core APIs
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
SDK APIs
  • Coming Soon!
Core APIs
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
SDK APIs
  • Coming Soon!
  1. Databases
  • Card Transactions
    • Perform a simulated card transaction
      POST
    • Perform a balance inquiry
      POST
  • Notifications
    • Fetch the latest OTP for a mobile number
      POST
    • Fetch the latest notification message for a mobile number
      POST
  • Nafath
    • Trigger Nafath completion webhook
      POST
    • Preview Nafath completion webhook payload
      POST
  • Databases
    • Purge and seed all test databases
      POST
    • Execute a specific migration file by path
      POST
  • Topup
    • Run the payouts account topup job once
      POST
  • PTY Proxy
    • Proxy PTY API calls
      POST
  • Ledger
    • Perform a ledger transaction
      POST
    • Top up an account in the ledger
      POST
    • Get account balance
      GET
Core APIs
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
SDK APIs
  • Coming Soon!
Core APIs
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
SDK APIs
  • Coming Soon!
  1. Databases

Execute a specific migration file by path

POST
https://api.staging.vrtx.sa/testhelpers/databases/migrations/execute
Last modified:2025-12-22 07:00:02

Executes a single migration file from the seed directory. Path format: postgres//file.sql or mongo//file.json. Used by e2e tests to apply specific migrations before test execution.

Request

Body Params application/jsonRequired

Example
{
    "path": "postgres/onboarding/001-seed-test-data.sql"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.staging.vrtx.sa/testhelpers/databases/migrations/execute' \
--header 'Content-Type: application/json' \
--data-raw '{
    "path": "postgres/onboarding/001-seed-test-data.sql"
}'

Responses

🟢200OK
application/json
Migration executed (check success field for result)
Body

Example
{
    "success": true,
    "engine": "POSTGRES",
    "database": "string",
    "path": "string",
    "statements_applied": 0,
    "documents_inserted": 0,
    "error": "string"
}
🟠400Bad Request
Modified at 2025-12-22 07:00:02
Previous
Purge and seed all test databases
Next
Run the payouts account topup job once
Built with