Invoices

List invoices and credit notes 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/invoices Endpoint (sandbox): GET https://valora-testing.laravel.cloud/api/sandbox/v1/c/invoices

Authentication

Connection test

GET https://valora.spotahome.com/api/v1/c/invoices?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",
    "search": "string, optional (invoice holder, document type or original document)",
    "issue_date_from": "date (YYYY-MM-DD), optional",
    "issue_date_to": "date (YYYY-MM-DD), optional",
    "amount_from": "decimal, optional (e.g., 100.50)",
    "amount_to": "decimal, optional (e.g., 500.00)",
    "doc_type": "string, optional (exact document type)",
    "doc_number": "string, optional (exact document number)",
    "booking_id": "string, optional (exact booking reference)",
    "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": "Invoices retrieved successfully.",
  "pagination": {
    "total": 20,
    "per_page": 100,
    "current_page": 1,
    "last_page": 1,
    "from": 1,
    "to": 20
  },
  "data": [
    {
      "booking_id": "BK123456",
      "document_id": "INV-2025-001",
      "doc_type": "Invoice",
      "invoice_to": "John Smith",
      "issue_date": "2025-10-01",
      "amount_net": 100000,
      "amount_gross": 121000,
      "currency": "EUR"
    }
  ]
}

Invoice object

No results response

Status: 404 Not Found

Example response

{
  "message": "No invoices 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 no invoices match the filters.
• data is always an array.
• The 404 response still carries pagination metadata for consistent client handling.

Errors

{
  "message": "No invoices 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 issue_date descending (most recent first).
• doc_number is the filter parameter name; the response field is document_id.