Skip to content

Public API Endpoints

Oleksii Vasyliev edited this page Jun 26, 2026 · 2 revisions

Endpoint Index

Route HTTP Method Content-Type Description
/api/manifest.json GET application/json Fetches the global tracking catalog of all collectible minifigure series.
/api/collections/[slug].json GET application/json Fetches the individual minifigure list and pre-calculated lookup arrays for a specific series.

Endpoint Details

Global Sync Manifest

Returns a centralized index mapping each supported collectible series to its compiled dataset location, along with an integrity hash signature. This payload is updated whenever underlying source collection files are modified.

  • Path: /api/manifest.json
  • Method: GET

Response Object Model

Property Type Description
updatedAt string The build date formatted as an ISO timestamp stub (YYYY-MM-DD).
seriesManifest object Dictionary key-mapped by unique collection identifiers (series slug strings).
seriesManifest.[series-id] object Routing metadata containing location and integrity hashes for that specific series.
seriesManifest.[series-id].endpoint string Absolute root-relative pathname to the specific dataset file.
seriesManifest.[series-id].hash string A cryptographic SHA-256 checksum string of the raw backend file to monitor data updates.

Sample JSON Payload

{
  "updatedAt": "2026-06-26",
  "seriesManifest": {
    "series-29": {
      "endpoint": "/api/collections/series-29.json",
      "hash": "074558e0a35e2ee6c2b1aef59c98ef7ab68d2984ea0c2bfde10906ae015c9281"
    },
    "f1-race-cars": {
      "endpoint": "/api/collections/f1-race-cars.json",
      "hash": "f623bb6e949ac1a44efdd580e0c83a54b9d0e2e50cfcd5bb0c4109db018ef296"
    }
  }
}

Collection Series Dataset

Returns the complete array of minifigures linked to a chosen series, containing metadata descriptors, local asset pathways, and pre-computed search arrays to speed up barcode checks.

  • Path: /api/collections/[slug].json
  • Method: GET
  • Path Parameters:
    • slug (string): The series slug lookup handle matching a manifest key entry (e.g., series-28, spiderman-spiderverse).

Response Object Model (Array of Figures)

Property Type Description
slug string Unique identification slug string designated to the individual character item.
name string Official marketing or collection identity name assigned to the figure.
imagePath string Root-relative file directory location pointing to the raw illustration asset.
identifiers array[object] Structured array containing the known box bottom manufacturing code variants.
identifiers[].code string The base 7-digit item packaging identifier sequence.
identifiers[].factory string Optional. Single-character manufacturing location mark (e.g., S, R).
identifiers[].year string Optional. Single-digit print tracking stamp designating factory batch year.
series string System group slug string duplicated from parent mapping configurations.
displayName string Human-readable title of the complete collectible series.
releaseYear integer Calendar year index representing the series commercial launch window.
searchKeys array[string] Pre-computed index keys. Flattens identifier combinations to speed up lookup operations. Contains both strict variants (code_factory_year) and fallback parameters (code).

Sample JSON Payload (Fragment of f1-race-cars.json)

[
  {
    "slug": "f1_ferrari",
    "name": "Ferrari",
    "imagePath": "/assets/minifigures/f1-race-cars/ferrari.jpg",
    "identifiers": [
      { "code": "6538425", "factory": "R", "year": "5" },
      { "code": "6536841", "factory": "S", "year": "5" },
      { "code": "6538305", "factory": "S", "year": "5" }
    ],
    "series": "f1-race-cars",
    "displayName": "F1 Race Cars",
    "releaseYear": 2025,
    "searchKeys": [
      "6538425_R_5", "6538425",
      "6536841_S_5", "6536841",
      "6538305_S_5", "6538305"
    ]
  }
]