GTA API — free mock REST API for testing

A Grand Theft Auto–flavoured sandbox: browse Los Santos characters and vehicles, respray cars at a Pay-n-Spray, buy weapons from the catologue, 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 catologue, 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.

What you can practise here

• Buy a weapon with the admin token, then buy it again and read the 409 "already owned" conflict.
• Respray a vehicle while your wallet is short and confirm the 402, then complete a mission to top up and retry.
• Start a mission whose prerequisite is unmet and compare the 422 with a 409 from starting a second mission while one is active.
• POST /wanted/increase twice for the ~2s police chase, then DELETE /wanted and check the bribe deducts $1000 per star.
• Plan a heist with an approach outside stealth/loud/subtle and read the 422.

characters

heroes and contacts

• GET /gta/v1/characters — List characters (filter by city or affiliation)
• GET /gta/v1/characters/{id} — Get one character

vehicles

cars and Pay-n-Spray

• GET /gta/v1/vehicles — List vehicles (filter by class)
• GET /gta/v1/vehicles/{id} — Get one vehicle
• POST /gta/v1/vehicles/{id}/respray — Respray a vehicle at Pay-n-Spray — spends cash (402 when broke) (requires Bearer auth)

weapons

the ammu-nation catologue

• GET /gta/v1/weapons — Browse the ammu-nation catologue (filter by category)
• POST /gta/v1/weapons/{id}/buy — Buy a weapon — spends cash (402 when broke, 409 if already owned) (requires Bearer auth)

missions

story jobs with prereqs

• GET /gta/v1/missions — List missions (filter by status or city)
• GET /gta/v1/missions/{id} — Get one mission with its prereq
• POST /gta/v1/missions/{id}/start — Start a mission (409 if one is active, 422 if prereq not completed) (requires Bearer auth)
• POST /gta/v1/missions/{id}/complete — Complete the active mission — pays out the reward (requires Bearer auth)
• POST /gta/v1/heists — Plan a heist — choose an approach (admin only) (requires Bearer auth)
• GET /gta/v1/heists/{id} — Get a planned heist

wanted

stars, bribes and police chases

• GET /gta/v1/wanted — Current wanted level (0–5 stars)
• POST /gta/v1/wanted/increase — Commit a crime — inflates wanted level after a ~2s police chase (requires Bearer auth)
• DELETE /gta/v1/wanted — Bribe the LSPD to clear wanted level — costs $1000/star (402 when broke) (requires Bearer auth)

radio

in-game stations

• GET /gta/v1/radio — List in-game radio stations

Related APIs

• Friends API — Characters, episodes & quotes from the coffee-house gang.
• Movies API — QA-themed cinema. Sort, filter, rate.
• Harry Potter API — Houses, students & spells from a magic school.
• Star Wars API — Characters, planets & starships from a galaxy far away.

All 39 mock REST APIs