{"info":{"_postman_id":"d738abee-1631-40ce-8548-a7102c60ced2","name":"RentiCar API","description":"

Be sure to do the following and provide the necessary information before you start using the services.

Check that this document is the last published version.
Provide username / password information required for user authentication.
Make sure that the authorization descriptions are made in order to use the services.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Environment	Endpoint
Test	https://test-api.renticar.com/api/v1/
Production	https://api.renticar.com/api/v1/

Reservations in all environments will be forwarded to the rental companies as real reservations. Please cancel reservations after your tests.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"40725270","collectionId":"d738abee-1631-40ce-8548-a7102c60ced2","publishedId":"2sAYJ7feHs","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"00457a"},"publishDate":"2024-12-31T07:47:12.000Z"},"item":[{"name":"Login","id":"db0ff1e7-02fb-4349-b0fe-9eea597f7bd1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\" : \"api@renticar.com\",\n \"password\" : \"Api5400!\"\n}","options":{"raw":{"language":"json"}}},"url":"https://test-api.renticar.com/api/v1/login","description":"

In order to access the services, you must first get tokens from the login service. The token validity period is 1 day. In all services, you must send it as \"Bearer $TOKEN\" in Authorization on the Header.

\n","urlObject":{"path":["login"],"host":["https://test-api.renticar.com/api/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"db0ff1e7-02fb-4349-b0fe-9eea597f7bd1"},{"name":"Cars","id":"e40b822b-7110-4470-9c42-69a326f7f4d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXJ0bmVySUQiOiI2NGQ0N2RlYzdiMWZjZTExMTExYWU2NjAiLCJfaWQiOiI2MzNkOTliMzIyYzM5MDY2M2FkYTJmOTMiLCJpYXQiOjE3MTE1MjUwNDUsImV4cCI6MTcxMTYxMTQ0NX0.7TlupN87Rt30GdoHzG5A8ZqCA7FjavS46VwE19Kd6e8"}]},"isInherited":false},"method":"GET","header":[],"url":"https://test-api.renticar.com/api/v1/cars","description":"

Lists all vehicle groups of RentiCar. Lists all vehicle groups of RentiCar. All information about the vehicles will also be sent to you while the available vehicles are listed in the Search service.

\n","urlObject":{"path":["cars"],"host":["https://test-api.renticar.com/api/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"e40b822b-7110-4470-9c42-69a326f7f4d2"},{"name":"Locations","id":"3871fc55-b711-4b5f-890b-0ce7f4ee4080","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXJ0bmVySUQiOiI2NGQ0N2RlYzdiMWZjZTExMTExYWU2NjAiLCJfaWQiOiI2MzNkOTliMzIyYzM5MDY2M2FkYTJmOTMiLCJpYXQiOjE3MTE1MjUwNDUsImV4cCI6MTcxMTYxMTQ0NX0.7TlupN87Rt30GdoHzG5A8ZqCA7FjavS46VwE19Kd6e8"}]},"isInherited":false},"method":"GET","header":[],"url":"https://test-api.renticar.com/api/v1/locations","description":"

Lists all Renticar locations. You must submit the locationSlug field on Search method.

\n","urlObject":{"path":["locations"],"host":["https://test-api.renticar.com/api/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"3871fc55-b711-4b5f-890b-0ce7f4ee4080"},{"name":"Search","id":"b65d8a4c-4222-4965-bacd-e0ad54bb5e85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXJ0bmVySUQiOiI2NGQ0N2RlYzdiMWZjZTExMTExYWU2NjAiLCJfaWQiOiI2MzNkOTliMzIyYzM5MDY2M2FkYTJmOTMiLCJpYXQiOjE3MTE1MjUwNDUsImV4cCI6MTcxMTYxMTQ0NX0.7TlupN87Rt30GdoHzG5A8ZqCA7FjavS46VwE19Kd6e8"}]},"isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"pickup_datetime\": \"2024-07-27T18:00:00\",\n \"return_datetime\": \"2024-07-29T18:00:00\",\n \"pickup_location\": \"kibris-lefkosa-ercan-uluslararasi-havalimani-ecn\",\n \"return_location\": \"kibris-lefkosa-ercan-uluslararasi-havalimani-ecn\"\n}","options":{"raw":{"language":"json"}}},"url":"https://test-api.renticar.com/api/v1/search","description":"

You should send the locationSlug field that you get from the Location method. Each offer will be returned to you as an offerId. The offerId timeout is 30 minutes. After the timeout, a search should be made with the Search method again.

Possible Error codes are as follows.

{ result: \"error\", message: \"INVALID_PROMO_CODE\"}

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Error Code	Detail
INVALID_PROMO_CODE	If the promo code has been sent, your promo code is invalid.
INVALID_PROMO_DATES	If a promotional code has been sent, your code is not valid on these dates.
INVALID_PICKUP_DATE	Your pickup date is invalid.
INVALID_DELIVERY_DATE	Your dropoff date is invalid.
ARAMA_TALEBI_OLUSTURULMADI	The search request could not be created. System failure.

Example Response

{\n    \"status\": \"success\",\n    \"search\": {\n        \"_id\": \"63480d06b60f2c6343520d54\",\n        \"pickup_location\": \"istanbul-sabiha-gokcen-havalimani-saw\",\n        \"pickup_location_name\": \"İstanbul Sabiha Gökçen Havalimanı (SAW)\",\n        \"pickup_datetime\": \"2022-11-15T20:30:00.000Z\",\n        \"return_location\": \"istanbul-sabiha-gokcen-havalimani-saw\",\n        \"return_location_name\": \"İstanbul Sabiha Gökçen Havalimanı (SAW)\",\n        \"return_datetime\": \"2022-11-17T20:30:00.000Z\",\n        \"day\": 2\n    },\n    \"offers\": [\n        {\n            \"offerId\": \"63480d11b60f2c6343520d6c\",\n            \"companySlug\": \"novacar\",\n            \"totalDays\": 2,\n            \"pickupOffice\": {\n                \"name\": \"Sabiha Gökçen Havalimanı\",\n                \"address\": \"Orhanlı Mahallesi Fettah Başaran Caddesi Kayalık sokak no :1  Orhanlı - TUZLA / İSTANBUL\",\n                \"city\": \"İstanbul\",\n                \"telephone\": \"0531 937 80 85\",\n                \"deliveryType\": \"vale\",\n                \"locationGeo\": {\n                    \"type\": \"Point\",\n                    \"coordinates\": [\n                        40.9116918,\n                        29.34301319999999\n                    ]\n                }\n            },\n            \"returnOffice\": {\n                \"name\": \"Sabiha Gökçen Havalimanı\",\n                \"address\": \"Orhanlı Mahallesi Fettah Başaran Caddesi Kayalık sokak no :1  Orhanlı - TUZLA / İSTANBUL\",\n                \"telephone\": \"0531 937 80 85\",\n                \"deliveryType\": \"vale\",\n                \"locationGeo\": {\n                    \"type\": \"Point\",\n                    \"coordinates\": [\n                        40.9116918,\n                        29.34301319999999\n                    ]\n                }\n            },\n            \"car\": {\n                \"carId\": \"603e50b60d7837393339fe6c\",\n                \"seat\": 5,\n                \"brand\": \"Peugeot\",\n                \"model\": \"208\",\n                \"class\": \"economic\",\n                \"segment\": \"B\",\n                \"size\": \"small\",\n                \"body\": \"hatchback\",\n                \"transmission\": \"manuel\",\n                \"fuel\": \"gas\",\n                \"fuelPolicy\": \"sameLevel\",\n                \"airCondition\": true,\n                \"sipp\": \"MVMV\"\n            },\n            \"rules\": {\n                \"dailyRangeLimit\": 400,\n                \"totalRangeLimit\": 400,\n                \"driverAge\": \"24\",\n                \"doubleCreditCard\": false,\n                \"licenseYears\": 3,\n                \"freeCancel\": true,\n                \"freeCancelTime\": 24,\n                \"cdw\": true,\n                \"thirdPartyCoverage\": true,\n                \"theftProtection\": true,\n                \"roadAssistance\": true,\n                \"unlimitedMileage\": false\n            },\n            \"pricing\": {\n                \"totalPrice\": {\n                    \"USD\": 38.66,\n                    \"EUR\": 39.81,\n                    \"TRY\": 719.04\n                },\n                \"dailyPrice\": {\n                    \"USD\": 19.33,\n                    \"EUR\": 19.91,\n                    \"TRY\": 359.52\n                },\n                \"vendorDay\": 2,\n                \"dropPrice\": {\n                    \"USD\": 0,\n                    \"EUR\": 0,\n                    \"TRY\": 0\n                },\n                \"provision\": {\n                    \"USD\": 40.33,\n                    \"EUR\": 41.53,\n                    \"TRY\": 750\n                }\n            },\n            \"createdAt\": \"2022-10-13T13:05:21.373Z\",\n            \"isFullCreditAvailable\": true\n        }\n    }]\n}\n\n

\n","urlObject":{"path":["search"],"host":["https://test-api.renticar.com/api/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"b65d8a4c-4222-4965-bacd-e0ad54bb5e85"},{"name":"Extras","id":"fc00f4bc-e1d6-484f-a9de-c3620fcf3efb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXJ0bmVySUQiOiI2NGQ0N2RlYzdiMWZjZTExMTExYWU2NjAiLCJfaWQiOiI2MzNkOTliMzIyYzM5MDY2M2FkYTJmOTMiLCJpYXQiOjE3MTE1MjUwNDUsImV4cCI6MTcxMTYxMTQ0NX0.7TlupN87Rt30GdoHzG5A8ZqCA7FjavS46VwE19Kd6e8"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"offerId\" : \"628a98a204776113ec0c2572\"\n}","options":{"raw":{"language":"json"}}},"url":"https://test-api.renticar.com/api/v1/extras","description":"

Provides listing of additional products belonging to the offer. Payment for additional products is made at the rental branch.

You can send the \"code\" field of the additional products you have selected as a array in the Reservation method.

Possible Error codes are as follows.

{ result: \"error\", message: \"OFFERID_NOT_FOUND\"}

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Error Code	Detail
OFFERID_NOT_FOUND	Offer id not found.
OFFERID_TIMEOUT	Timeout error. System failure.
EXTRAS_NOT_FOUND	No additional product information could be found for this reservation.

","urlObject":{"path":["extras"],"host":["https://test-api.renticar.com/api/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"fc00f4bc-e1d6-484f-a9de-c3620fcf3efb"},{"name":"Reservation","id":"1203bee9-c249-43ae-9d16-dab99073b662","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXJ0bmVySUQiOiI2NGQ0N2RlYzdiMWZjZTExMTExYWU2NjAiLCJfaWQiOiI2MzNkOTliMzIyYzM5MDY2M2FkYTJmOTMiLCJpYXQiOjE3MTE1MjUwNDUsImV4cCI6MTcxMTYxMTQ0NX0.7TlupN87Rt30GdoHzG5A8ZqCA7FjavS46VwE19Kd6e8"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"offerId\": \"648842242f5ef110a2e5eece\",\n \"driverInfo\": {\n \"identity\": {\n \"certificateType\": \"tc\",\n \"value\": \"12345678901\"\n },\n \"name\": \"TEST\",\n \"lastname\": \"PARTNER\",\n \"birthday\": \"1987-03-29\",\n \"email\": \"admin@renticar.com\",\n \"phone\": \"5552000000\"\n },\n \"reservationType\": \"payOnArrival\", // OPTIONAL\n \"newDailyPrice\" : \"1500\", // OPTIONAL\n \"currency\": \"TRY\",\n \"extras\": []\n}","options":{"raw":{"language":"json"}}},"url":"https://test-api.renticar.com/api/v1/reservation","description":"

It converts the offer you received before into a reservation and transmits it instantly to the supplier.

Request parameters are described below.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
offerId	String	offerId from Search method orders.
driverInfo.identity.certificateType	String	If the driver is a Turkish citizen, \"tc\" should be sent, otherwise \"passport\" should be sent.
driverInfo.identity.value	String	Driver's citizenship number or passport number.
driverInfo.name	String	Driver First name
driverInfo.lastname	String	Driver Last name
driverInfo.birthday	String	Driver Birthday `Format: YYYY-MM-DD`
driverInfo.email	String	Driver Email Address
driverInfo.phone	String	Driver Mobile Phone number. `Format: +905302221122`
currency	String	TRY, EURO, USD
reservationType	String (Optional) default(normal)	`fullCredit` `normal` `payOnArrival` Example: you can send fullCredit if offers.$.isFullCreditAvailable is true on search method.
extras	Array	Add the objects you selected from the list returned from the Extras method to the array.

Possible Error codes are as follows.

{ result: \"error\", message: \"OFFER_ID_HAS_BEEN_USED_BEFORE\"}

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Error Code	Detail
OFFER_ID_HAS_BEEN_USED_BEFORE	Offer id used before. Please research
ORDER_ID_TIMEOUT	Typically, your time to convert an offer to a reservation is 30 minutes. Depending on the supplier, this time can be reduced to 20 minutes.
OFFER_ID_NOT_FOUND	Offer id not found. Please send offerId from Search method.
RESERVATION_VENDOR_REQUEST_NOT_AVAILABLE	Your reservation could not be forwarded to the supplier for some reason. Reservation failed. Try again with a new search.

","urlObject":{"path":["reservation"],"host":["https://test-api.renticar.com/api/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"1203bee9-c249-43ae-9d16-dab99073b662"},{"name":"Reservation Cancel","id":"f5c4a40c-a00e-41aa-9d31-0fc7ed0eca41","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXJ0bmVySUQiOiI2NGQ0N2RlYzdiMWZjZTExMTExYWU2NjAiLCJfaWQiOiI2MzNkOTliMzIyYzM5MDY2M2FkYTJmOTMiLCJpYXQiOjE3MTE1MjUwNDUsImV4cCI6MTcxMTYxMTQ0NX0.7TlupN87Rt30GdoHzG5A8ZqCA7FjavS46VwE19Kd6e8"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"reservationId\" : \"6299c0d73387a00771159769\"\n}","options":{"raw":{"language":"json"}}},"url":"https://test-api.renticar.com/api/v1/reservation/cancel","description":"

This methods allows you to cancel the reservation if it has not started.

\n","urlObject":{"path":["reservation","cancel"],"host":["https://test-api.renticar.com/api/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"f5c4a40c-a00e-41aa-9d31-0fc7ed0eca41"}],"event":[{"listen":"prerequest","script":{"id":"b3d82f94-922e-4570-ad1a-4a86bbf848fd","type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"id":"7f132970-9c35-494f-a04a-d8eee0445d89","type":"text/javascript","requests":{},"exec":[""]}}],"variable":[{"key":"URL","value":"https://test-api.renticar.com/api/v1"},{"key":"TOKEN","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXJ0bmVySUQiOiI2NGQ0N2RlYzdiMWZjZTExMTExYWU2NjAiLCJfaWQiOiI2MzNkOTliMzIyYzM5MDY2M2FkYTJmOTMiLCJpYXQiOjE3MTE1MjUwNDUsImV4cCI6MTcxMTYxMTQ0NX0.7TlupN87Rt30GdoHzG5A8ZqCA7FjavS46VwE19Kd6e8"}]}