Vehicle API Instructions



Field names and acceptable values

The absence of any required field (Required) will result in an error. Optional fields (Optional) can be omitted without effect.

Field Contents Values Allowed Required?
vendor_id Astoria provided code ex. 123 Required
password Astoria provided password ex. abcd1234 Required
year The year that you would like to obtain a list of vehicle makes for (or vehicle models if you are also passing the make parameter) ex. 2013 Required
make The vehicle make that you would like to obtain a list of vehicle models for (if omitted, you'll see a list of makes for the given year; if included, you'll see a list of models for the given year and make) ex. FORD Optional

Vehicle API Request Using HTTP/1.1 GET

The URL for our Vehicle API is http://api.astoriacompany.com/vehicle_api.php.

Example Request To Obtain a List of Valid Makes for a Given Year

http://api.astoriacompany.com/vehicle_api.php?vendor_id=123&password=abcd1234&year=2013

Responses

Assuming your request is valid, a comma separated list of makes will be returned, e.g.:


ACURA,ASTON MARTIN,AUDI,BENTLEY,BMW,BUICK,CADILLAC,CATERPILLAR,CHEVROLET,CHRYSLER,DODGE,FERRARI,FIAT,FORD,GMC,HONDA,HYUNDAI,
INFINITI,JAGUAR,JEEP,KALMAR,KIA,LAMBORGHINI,LAND ROVER,LEXUS,LINCOLN,MASERATI,MAZDA,MERCEDES-BENZ,MINI,MITSUBISHI,NISSAN,
PORSCHE,RAM,ROLLS-ROYCE,SAAB,SMART,SUBARU,SUZUKI,TOYOTA,VOLKSWAGEN,VOLVO

Example Request To Obtain a List of Valid Models for a Given Year and Make

http://api.astoriacompany.com/vehicle_api.php?vendor_id=123&password=abcd1234&year=2013&make=FORD

Responses

Assuming your request is valid, a comma separated list of models will be returned, e.g.:


C-MAX PREMIUM,C-MAX SE,C-MAX SEL,COURIER L,COURIER XL,E250,E350 SUPER DUTY,E450 SUPER DUTY,ECONOLINE E150,ECONOLINE E250,
ECONOLINE E350 SUPER DUTY,ECOSPORT XLT,EDGE LIMITED,EDGE SE,EDGE SE AWD,EDGE SEL,EDGE SEL AWD,EDGE SPORT,EDGE SPORT AWD,
ESCAPE S,ESCAPE SE,ESCAPE SEL,ESCAPE TITANIUM,EXPEDITION EL LIMITED,EXPEDITION EL XL,EXPEDITION EL XLT/KING RA,
EXPEDITION LTD,EXPEDITION XL,EXPEDITION XLT/KING RANCH,EXPLORER,EXPLORER LIMITED,EXPLORER POLICE INTERCEPT,EXPLORER SPORT,
EXPLORER XLT,F150,F150 SVT RAPTOR,F250 SUPER DUTY,F350 SUPER DUTY,F450 SUPER DUTY,F550 SUPER DUTY,FIESTA AMBIENTE,
FIESTA FIRST,FIESTA S,FIESTA SE,FIESTA TITANIUM,FIESTA TREND,FLEX LIMITED,FLEX SE,FLEX SEL,FOCUS AMBIENTE/SPORT,FOCUS BEV,
FOCUS S,FOCUS SE,FOCUS SPORT,FOCUS ST,FOCUS ST/RT,FOCUS TITANIUM,FUSION S,FUSION SE,FUSION SE AWD,FUSION SE HYBRID,
FUSION SE PHEV,FUSION TITANIUM,FUSION TITANIUM AWD,FUSION TITANIUM HYBRID,FUSION TITANIUM PHEV,MUSTANG,MUSTANG BOSS 302,
MUSTANG GT,MUSTANG SHELBY GT500,RANGER XL,RANGER XLT,TAURUS INTERCEPTOR AWD,TAURUS LIMITED,TAURUS LIMITED AWD,
TAURUS POLICE INTERCEPTOR,TAURUS SE,TAURUS SEL,TAURUS SEL AWD,TAURUS SHO,TRANSIT,TRANSIT CONNECT XLT,
TRANSIT CONNECT XLT PREM