New Car API

7 min

Introduction

This API from Signzy is used to fetch the price of new cars.

How to call the API

You will need to login before sending new 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 New 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.../newcar' \
--header 'Accept: application/json, text/plain, */*' \
--header 'Authorization: ....<access token>..... \
--header 'Content-Type: application/json' \
--data-raw '{
    "task": "price",
    "essentials": {
        "manufacturerName": "<Manufacturing company name>",
        "modelName": "<Car Model name>",
        "trimName": "<Car Trim name>",
        "transactionType": "<buy/sale>",
        "customerType": "<Type of customer>",
        "city": "<City name>"
    }
}'

curl --location --request POST 'https://signzy.tech/api/v2/patrons/...PatronId.../newcar' \
--header 'Accept: application/json, text/plain, */*' \
--header 'Authorization: ....<access token>..... \
--header 'Content-Type: application/json' \
--data-raw '{
    "task": "price",
    "essentials": {
        "manufacturerName": "<Manufacturing company name>",
        "modelName": "<Car Model name>",
        "trimName": "<Car Trim name>",
        "transactionType": "<buy/sale>",
        "customerType": "<Type of customer>",
        "city": "<City name>"
    }
}'

Input Parameters

PARAMETERS	DESCRIPTION	TYPE	VALUE (REQUIRED /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

Sample Response

{
    "essentials": {
        "manufacturerName": "Tata",
        "modelName": "Nexon",
        "trimName": "XM (S) PETROL",
        "transactionType": "b",
        "customerType": "individual",
        "city": "asind"
    },
    "id": "6332bc410xxxxxxxxxxxx",
    "patronId": "62fd034xxxxxxxxxxxxx",
    "task": "price",
    "result": {
        "price": "10,46,601"
    }
}

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 City Name City Name
id	The access token generated during login request is held here.
patronId	This parameter is returned as userId parameter of login request.
task	This parameter gives the name of the task.
result	This parameter gives the output.
result.price	This parameter gives 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].