/api/gundams

Get all gundams

Retrieve a paginated list of Gundam mobile suits from the database.

Endpoint: GET /api/gundams

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination
limit	integer	20	Number of results per page

URL

https://gundam-api.pages.dev/api/gundams?page=1&limit=10

Response Format

{
  "info": {
    "count": 150,
    "pages": 15,
    "next": "https://gundam-api.pages.dev/api/gundams?page=2",
    "prev": null
  },
  "results": [
    {
      "id": 1,
      "wikiName": "rx-78-2-gundam",
      "wikiUrl": "https://gundam.fandom.com/wiki/RX-78-2_Gundam",
      "gundamName": "RX-78-2 Gundam",
      "header": "Earth Federation prototype mobile suit",
      "details": "The RX-78-2 Gundam is a mobile suit...",
      "imgUrl": "https://example.com/gundam-image.jpg",
      "pilots": "Amuro Ray"
    }
  ]
}

Response Schema

Info Object

• count (integer): Total number of Gundams in the database
• pages (integer): Total number of pages
• next (string|null): URL for the next page, null if on last page
• prev (string|null): URL for the previous page, null if on first page

Gundam Object

• id (integer): Unique identifier for the Gundam
• wikiName (string): URL-friendly name used as primary key
• wikiUrl (string): Link to the Gundam’s wiki page
• gundamName (string): Display name of the Gundam
• header (string|null): Brief description or header text
• details (string|null): Detailed description of the Gundam
• imgUrl (string|null): URL to an image of the Gundam
• pilots (string|null): Names of known pilots

Status Codes

• 200 OK: Request successful
• 500 Internal Server Error: Server error occurred

Error Response

{
  "error": "Failed to fetch gundams"
}