Scheduled Transactions

List upcoming (scheduled) payments for the authenticated customer account.

Shared conventions and base URLs live in Customer API Documentation.

API hosts: Production https://valora.spotahome.com/ (sandbox compatible); Staging / testing https://valora-testing.laravel.cloud/ (sandbox compatible).

Endpoint (production): GET https://valora.spotahome.com/api/v1/c/transactions/scheduled Endpoint (sandbox): GET https://valora-testing.laravel.cloud/api/sandbox/v1/c/transactions/scheduled

Authentication

Connection test

GET https://valora.spotahome.com/api/v1/c/transactions/scheduled?test=connection
Authorization: Bearer {token}
Accept: application/json

Response: 200 OK

{
  "message": "You are connected!",
  "accepted_params": {
    "test": "Set to \"connection\" to test API connection",
    "booking_id": "string, optional (exact booking reference)",
    "status": "string, optional (upcoming|delayed|blocked|missing_iban|missing_details|has_debt|blocked_missing_details|blocked_missing_iban|blocked_account_debtor)",
    "currency": "string, optional (e.g., EUR, USD)",
    "due_date_from": "date (YYYY-MM-DD), optional",
    "due_date_to": "date (YYYY-MM-DD), optional",
    "amount_from": "decimal, optional (e.g., 100.50)",
    "amount_to": "decimal, optional (e.g., 500.00)",
    "search": "string, optional (booking reference, account name or IBAN)",
    "page": "integer, optional (page number, default = 1)",
    "per_page": "integer, optional (items per page, default = 100, max = 500)"
  }
}

Query parameters

Success response

Status: 200 OK

{
  "message": "Scheduled transactions retrieved successfully.",
  "pagination": {
    "total": 5,
    "per_page": 100,
    "current_page": 1,
    "last_page": 1,
    "from": 1,
    "to": 5
  },
  "data": [
    {
      "booking_id": "BK123456",
      "amount": 120000,
      "currency": "EUR",
      "iban": "ES1234567890123456789012",
      "due_date": "2025-02-15",
      "due_date_erp": "2025-02-15",
      "status": "upcoming",
      "account_name": "John Doe",
      "b2b": false,
      "transfer_blocked": false,
      "available_bank_account": true,
      "same_account": false,
      "days_delayed": 0,
      "has_debt": false,
      "updated_at": "2025-01-15T10:30:00.000000Z"
    }
  ]
}

Scheduled transaction object

No results response

Status: 404 Not Found

Example response

{
  "message": "No scheduled transactions found for the given filters.",
  "pagination": {
    "total": 0,
    "per_page": 100,
    "current_page": 1,
    "last_page": 1,
    "from": null,
    "to": null
  },
  "data": []
}

Response notes

• pagination.total is 0 when the filters match no scheduled payments.
• data is always an array.
• Consumers can treat 404 as "no matching rows" without a schema change.

Payment statuses

Errors

{
  "message": "No scheduled transactions found for the given filters.",
  "data": []
}

Notes

• amount_from and amount_to accept major units; all amounts in the response are in minor units (cents).
• Results are ordered by due_date ascending (soonest first).
• Sensitive employee fields (account_manager, comment, tenant_email, missing_details, etc.) are not included in the response.