REST API
Valuation API
Integrate the ARST valuator directly into your workflow. API-key authentication, JSON responses, no proprietary SDK.
Authentication
Valuation endpoints require an API key in the Authorization header.
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Format
Bearer token (sk_live_…)
Credit
1 per vehicle valued (/valuation, /comparable, /batch) · /pdf and public endpoints cost no credits
Rate limit (burst)
300 req/min per API key
Alternative
arst_token cookie (web session)
Daily quota by plan
On top of the 300 req/min burst limit, every API key has a daily call cap that resets at 00:00 UTC. Exceeding it returns 429 with a Retry-After header.
Generate your API key in My account → API Keys. The plaintext value is shown only when the key is created.
Endpoints
Error codes
| HTTP | Cause |
|---|---|
401 | Missing, invalid, or revoked API key |
402 | No credits: top up at /pricing |
403 | Your plan does not include this endpoint (e.g. /comparable or /batch on the Free plan) |
422 | Invalid parameters (country, fuel…) |
429 | Daily quota or rate limit exceeded — honor the Retry-After header |
503 | Model not available for that country |
Quick example
curl -X POST 'https://rv.arstdata.com/api/v1/valuation' \
-H 'Authorization: Bearer sk_live_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"country": "ES",
"brand": "BMW",
"model": "320D",
"year": 2020,
"km": 65000,
"fuel": "diesel",
"current_price": 25000
}'Usage limits
View endpoint reference
Routes, parameters and example responses on this page
Generate your API key
My account → API Keys → New key