/api/gundams/{ids|wikiNames}

Get specific gundams by ID or wikiName

Retrieve one or more Gundam mobile suits from the database by their numeric IDs or by their wikiName slugs.

Endpoint: GET /api/gundams/{ids|wikiNames}

Path Parameters

Parameter	Type	Description
params	string	Single numeric ID or single wikiName, or a comma-separated list of either (no mixing types)

URL Examples

Single Gundam by ID:

https://gundam-api.pages.dev/api/gundams/1

Multiple Gundams by ID:

https://gundam-api.pages.dev/api/gundams/1,49,123

Single Gundam by wikiName:

https://gundam-api.pages.dev/api/gundams/rx-78-2-gundam

Multiple Gundams by wikiName:

https://gundam-api.pages.dev/api/gundams/rx-78-2-gundam,strike-freedom-gundam

Mixed types (not allowed, returns 400):

https://gundam-api.pages.dev/api/gundams/1,rx-78-2-gundam

Response Format

Single Gundam Response:

{
  "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"
}

Multiple Gundams Response:

[
  {
    "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"
  },
  {
    "id": 49,
    "wikiName": "strike-freedom-gundam",
    "wikiUrl": "https://gundam.fandom.com/wiki/ZGMF-X20A_Strike_Freedom_Gundam",
    "gundamName": "ZGMF-X20A Strike Freedom Gundam",
    "header": "ZAFT advanced mobile suit",
    "details": "The Strike Freedom Gundam is...",
    "imgUrl": "https://example.com/strike-freedom-image.jpg",
    "pilots": "Kira Yamato"
  }
]

Response Schema

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
• 400 Bad Request: Missing parameters or mixed parameter types
• 404 Not Found: No Gundams found with the provided value(s)
• 500 Internal Server Error: Server error occurred

Error Responses

Missing parameters:

{
  "error": "No parameters provided"
}

Mixed types (IDs and wikiNames together):

{
  "error": "Cannot mix id and wikiName parameters. Use either all numeric IDs or all wikiNames."
}

Not Found (IDs):

{
  "error": "No Gundams found with the provided ID(s)"
}

Not Found (wikiNames):

{
  "error": "No Gundams found with the provided wikiName(s)"
}

Server Error:

{
  "error": "Failed to fetch gundam(s)"
}

Notes

• Pass either numeric IDs or wikiName slugs; do not mix types in a single request
• For single parameter requests, the response is a single Gundam object
• For multiple parameters, the response is an array of Gundam objects
• For lists, use comma-separated values without spaces