Open

Open API Documentation

Documentation for Valora's public, unauthenticated REST endpoints. These routes live under the /api/v1/open/... path prefix and are intended for use cases where a bearer token isn't practical — third-party widgets, embedded forms, public lookup tools, and lightweight integrations.

API hosts (use these with the paths below):

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

Shared conventions

Convention Details
Auth type None. Routes under /api/v1/open/... are public — no bearer token, no API key.
Headers Accept: application/json is required. Send Content-Type: application/json when posting a JSON body.
Token class Not applicable.
Rate limit Guest bucket: 60 requests per minute per IP.
Open API (production) https://valora.spotahome.com/api/v1/open
Open API (sandbox) https://valora-testing.laravel.cloud/api/sandbox/v1/open
CORS Open routes can be called from browsers; non-open routes generally cannot.
Caching Some endpoints cache upstream lookups (e.g. VIES) to keep response times low and reduce load on third-party services — see each endpoint page for TTLs.

Each open endpoint page links back here for shared conventions, base URLs, and rate-limit details.

When to use an open endpoint

Use these only for data that is genuinely public or where the cost of abuse is bounded by the guest rate limit. If the call returns customer-specific or employee-specific data, you want an authenticated endpoint instead — the open prefix is not a way to skip authentication.

Typical use cases:

  • VAT-number validation in a public checkout or signup form.
  • Lookups that mirror data already exposed by an upstream public service.
  • Health/status probes used by uptime monitors.

Endpoints

Resource Method Production URL Description
VAT Validation — Status GET https://valora.spotahome.com/api/v1/open/vat-vies/status Validate a VAT number against the European Commission VIES service.
VAT Validation — Calculate POST https://valora.spotahome.com/api/v1/open/vat-vies/calculate Validate a VAT number (optional) and calculate VAT amounts based on the input.