Used Car API

7 min

Introduction

This API from signzy estimates the market value for used cars based on the condition of the car.

How to call the API

You will need to login before sending car price Fetch API request. You are required to pass the access token received from the login call, as authorization header in the request for Used car Price API along with other parameters.

API Input Guidelines

TransactionType should be "b" for Buy and "s" for sell.

Sample Curl

Preproduction

Production

curl --location --request POST 'https://preproduction.signzy.tech/api/v2/patrons/..patronId../usedcar' \
--header 'Accept: */*' \
--header 'Accept-Language: en-US,en;q=0.8' \
--header 'Authorization: <token>' \
--header 'content-type: application/json' \
--data-raw '{
    "task": "price",
    "essentials": {
        "manufacturerName": "...manufacturerName...",
        "modelName": "...modelName...",
        "trimName": "...trimName...",
        "city": "...city...",
        "transactionType": "...transactionType...",
        "customerType": "...customerType...",
        "year": "...year...",
        "kmsDriven": "...kmsDriven..."
    }
}'

curl --location --request POST 'https://signzy.tech/api/v2/patrons/..patronId../usedcar' \
--header 'Accept: */*' \
--header 'Accept-Language: en-US,en;q=0.8' \
--header 'Authorization: <token>' \
--header 'content-type: application/json' \
--data-raw '{
    "task": "price",
    "essentials": {
        "manufacturerName": "...manufacturerName...",
        "modelName": "...modelName...",
        "trimName": "...trimName...",
        "city": "...city...",
        "transactionType": "...transactionType...",
        "customerType": "...customerType...",
        "year": "...year...",
        "kmsDriven": "...kmsDriven..."
    }
}'

Input Parameters

PARAMETERS	DESCRIPTION	TYPE	VALUE (REQUIRED OR OPTIONAL)
Authorization	Contains the id parameter returned from the login step	String	REQUIRED
content-type	application/json	String	REQUIRED
task	Type of task to be performed-"price"	String	REQUIRED
essentials	This parameter contains the essential data for generating output.	String	REQUIRED REQUIRED REQUIRED REQUIRED
essentials.manufacturerName	Car Manufacturer Name	String	REQUIRED
essentials.modelName	Car Model Name	String	REQUIRED REQUIRED
essentials.trimName	Car Trim Name	String	REQUIRED
essentials.transactionType	Buy or Sell ("b"/"s")	String	REQUIRED
essentials.customerType	Type of Customer	String	REQUIRED
essentials.city	City Name	String	REQUIRED
essentials.kmsDriven	Kilometers driven	String	REQUIRED
essentials.year	Year of Manufacture	String	REQUIRED

Sample Response

{
    "essentials": {
        "manufacturerName": "Audi",
        "modelName": "A3",
        "trimName": "35 Tdi Premium + Sunroof",
        "city": "Delhi",
        "transactionType": "b",
        "customerType": "individual",
        "year": "2017",
        "kmsDriven": "2000"
    },
    "id": "63313b53xxxxxxxxxxxxxxxxx",
    "patronId": "5e3c565xxxxxxxxxxxxxxx",
    "task": "price",
    "result": {
        "conditions": {
            "good": {
                "rangeFrom": 1820046,
                "rangeTo": 1932626
            },
            "veryGood": {
                "rangeFrom": 1865547,
                "rangeTo": 1865547
            },
            "excellent": {
                "rangeFrom": 1911048,
                "rangeTo": 2029257
            },
            "fair": {
                "rangeFrom": 1774545,
                "rangeTo": 1884310
            }
        }
    }
}

Response Parameter

Parameter Name	Description
essentials	This parameter contains the essential data for generating output.
essentials.manufacturerName	Car Manufacturer Name
essentials.modelName	Car Model Name
essentials.trimName	Car Trim Name
essentials.transactionType	Describes Transaction type i.e. Buy or Sell ("b"/"s")
essentials.customerType	Type of Customer
essentials.city	City Name
essentials.kmsDriven	Kilometers driven
essentials.year	Year of Manufacture of the vehicle
id	The access token generated during login request is held here.
patronId	This parameter is returned as userId parameter of login request.
task	This paramater is the name of the task.
result	The final response parameters to be displayed are contained here.
result.conditions	This parameter gives the condition of the car.
conditions.good	This parameter is returned when the condition of the car is good.
conditions.verygood	This parameter is returned when the condition of the car is very good.
conditions.excellent	This parameter is returned when the condition of the car is excellent.
conditions.fair	This parameter is returned when the condition of the car is fair.
rangeFrom	Gives the lower limit for the price of the car.
rangeTo	Gives the upper limit for the price of the car.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].