A Grand Theft Auto–flavoured sandbox: browse Los Santos characters and vehicles, respray cars at a Pay-n-Spray, buy weapons from the catalogue, start missions with prerequisites, plan authenticated heists, run a slow (~2s) police chase that inflates your wanted level (0–5 stars) and bribe the LSPD to clear it. Cash starts at $5000 and 402 fires when you are broke.
The GTA (Grand Theft Auto) API is a Los Santos–style sandbox spanning characters, vehicles, an ammu-nation weapon catalogue, story missions with prerequisites, admin-only heist planning and a 0–5 star wanted system. Cash is the spine of it: respraying cars and buying weapons spend money, completing missions earns it, and every broke path answers 402 Payment Required — the status code production APIs reach for when a metered resource is exhausted.
Base URL: https://funapi.dev/api/gta/v1 · 17 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.
GET https://funapi.dev/api/gta/v1/characters — List characters (filter by city or affiliation). No token, no signup:
curl -i https://funapi.dev/api/gta/v1/charactersanswers 200 OK with:
{
"total": 10,
"data": [
{
"id": 1,
"name": "Tommy Vercetti",
"alias": "The Harwood Butcher",
"city": "Vice City",
"affiliation": "Vercetti Gang",
"status": "alive"
},
{
"id": 2,
"name": "CJ",
"alias": "Carl Johnson",
"city": "Los Santos",
"affiliation": "Grove Street Families",
"status": "alive"
},
{
"id": 3,
"name": "Niko Bellic",
"alias": "The Yugoslav",
"city": "Liberty City",
"affiliation": "Pegorino Family",
"status": "alive"
},
{
"id": 4,
"name": "Michael De Santa",
"alias": "Mikey",
"city": "Los Santos",
"affiliation": "Freelance",
"status": "alive"
},
{
"id": 5,
"name": "Trevor Philips",
"alias": "T",
"city": "Blaine County",
"affiliation": "Trevor Philips Enterprises",
"status": "alive"
},
{
"id": 6,
"name": "Franklin Clinton",
"alias": "Frank",
"city": "Los Santos",
"affiliation": "Freelance",
"status": "alive"(truncated — the full response comes back when you run it)
heroes and contacts
GET /gta/v1/characters — List characters (filter by city or affiliation) · Responds with 200 Link to this endpointGET /gta/v1/characters/{id} — Get one character · Responds with 200 404 Link to this endpointcars and Pay-n-Spray
GET /gta/v1/vehicles — List vehicles (filter by class) · Responds with 200 Link to this endpointGET /gta/v1/vehicles/{id} — Get one vehicle · Responds with 200 404 Link to this endpointPOST /gta/v1/vehicles/{id}/respray — Respray a vehicle at Pay-n-Spray — spends cash (402 when broke) (requires Bearer auth) · Responds with 200 402 404 422 Link to this endpointthe ammu-nation catalogue
GET /gta/v1/weapons — Browse the ammu-nation catalogue (filter by category) · Responds with 200 Link to this endpointPOST /gta/v1/weapons/{id}/buy — Buy a weapon — spends cash (402 when broke, 409 if already owned) (requires Bearer auth) · Responds with 200 404 409 402 Link to this endpointstory jobs with prereqs
GET /gta/v1/missions — List missions (filter by status or city) · Responds with 200 Link to this endpointGET /gta/v1/missions/{id} — Get one mission with its prereq · Responds with 200 404 Link to this endpointPOST /gta/v1/missions/{id}/start — Start a mission (409 if one is active, 422 if prereq not completed) (requires Bearer auth) · Responds with 200 404 409 422 Link to this endpointPOST /gta/v1/missions/{id}/complete — Complete the active mission — pays out the reward (requires Bearer auth) · Responds with 200 404 409 Link to this endpointPOST /gta/v1/heists — Plan a heist — choose an approach (admin only) (requires Bearer auth) · Responds with 201 422 Link to this endpointGET /gta/v1/heists/{id} — Get a planned heist · Responds with 200 404 Link to this endpointstars, bribes and police chases
GET /gta/v1/wanted — Current wanted level (0–5 stars) · Responds with 200 Link to this endpointPOST /gta/v1/wanted/increase — Commit a crime — inflates wanted level after a ~2s police chase (requires Bearer auth) · Responds with 200 409 Link to this endpointDELETE /gta/v1/wanted — Bribe the LSPD to clear wanted level — costs $1000/star (402 when broke) (requires Bearer auth) · Responds with 200 402 409 Link to this endpointin-game stations
GET /gta/v1/radio — List in-game radio stations · Responds with 200 Link to this endpointUnofficial and fan-made. The GTA API is a practice API that borrows a theme; it is not affiliated with, sponsored or endorsed by the owners of the names it references, which belong to them. Every record it returns is test data for exercising HTTP behaviour, not an authoritative source on the subject.
Last updated