{"id":15659644,"url":"https://github.com/gabrielbb/vehicles-api","last_synced_at":"2025-07-30T16:33:37.119Z","repository":{"id":218249191,"uuid":"125655118","full_name":"GabrielBB/Vehicles-API","owner":"GabrielBB","description":"Public REST API to get Vehicles Types, Brands and Models.","archived":false,"fork":false,"pushed_at":"2019-08-07T15:21:10.000Z","size":63,"stargazers_count":26,"open_issues_count":2,"forks_count":7,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-13T00:05:56.115Z","etag":null,"topics":["rest-api","spring-boot","vehicles-api"],"latest_commit_sha":null,"homepage":"https://the-vehicles-api.herokuapp.com/brands","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GabrielBB.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-03-17T17:53:01.000Z","updated_at":"2025-05-05T11:21:54.000Z","dependencies_parsed_at":"2024-01-20T18:45:45.104Z","dependency_job_id":"5d5abb68-8a58-4b83-ab17-df8761a985e1","html_url":"https://github.com/GabrielBB/Vehicles-API","commit_stats":null,"previous_names":["gabrielbb/vehicles-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GabrielBB/Vehicles-API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielBB%2FVehicles-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielBB%2FVehicles-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielBB%2FVehicles-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielBB%2FVehicles-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GabrielBB","download_url":"https://codeload.github.com/GabrielBB/Vehicles-API/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielBB%2FVehicles-API/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259553130,"owners_count":22875609,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["rest-api","spring-boot","vehicles-api"],"created_at":"2024-10-03T13:17:58.858Z","updated_at":"2025-06-13T00:05:58.132Z","avatar_url":"https://github.com/GabrielBB.png","language":"Java","readme":"# Vehicles API\r\nPublic REST API to get Vehicles Types, Brands and hundreds of Models. Unlike similar API's, this one is free.\r\n\r\nNOTE: Because i'm using a free server, for now, the server shuts down after 30 minutes of inactivity. If it takes some time, is because nobody made a request in the last 30 minutes\r\n\r\n## Paths\r\n\r\n| Path | Method | Description | Parameters\r\n|--|--|--|--|\r\n| /brands | GET | Returns all the vehicle brands | \r\n| /types  | GET | Returns all the vehicle types  |\r\n| /models | GET | Returns Vehicle Models that the brand manufacturer has built. It must be filtered by Brand or Type | `brandId` ID of an object returned from /brands. `typeId` ID of an object returned from /types\r\n\r\n## Examples\r\n\r\n**Example 1**: Get every available brand (Full result not shown here, too much data)\r\n\r\n **Endpoint**: https://the-vehicles-api.herokuapp.com/brands/\r\n \r\n **Result**: \r\n\r\n```json\r\n     [{\"id\":36,\"brand\":\"Acura\"},\r\n     {\"id\":29,\"brand\":\"Alfa Romeo\"},\r\n     {\"id\":569,\"brand\":\"Alkanes\"},\r\n     {\"id\":400,\"brand\":\"Artic Cat\"},\r\n     {\"id\":565,\"brand\":\"Aston Martin\"}]\r\n```\r\n\r\n**Example 2**: Get every available vehicle type\r\n\r\n **Endpoint**: https://the-vehicles-api.herokuapp.com/types/\r\n \r\n **Result**: \r\n\r\n```json\r\n     [{\"id\":1,\"type\":\"Car\"},\r\n     {\"id\":2,\"type\":\"Motorcycle\"},\r\n     {\"id\":3,\"type\":\"Ship\"},\r\n     {\"id\":4,\"type\":\"Heavy Vehicle\"},\r\n     {\"id\":5,\"type\":\"Accesories\"}]\r\n```\r\n\r\n**Example 3**: Get BMW vehicle models\r\n\r\n **Endpoint**: https://the-vehicles-api.herokuapp.com/models?brandId=17\r\n \r\n **Result**: \r\n\r\n```json\r\n     [{\"id\":384,\"model\":\"Serie 1\",\r\n     \"brand\":{\"id\":17,\"brand\":\"BMW\"},\r\n     \"type\":{\"id\":1,\"type\":\"Car\"}},\r\n     \r\n     {\"id\":1548,\"model\":\"GS\",\r\n     \"brand\":{\"id\":17,\"brand\":\"BMW\"},\r\n     \"type\":{\"id\":2,\"type\":\"Motor\"}},\r\n     \r\n     {\"id\":1640,\"model\":\"Serie 3\",\r\n     \"brand\":{\"id\":17,\"brand\":\"BMW\"},\r\n     \"type\":{\"id\":1,\"type\":\"Car\"}},\r\n     \r\n     {\"id\":1649,\"model\":\"Serie 5\",\r\n     \"brand\":{\"id\":17,\"brand\":\"BMW\"},\r\n     \"type\":{\"id\":1,\"type\":\"Car\"}}]\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielbb%2Fvehicles-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabrielbb%2Fvehicles-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielbb%2Fvehicles-api/lists"}