Valuations

Create a valuation for one vehicle in one market, and read back a recorded result. Field tables on this page are generated from the OpenAPI contract, so they always match what the API validates.

Note: Since contract 0.9.0, vehicle in a result is an AutoUncle Vehicle Schema (AVS) 0.3 vehicle document, with the catalogue identification and per-value provenance beside it in identification. vehicle in a request is a VehicleInput: that AVS document, or the vehicle's attributes. See the changelog.

#POST /v1/valuations

Resolve and value a vehicle.

One credit per successful live valuation, plus one when requested comparable listings are returned, one when a requested trade-in price is returned and one when sent photos were used. Retry an unknown network outcome with the original Idempotency-Key and identical input. A confirmed recorded success, refusal or failure outcome is replayed; use a new key to execute a fresh attempt after a confirmed refusal or failure. Optional AI resolution is deployment-configured; warnings identify unused input. Sandbox never calls AI. Concurrent valuations are limited per workspace (429 concurrency_limited) and engine-wide or per market (503 engine_busy); these rejections happen before the request is started, carry Retry-After and retry_after, consume no credit and may be retried with the same Idempotency-Key.

• Scope: valuations:write
• Cost: One credit for a successful (valued) live valuation, plus one when requested comparables are returned, one when a requested trade-in price is returned and one when sent photos were used. The similar-cars link is free. Test-key valuations, refusals and failures are free.
• Rate limit: valuations bucket, default 60 requests per minute. See limits.

#Parameters

#Request body

application/json, at most 1 MB. A ValuationRequest: country plus at least one of vehicle, description or images. Unknown fields are rejected.

Structured example:

{
  "country": "DK",
  "vehicle": {
    "make": "Volkswagen",
    "model": "Golf",
    "model_year": 2020,
    "mileage": {
      "value": 65000,
      "unit": "km"
    },
    "fuel": "petrol",
    "transmission": "automatic"
  }
}

Text example:

{
  "country": "DK",
  "description": "Volkswagen Golf 1.5 TSI DSG, registered 2020, 65000 km"
}

Comparables example:

{
  "country": "SE",
  "vehicle": {
    "make": "Volvo",
    "model": "XC60",
    "model_year": 2021,
    "mileage": {
      "value": 6500,
      "unit": "mil"
    },
    "fuel": "plug_in_hybrid_petrol",
    "transmission": "automatic"
  },
  "options": {
    "include": [
      "comparables"
    ]
  }
}

Trade in example:

{
  "country": "DE",
  "vehicle": {
    "make": "Volkswagen",
    "model": "Golf",
    "model_year": 2021,
    "mileage": {
      "value": 48000,
      "unit": "km"
    },
    "fuel": "petrol",
    "transmission": "manual"
  },
  "options": {
    "include": [
      "trade_in_price",
      "similar_cars_link"
    ]
  }
}

#Response

application/json: a valuation result. Refused and failed valuations return the same envelope with status and a nested error, using the error's HTTP status. Errors before a valuation is recorded return a Problem as application/problem+json.

#Response headers

#Errors

#Examples

curl https://data-services.autouncle.com/v1/valuations \
  -H "Authorization: Bearer $AUTOUNCLE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: first-valuation-001' \
  -d @- <<'JSON'
{
  "country": "DK",
  "vehicle": {
    "make": "Volkswagen",
    "model": "Golf",
    "model_year": 2020,
    "mileage": {
      "value": 60000,
      "unit": "km"
    }
  }
}
JSON

require "json"
require "net/http"

uri = URI("https://data-services.autouncle.com/v1/valuations")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("AUTOUNCLE_API_KEY")}"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "first-valuation-001"
request.body = JSON.generate({
  "country" => "DK",
  "vehicle" => {
    "make" => "Volkswagen",
    "model" => "Golf",
    "model_year" => 2020,
    "mileage" => {
      "value" => 60000,
      "unit" => "km"
    }
  }
})
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
puts JSON.pretty_generate(JSON.parse(response.body))

import json
import os

import requests

response = requests.post(
    "https://data-services.autouncle.com/v1/valuations",
    headers={
        "Authorization": f"Bearer {os.environ['AUTOUNCLE_API_KEY']}",
        "Idempotency-Key": "first-valuation-001",
    },
    json={
        "country": "DK",
        "vehicle": {
            "make": "Volkswagen",
            "model": "Golf",
            "model_year": 2020,
            "mileage": {
                "value": 60000,
                "unit": "km"
            }
        }
    },
    timeout=30,
)
print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data-services.autouncle.com/v1/valuations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AUTOUNCLE_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "first-valuation-001",
  },
  body: JSON.stringify({
    country: "DK",
    vehicle: {
      make: "Volkswagen",
      model: "Golf",
      model_year: 2020,
      mileage: {
        value: 60000,
        unit: "km"
      }
    }
  }),
});
console.log(JSON.stringify(await response.json(), null, 2));

curl https://data-services.autouncle.com/v1/valuations \
  -H "Authorization: Bearer $AUTOUNCLE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: valuation-catalogue-001' \
  -d @- <<'JSON'
{
  "country": "DK",
  "vehicle": {
    "catalogue": {
      "drivetrain_id": "dv-947a3199394a5a4b41cb2869"
    },
    "model_year": 2021,
    "mileage": {
      "value": 45000,
      "unit": "km"
    }
  },
  "pricing": {
    "price_basis": "dealer_retail"
  }
}
JSON

require "json"
require "net/http"

uri = URI("https://data-services.autouncle.com/v1/valuations")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("AUTOUNCLE_API_KEY")}"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "valuation-catalogue-001"
request.body = JSON.generate({
  "country" => "DK",
  "vehicle" => {
    "catalogue" => {
      "drivetrain_id" => "dv-947a3199394a5a4b41cb2869"
    },
    "model_year" => 2021,
    "mileage" => {
      "value" => 45000,
      "unit" => "km"
    }
  },
  "pricing" => {
    "price_basis" => "dealer_retail"
  }
})
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
puts JSON.pretty_generate(JSON.parse(response.body))

import json
import os

import requests

response = requests.post(
    "https://data-services.autouncle.com/v1/valuations",
    headers={
        "Authorization": f"Bearer {os.environ['AUTOUNCLE_API_KEY']}",
        "Idempotency-Key": "valuation-catalogue-001",
    },
    json={
        "country": "DK",
        "vehicle": {
            "catalogue": {
                "drivetrain_id": "dv-947a3199394a5a4b41cb2869"
            },
            "model_year": 2021,
            "mileage": {
                "value": 45000,
                "unit": "km"
            }
        },
        "pricing": {
            "price_basis": "dealer_retail"
        }
    },
    timeout=30,
)
print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data-services.autouncle.com/v1/valuations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AUTOUNCLE_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "valuation-catalogue-001",
  },
  body: JSON.stringify({
    country: "DK",
    vehicle: {
      catalogue: {
        drivetrain_id: "dv-947a3199394a5a4b41cb2869"
      },
      model_year: 2021,
      mileage: {
        value: 45000,
        unit: "km"
      }
    },
    pricing: {
      price_basis: "dealer_retail"
    }
  }),
});
console.log(JSON.stringify(await response.json(), null, 2));

#GET /v1/valuations/{id}

Retrieve your workspace’s recorded valuation.

Returns the result exactly as it was recorded, including its notes and attributions, but without the usage block. A test key reads only test-mode results and a live key only live results.

• Scope: valuations:read
• Cost: Free. Counts towards the per-minute valuation rate limit.
• Rate limit: valuations bucket, default 60 requests per minute. See limits.

#Parameters

#Response

application/json: a valuation result. Refused and failed valuations return the same envelope with status and a nested error, using the error's HTTP status. Errors before a valuation is recorded return a Problem as application/problem+json.

#Response headers

#Errors

#Examples

curl https://data-services.autouncle.com/v1/valuations/val_0123456789abcdef0123456789abcdef \
  -H "Authorization: Bearer $AUTOUNCLE_API_KEY"

require "json"
require "net/http"

uri = URI("https://data-services.autouncle.com/v1/valuations/val_0123456789abcdef0123456789abcdef")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("AUTOUNCLE_API_KEY")}"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
puts JSON.pretty_generate(JSON.parse(response.body))

import json
import os

import requests

response = requests.get(
    "https://data-services.autouncle.com/v1/valuations/val_0123456789abcdef0123456789abcdef",
    headers={
        "Authorization": f"Bearer {os.environ['AUTOUNCLE_API_KEY']}",
    },
    timeout=30,
)
print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data-services.autouncle.com/v1/valuations/val_0123456789abcdef0123456789abcdef", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.AUTOUNCLE_API_KEY}`,
  },
});
console.log(JSON.stringify(await response.json(), null, 2));

#POST /v1/selling-times

Value a vehicle and forecast its selling time.

Values the vehicle exactly as POST /v1/valuations does and adds selling_time: the expected days to sell, and the chance of selling within 30, 60 and 90 days, for an asking price in the middle of each price-rating band and at pricing.asking_price when it is sent. Available in every Data Services market; a country Data Services does not serve to every workspace (such as BE, on request) is refused with selling_time_unsupported_market, and a market whose forecast model is temporarily missing fails with selling_time_unavailable; neither is charged. Two credits per successful live forecast, one for the valuation (usage.charges.base) and one for the forecast (usage.charges.selling_time), plus any requested add-on such as comparables or a trade-in price; when the forecast cannot be made the request fails (selling_time_unavailable or selling_time_timeout) and nothing is charged. Test keys return fixed synthetic forecasts for free. Idempotency, admission limits and replays work as for valuations, and the result is read back with GET /v1/valuations/{id}.

Available in every Data Services market; only a country Data Services does not serve to every workspace, such as Belgium, is refused with selling_time_unsupported_market. When a market's forecast model is temporarily missing, the request fails with selling_time_unavailable (503) and nothing is charged. The response is a valuation with selling_time added, and the same valuation ID reads it back with GET /v1/valuations/{id}. A credit grant must hold both credits. Counts against the valuation rate limit and needs a valuation concurrency slot, like POST /v1/valuations.

• Scope: valuations:write
• Cost: Two credits for a successful (valued) live forecast: one for the valuation and one for the forecast, plus one when requested comparables are returned. Test keys, refusals and failures, including a forecast that could not be made, are free.
• Rate limit: valuations bucket, default 60 requests per minute. See limits.

#Parameters

#Request body

application/json, at most 1 MB. A ValuationRequest: country plus at least one of vehicle, description or images. Unknown fields are rejected.

Structured example:

{
  "country": "SE",
  "vehicle": {
    "make": "Volvo",
    "model": "XC60",
    "model_year": 2019,
    "mileage": {
      "value": 9000,
      "unit": "mil"
    },
    "fuel": "diesel",
    "transmission": "automatic"
  },
  "pricing": {
    "asking_price": 289000
  }
}

#Response

application/json: a valuation result. Refused and failed valuations return the same envelope with status and a nested error, using the error's HTTP status. Errors before a valuation is recorded return a Problem as application/problem+json.

#Response headers

#Errors

#Examples

curl https://data-services.autouncle.com/v1/selling-times \
  -H "Authorization: Bearer $AUTOUNCLE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: selling-time-001' \
  -d @- <<'JSON'
{
  "country": "SE",
  "vehicle": {
    "make": "Volvo",
    "model": "XC60",
    "model_year": 2019,
    "mileage": {
      "value": 9000,
      "unit": "mil"
    },
    "fuel": "diesel",
    "transmission": "automatic"
  },
  "pricing": {
    "asking_price": 289000
  }
}
JSON

require "json"
require "net/http"

uri = URI("https://data-services.autouncle.com/v1/selling-times")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("AUTOUNCLE_API_KEY")}"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "selling-time-001"
request.body = JSON.generate({
  "country" => "SE",
  "vehicle" => {
    "make" => "Volvo",
    "model" => "XC60",
    "model_year" => 2019,
    "mileage" => {
      "value" => 9000,
      "unit" => "mil"
    },
    "fuel" => "diesel",
    "transmission" => "automatic"
  },
  "pricing" => {
    "asking_price" => 289000
  }
})
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
puts JSON.pretty_generate(JSON.parse(response.body))

import json
import os

import requests

response = requests.post(
    "https://data-services.autouncle.com/v1/selling-times",
    headers={
        "Authorization": f"Bearer {os.environ['AUTOUNCLE_API_KEY']}",
        "Idempotency-Key": "selling-time-001",
    },
    json={
        "country": "SE",
        "vehicle": {
            "make": "Volvo",
            "model": "XC60",
            "model_year": 2019,
            "mileage": {
                "value": 9000,
                "unit": "mil"
            },
            "fuel": "diesel",
            "transmission": "automatic"
        },
        "pricing": {
            "asking_price": 289000
        }
    },
    timeout=30,
)
print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data-services.autouncle.com/v1/selling-times", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AUTOUNCLE_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "selling-time-001",
  },
  body: JSON.stringify({
    country: "SE",
    vehicle: {
      make: "Volvo",
      model: "XC60",
      model_year: 2019,
      mileage: {
        value: 9000,
        unit: "mil"
      },
      fuel: "diesel",
      transmission: "automatic"
    },
    pricing: {
      asking_price: 289000
    }
  }),
});
console.log(JSON.stringify(await response.json(), null, 2));

POST /v1/selling-times takes the same request fields as a valuation and returns the same result with selling_time added. See selling-time forecasts.

#Request fields

Every field of the request body. country is required, plus at least one of vehicle (with at least one attribute), description or images. Omit what you do not know rather than guessing. vehicle takes the vehicle's attributes, listed below, or an AVS vehicle document such as one an endpoint returned (VehicleInput); describing a vehicle explains how the fields work together.

#The valuation result

Returned by POST /v1/valuations (with usage), GET /v1/valuations/{id} (without usage), and the MCP valuate_car and get_valuation tools. When status is valued, the result contains vehicle, identification, valuation, precision, price_ratings, improve_precision, warnings and model. When it is refused or failed, it contains error instead and never valuation.

vehicle is the Vehicle that was valued, an AVS vehicle document. identification says how it was identified, lists competing catalogue records in candidates and where each value came from in fields. Results recorded before contract 0.9.0 are converted when you read them, so GET /v1/valuations/{id} returns the same shape for every result.

#A complete test-mode result

{
  "request_id": "val_05f96b492a25a0ef9eb7aa99218a43be",
  "object": "valuation",
  "country": "DK",
  "mode": "test",
  "status": "valued",
  "vehicle": {
    "avs": { "version": "0.3", "kind": "vehicle" },
    "identity": {
      "brand": { "name": "VW", "ids": [{ "scheme": "autouncle", "value": "b-0957579dc5bca6de229d2f32" }] },
      "model": { "name": "Golf VII", "ids": [{ "scheme": "autouncle", "value": "cm-88dbede1978bc412872a6e1c" }] }
    },
    "vehicle": {
      "registration": { "country": "DK", "modelYear": 2020 },
      "odometer": { "km": 60000 }
    }
  },
  "identification": {
    "status": "ambiguous",
    "level": "model",
    "catalogue_version": "5.6.9:NEW",
    "candidates": {
      "generation": [
        { "id": "mg-43ed101760c6bc4c4c2e44bd", "name": "Golf VII (5-door, facelift 2017)", "from_year": 2017, "to_year": 2021, "score": 0.999999 },
        { "id": "mg-5b0e2f6c8d1a4e7b9c3f2a10", "name": "Golf VII Variant (facelift 2017)", "from_year": 2017, "to_year": 2021, "score": 0.999999 }
      ]
    },
    "fields": {
      "/identity/body": { "basis": "catalogue", "source": "catalogue_match", "status": "ambiguous", "candidate_count": 2 },
      "/identity/brand": { "basis": "catalogue", "source": "catalogue_match", "status": "derived", "match_score": 1.0 },
      "/identity/model": { "basis": "catalogue", "source": "catalogue_match", "status": "derived", "match_score": 1.0 },
      "/vehicle/odometer": { "basis": "observed", "source": "provided", "status": "supplied" },
      "/vehicle/registration/modelYear": { "basis": "observed", "source": "provided", "status": "supplied" }
    }
  },
  "valuation": {
    "price": 102673,
    "currency": "DKK",
    "price_basis": "dealer_retail",
    "price_basis_description": "Expected asking price when freshly listed by a dealer.",
    "intervals": [
      { "coverage": 0.8, "low": 82138, "high": 123208, "method": "synthetic" },
      { "coverage": 0.95, "low": 66737, "high": 138609, "method": "synthetic" },
      { "coverage": 0.99, "low": 51337, "high": 154010, "method": "synthetic" }
    ],
    "valuation_date": "2026-10-26"
  },
  "precision": {
    "grade": "indicative",
    "summary": "Synthetic sandbox result. Not a market valuation.",
    "identity_level": "car_model",
    "interval_width_pct": 40.0,
    "data_support": {},
    "typical_error_pct": null
  },
  "price_ratings": {
    "bands": [
      { "rating": 5, "label": "Super price", "from": 69588, "to": 86130 },
      { "rating": 4, "label": "Good price", "from": 86130, "to": 94402 },
      { "rating": 3, "label": "Fair price", "from": 94402, "to": 110944 },
      { "rating": 2, "label": "A bit expensive", "from": 110944, "to": 119216 },
      { "rating": 1, "label": "Expensive", "from": 119216, "to": 135758 }
    ],
    "asking_price_rating": null,
    "asking_price_label": null,
    "stable_within_80pct_interval": null
  },
  "improve_precision": [
    { "field": "vehicle.catalogue.drivetrain_id", "reason": "drivetrain_unresolved", "expected_impact": "high", "message": "Select the exact engine and transmission from the catalogue." },
    { "field": "vehicle.condition", "reason": "condition_unknown", "expected_impact": "medium", "message": "Provide the vehicle's condition." }
  ],
  "warnings": [
    { "code": "generation_ambiguous", "message": "More than one generation fits the supplied information. Select its catalogue ID for greater precision." }
  ],
  "model": { "model_id": "sandbox-v1", "trained_on": null, "catalogue_version": "NEW", "synthetic": true },
  "notes": [
    { "code": "estimate_not_offer", "category": "disclaimer", "message": "This is a statistical estimate for the stated price basis. It is not an offer, an appraisal or a guaranteed transaction price.", "pointers": ["/valuation"], "source_ids": [] },
    { "code": "market_specific", "category": "limitation", "message": "This result applies only to the DK market, its currency and the stated price basis. Do not apply it to another market.", "pointers": ["/valuation", "/price_ratings"], "source_ids": [] },
    { "code": "synthetic_result", "category": "limitation", "message": "Synthetic sandbox result from a deterministic simulator. No market data or production valuation model contributed. Do not use it as a market valuation.", "pointers": ["/valuation", "/precision", "/price_ratings"], "source_ids": [] }
  ],
  "attributions": [
    {
      "source_id": "autouncle_vehicle_catalogue",
      "name": "AutoUncle vehicle catalogue",
      "url": "https://data-services.autouncle.com/docs/catalogue",
      "party": "first_party",
      "role": "vehicle_catalogue",
      "license": { "id": "autouncle_data_services_terms", "name": "AutoUncle Data Services terms", "url": "https://data-services.autouncle.com/legal/terms" },
      "attribution_text": null,
      "notice_status": "pending_review",
      "notice_version": "autouncle_vehicle_catalogue@1",
      "pointers": ["/vehicle/identity/brand", "/vehicle/identity/model"]
    }
  ],
  "usage": { "billable": false, "credits_used": 0, "original_credits_used": 0, "charges": {}, "credits_remaining": 0, "cache_hit": false, "idempotent_replay": false, "mode": "test" }
}

#Comparable listings

With "options": { "include": ["comparables"] }, a valued result also has comparables: up to five similar listings on sale and five recently sold in the same market, with top-level facts only, as evidence beside the price. Each listing is a ComparableListing. They cost one extra credit on a live key, charged only when listings are returned, and never change the valuation. See comparable listings for how they are selected and how to show them.

{
  "comparables": {
    "status": "included",
    "unavailable_reason": null,
    "synthetic": false,
    "criteria": {
      "make": "Volvo", "model": "XC60",
      "model_year": { "from": 2020, "to": 2022 },
      "mileage": null,
      "fuel": "plug_in_hybrid_petrol", "transmission": "automatic", "body": "suv", "engine_size_l": 2.0,
      "sold_within_days": 30
    },
    "on_sale": [
      {
        "make": "Volvo", "model": "XC60", "model_year": 2021,
        "mileage": { "value": 7000, "unit": "mil" },
        "asking_price": 430000, "currency": "SEK", "price_rating": 3,
        "days_on_market": 18
      }
    ],
    "recently_sold": [
      {
        "make": "Volvo", "model": "XC60", "model_year": 2021,
        "mileage": { "value": 6000, "unit": "mil" },
        "asking_price": 439000, "currency": "SEK", "price_rating": 3,
        "days_on_market": 47
      }
    ]
  }
}

In Denmark status is unavailable with unavailable_reason: "market_restricted", empty lists and a comparables_unavailable_in_market note.

#Trade-in price and link to similar cars

With "options": { "include": ["trade_in_price", "similar_cars_link"] }, a valued result also has trade_in_price, AutoUncle's estimate of a fair trade-in price with a range, and similar_cars_url, a link to similar cars for sale on the market's AutoUncle site. The trade-in price costs one extra credit on a live key, charged only when it is returned; the link is free. Neither changes the valuation. See trade-in price and link to similar cars.

{
  "trade_in_price": {
    "status": "included",
    "unavailable_reason": null,
    "synthetic": false,
    "price": 17800,
    "low": 17400,
    "high": 18200,
    "currency": "EUR"
  },
  "similar_cars_url": "https://www.autouncle.de/de/gebrauchtwagen/VW/Golf%20VIII/f-benzin/y-2021/b-hatchback?…"
}

In every other market, such as Finland, Romania and Belgium, trade_in_price.status is unavailable with unavailable_reason: "market_unsupported", null prices and a trade_in_price_unavailable_in_market note.

#A refused result

A refusal is recorded, free and replayable. It uses the error's HTTP status (here 422) and the same envelope:

{
  "request_id": "val_ff744d44049c52dd6cb9d22b13e45636",
  "object": "valuation",
  "country": "DK",
  "mode": "test",
  "status": "refused",
  "error": {
    "type": "https://data-services.autouncle.com/docs/errors#missing_mileage",
    "title": "Missing mileage",
    "status": 422,
    "code": "missing_mileage",
    "detail": "Supply the actual mileage in vehicle.mileage, or explicitly set options.allow_mileage_estimation to true to use a fixed 96,000 km baseline assumption.",
    "errors": [{ "pointer": "/vehicle/mileage", "message": "Actual mileage or explicit baseline permission is required." }],
    "fix": [
      "Supply vehicle.mileage with its value and unit.",
      "If a fixed baseline assumption is acceptable, set options.allow_mileage_estimation to true. Strict resolution still requires actual mileage."
    ],
    "request_id": "val_ff744d44049c52dd6cb9d22b13e45636",
    "docs_url": "https://data-services.autouncle.com/docs/errors",
    "billable": false,
    "retryable": false
  },
  "notes": [],
  "attributions": [],
  "usage": { "billable": false, "credits_used": 0, "original_credits_used": 0, "charges": {}, "credits_remaining": 0, "cache_hit": false, "idempotent_replay": false, "mode": "test" }
}

#The Problem object

Errors that stop a request before a valuation is recorded (authentication, validation, limits) return a Problem document with Content-Type: application/problem+json. Refused and failed valuations carry the same object in error. See errors & retries for every code.

service (the public name of a failing dependency, such as valuation_engine or image_fetch), reason (a refusal reason, when known) and retry_after (seconds to wait) appear only when they apply.