Skip to content

Insurance Vehicles

POST
/open/sales/insurance/vehicles

Search the insurer vehicle list by make and model. Each result gives the modelno, modeldesc, bodytype, engcc, tonnage and noseats a motor policy needs in policy.motor.

history

Request History

Your request history will appear here.

Headers

X-API-USER stringrequired

Your Moolre username.

X-API-KEY stringrequired

Your Private API Key for the paying wallet.

Content-Type stringrequired

Send application/json.

Body Params

accountnumberstringrequired

Your insurance agent wallet account number.

search_termstringrequired

Make and model to look for, 2 to 60 characters.

seatsintegerrequired

Number of seats of the vehicle, a whole number from 1 to 100.

engccintegerrequired

Engine capacity in cc, a whole number from 1 to 20000.

Responses

Matching vehicles, at most 100. The values shown are examples.

{
  "status": "1",
  "code": "IQ21",
  "message": "Vehicles",
  "data": {
    "search_term": "TOYOTA COROLLA",
    "count": 1,
    "vehicles": [
      {
        "modelno": "1234",
        "modeldesc": "TOYOTA COROLLA",
        "bodytype": "SALOON",
        "engcc": 1600,
        "tonnage": null,
        "noseats": 5
      }
    ]
  },
  "go": null,
  "meta": {
    "requestid": "req_c68f4c66115c26725c796242",
    "notices": []
  }
}
codestring
IQ21 when vehicles were found.
data.search_termstring
The search term used.
data.countinteger
Number of vehicles returned.
data.vehiclesarray
Each vehicle: modelno, modeldesc, bodytype, engcc, tonnage (string or null) and noseats. Send them unchanged in policy.motor.

Nothing matched. Try a shorter or different search_term.

{
  "status": "1",
  "code": "IQ22",
  "message": "No vehicles found",
  "data": {
    "search_term": "TOYOTA COROLLA",
    "count": 0,
    "vehicles": []
  },
  "go": null,
  "meta": {
    "requestid": "req_c68f4c66115c26725c796242",
    "notices": []
  }
}

Fields every response can carry

On failures, read code, message and data (the first failing field). meta is always present and holds requestid (also the X-Request-Id header), notices and, only on idempotent replays, replayed. There is no outcome field: use status, code and data.txstatus. Send X-Moolre-Http-Status: strict to receive real HTTP status codes. See Responses and request IDs and Errors and status codes.

Language

curl --request POST \     --url 'https://api.moolre.com/open/sales/insurance/vehicles' \     --header 'X-API-USER: Your Username' \     --header 'X-API-KEY: YOUR_API_KEY' \     --header 'Content-Type: application/json' \     --data '{  "accountnumber": "",  "search_term": "",  "seats": 5,  "engcc": 1600}'

Response

Body

{  "status": "1",  "code": "IQ22",  "message": "No vehicles found",  "data": {    "search_term": "TOYOTA COROLLA",    "count": 0,    "vehicles": []  },  "go": null,  "meta": {    "requestid": "req_c68f4c66115c26725c796242",    "notices": []  }}