{"openapi":"3.1.0","info":{"title":"Minecraft API","version":"1.1","description":"Read-only Minecraft data API covering blocks, items, mobs, structures, advancements and biomes up to Minecraft 1.19."},"servers":[{"url":"http://localhost:3000"}],"paths":{"/api":{"get":{"tags":["Meta"],"summary":"API health check","description":"Returns a welcome message used to verify that the API is reachable.","operationId":"api-root","responses":{"200":{"description":"Simple JSON response confirming the API is online."}}}},"/api/advancements":{"get":{"tags":["Advancements"],"summary":"List all advancements","description":"Returns every advancements entry enriched with a direct image URL.","operationId":"advancements-list","responses":{"200":{"description":"Array of advancements objects including an image field."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/advancements"}},"/api/advancements/count":{"get":{"tags":["Advancements"],"summary":"Count advancements","description":"Returns the total number of advancements stored in the dataset.","operationId":"advancements-count","responses":{"200":{"description":"Numeric count of available entries."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/advancements/count"}},"/api/advancements/keys":{"get":{"tags":["Advancements"],"summary":"List advancements keys","description":"Returns the top-level keys available in the advancements payloads.","operationId":"advancements-keys","responses":{"200":{"description":"Array of property names available for the entity."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/advancements/keys"}},"/api/advancements/{id}":{"get":{"tags":["Advancements"],"summary":"Get one advancement","description":"Returns a single advancement by its unique id.","operationId":"advancements-item","parameters":[{"name":"id","in":"path","required":true,"description":"Unique advancement identifier.","schema":{"type":"string","example":"adventure/root"}}],"responses":{"200":{"description":"Single entity object."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/advancements/adventure/root"}},"/api/advancements/{id}/image":{"get":{"tags":["Advancements"],"summary":"Get advancement image","description":"Returns the public sprite or artwork for a specific advancement.","operationId":"advancements-image","parameters":[{"name":"id","in":"path","required":true,"description":"Unique advancement identifier.","schema":{"type":"string","example":"adventure/root"}}],"responses":{"200":{"description":"Binary image response."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/advancements/adventure/root/image"}},"/api/advancements/all/{key}":{"get":{"tags":["Advancements"],"summary":"Project one advancement field","description":"Returns all entries reduced to id plus the requested field when the key exists.","operationId":"advancements-all-key","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name to project.","schema":{"type":"string","example":"interface"}}],"responses":{"200":{"description":"Array of reduced objects with id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/advancements/all/interface"}},"/api/advancements/all/{key}/{value}":{"get":{"tags":["Advancements"],"summary":"Filter advancements by field","description":"Filters the dataset by strict string equality on the provided key and value.","operationId":"advancements-all-key-value","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name used for filtering.","schema":{"type":"string","example":"interface"}},{"name":"value","in":"path","required":true,"description":"Expected string representation of the field value.","schema":{"type":"string","example":"Adventure"}}],"responses":{"200":{"description":"Array of entities matching the requested field value."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/advancements/all/interface/Adventure"}},"/api/advancements/{id}/{key}":{"get":{"tags":["Advancements"],"summary":"Get one advancement field","description":"Returns only one field from the selected advancement entry.","operationId":"advancements-item-key","parameters":[{"name":"id","in":"path","required":true,"description":"Unique advancement identifier.","schema":{"type":"string","example":"adventure/root"}},{"name":"key","in":"path","required":true,"description":"Top-level field name to extract from the entity.","schema":{"type":"string","example":"interface"}}],"responses":{"200":{"description":"Object containing the id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/advancements/adventure/root/interface"}},"/api/biomes":{"get":{"tags":["Biomes"],"summary":"List all biomes","description":"Returns every biomes entry enriched with a direct image URL.","operationId":"biomes-list","responses":{"200":{"description":"Array of biomes objects including an image field."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/biomes"}},"/api/biomes/count":{"get":{"tags":["Biomes"],"summary":"Count biomes","description":"Returns the total number of biomes stored in the dataset.","operationId":"biomes-count","responses":{"200":{"description":"Numeric count of available entries."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/biomes/count"}},"/api/biomes/keys":{"get":{"tags":["Biomes"],"summary":"List biomes keys","description":"Returns the top-level keys available in the biomes payloads.","operationId":"biomes-keys","responses":{"200":{"description":"Array of property names available for the entity."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/biomes/keys"}},"/api/biomes/{id}":{"get":{"tags":["Biomes"],"summary":"Get one biome","description":"Returns a single biome by its unique id.","operationId":"biomes-item","parameters":[{"name":"id","in":"path","required":true,"description":"Unique biome identifier.","schema":{"type":"string","example":"plains"}}],"responses":{"200":{"description":"Single entity object."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/biomes/plains"}},"/api/biomes/{id}/image":{"get":{"tags":["Biomes"],"summary":"Get biome image","description":"Returns the public sprite or artwork for a specific biome.","operationId":"biomes-image","parameters":[{"name":"id","in":"path","required":true,"description":"Unique biome identifier.","schema":{"type":"string","example":"plains"}}],"responses":{"200":{"description":"Binary image response."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/biomes/plains/image"}},"/api/biomes/all/{key}":{"get":{"tags":["Biomes"],"summary":"Project one biome field","description":"Returns all entries reduced to id plus the requested field when the key exists.","operationId":"biomes-all-key","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name to project.","schema":{"type":"string","example":"name"}}],"responses":{"200":{"description":"Array of reduced objects with id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/biomes/all/name"}},"/api/biomes/all/{key}/{value}":{"get":{"tags":["Biomes"],"summary":"Filter biomes by field","description":"Filters the dataset by strict string equality on the provided key and value.","operationId":"biomes-all-key-value","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name used for filtering.","schema":{"type":"string","example":"name"}},{"name":"value","in":"path","required":true,"description":"Expected string representation of the field value.","schema":{"type":"string","example":"Plains"}}],"responses":{"200":{"description":"Array of entities matching the requested field value."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/biomes/all/name/Plains"}},"/api/biomes/{id}/{key}":{"get":{"tags":["Biomes"],"summary":"Get one biome field","description":"Returns only one field from the selected biome entry.","operationId":"biomes-item-key","parameters":[{"name":"id","in":"path","required":true,"description":"Unique biome identifier.","schema":{"type":"string","example":"plains"}},{"name":"key","in":"path","required":true,"description":"Top-level field name to extract from the entity.","schema":{"type":"string","example":"name"}}],"responses":{"200":{"description":"Object containing the id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/biomes/plains/name"}},"/api/blocks":{"get":{"tags":["Blocks"],"summary":"List all blocks","description":"Returns every blocks entry enriched with a direct image URL.","operationId":"blocks-list","responses":{"200":{"description":"Array of blocks objects including an image field."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/blocks"}},"/api/blocks/count":{"get":{"tags":["Blocks"],"summary":"Count blocks","description":"Returns the total number of blocks stored in the dataset.","operationId":"blocks-count","responses":{"200":{"description":"Numeric count of available entries."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/blocks/count"}},"/api/blocks/keys":{"get":{"tags":["Blocks"],"summary":"List blocks keys","description":"Returns the top-level keys available in the blocks payloads.","operationId":"blocks-keys","responses":{"200":{"description":"Array of property names available for the entity."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/blocks/keys"}},"/api/blocks/{id}":{"get":{"tags":["Blocks"],"summary":"Get one block","description":"Returns a single block by its unique id.","operationId":"blocks-item","parameters":[{"name":"id","in":"path","required":true,"description":"Unique block identifier.","schema":{"type":"string","example":"stone"}}],"responses":{"200":{"description":"Single entity object."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/blocks/stone"}},"/api/blocks/{id}/image":{"get":{"tags":["Blocks"],"summary":"Get block image","description":"Returns the public sprite or artwork for a specific block.","operationId":"blocks-image","parameters":[{"name":"id","in":"path","required":true,"description":"Unique block identifier.","schema":{"type":"string","example":"stone"}}],"responses":{"200":{"description":"Binary image response."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/blocks/stone/image"}},"/api/blocks/all/{key}":{"get":{"tags":["Blocks"],"summary":"Project one block field","description":"Returns all entries reduced to id plus the requested field when the key exists.","operationId":"blocks-all-key","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name to project.","schema":{"type":"string","example":"name"}}],"responses":{"200":{"description":"Array of reduced objects with id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/blocks/all/name"}},"/api/blocks/all/{key}/{value}":{"get":{"tags":["Blocks"],"summary":"Filter blocks by field","description":"Filters the dataset by strict string equality on the provided key and value.","operationId":"blocks-all-key-value","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name used for filtering.","schema":{"type":"string","example":"name"}},{"name":"value","in":"path","required":true,"description":"Expected string representation of the field value.","schema":{"type":"string","example":"Stone"}}],"responses":{"200":{"description":"Array of entities matching the requested field value."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/blocks/all/name/Stone"}},"/api/blocks/{id}/{key}":{"get":{"tags":["Blocks"],"summary":"Get one block field","description":"Returns only one field from the selected block entry.","operationId":"blocks-item-key","parameters":[{"name":"id","in":"path","required":true,"description":"Unique block identifier.","schema":{"type":"string","example":"stone"}},{"name":"key","in":"path","required":true,"description":"Top-level field name to extract from the entity.","schema":{"type":"string","example":"name"}}],"responses":{"200":{"description":"Object containing the id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/blocks/stone/name"}},"/api/items":{"get":{"tags":["Items"],"summary":"List all items","description":"Returns every items entry enriched with a direct image URL.","operationId":"items-list","responses":{"200":{"description":"Array of items objects including an image field."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/items"}},"/api/items/count":{"get":{"tags":["Items"],"summary":"Count items","description":"Returns the total number of items stored in the dataset.","operationId":"items-count","responses":{"200":{"description":"Numeric count of available entries."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/items/count"}},"/api/items/keys":{"get":{"tags":["Items"],"summary":"List items keys","description":"Returns the top-level keys available in the items payloads.","operationId":"items-keys","responses":{"200":{"description":"Array of property names available for the entity."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/items/keys"}},"/api/items/{id}":{"get":{"tags":["Items"],"summary":"Get one item","description":"Returns a single item by its unique id.","operationId":"items-item","parameters":[{"name":"id","in":"path","required":true,"description":"Unique item identifier.","schema":{"type":"string","example":"diamond_sword"}}],"responses":{"200":{"description":"Single entity object."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/items/diamond_sword"}},"/api/items/{id}/image":{"get":{"tags":["Items"],"summary":"Get item image","description":"Returns the public sprite or artwork for a specific item.","operationId":"items-image","parameters":[{"name":"id","in":"path","required":true,"description":"Unique item identifier.","schema":{"type":"string","example":"diamond_sword"}}],"responses":{"200":{"description":"Binary image response."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/items/diamond_sword/image"}},"/api/items/all/{key}":{"get":{"tags":["Items"],"summary":"Project one item field","description":"Returns all entries reduced to id plus the requested field when the key exists.","operationId":"items-all-key","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name to project.","schema":{"type":"string","example":"name"}}],"responses":{"200":{"description":"Array of reduced objects with id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/items/all/name"}},"/api/items/all/{key}/{value}":{"get":{"tags":["Items"],"summary":"Filter items by field","description":"Filters the dataset by strict string equality on the provided key and value.","operationId":"items-all-key-value","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name used for filtering.","schema":{"type":"string","example":"name"}},{"name":"value","in":"path","required":true,"description":"Expected string representation of the field value.","schema":{"type":"string","example":"Diamond Sword"}}],"responses":{"200":{"description":"Array of entities matching the requested field value."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/items/all/name/Diamond Sword"}},"/api/items/{id}/{key}":{"get":{"tags":["Items"],"summary":"Get one item field","description":"Returns only one field from the selected item entry.","operationId":"items-item-key","parameters":[{"name":"id","in":"path","required":true,"description":"Unique item identifier.","schema":{"type":"string","example":"diamond_sword"}},{"name":"key","in":"path","required":true,"description":"Top-level field name to extract from the entity.","schema":{"type":"string","example":"name"}}],"responses":{"200":{"description":"Object containing the id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/items/diamond_sword/name"}},"/api/mobs":{"get":{"tags":["Mobs"],"summary":"List all mobs","description":"Returns every mobs entry enriched with a direct image URL.","operationId":"mobs-list","responses":{"200":{"description":"Array of mobs objects including an image field."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/mobs"}},"/api/mobs/count":{"get":{"tags":["Mobs"],"summary":"Count mobs","description":"Returns the total number of mobs stored in the dataset.","operationId":"mobs-count","responses":{"200":{"description":"Numeric count of available entries."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/mobs/count"}},"/api/mobs/keys":{"get":{"tags":["Mobs"],"summary":"List mobs keys","description":"Returns the top-level keys available in the mobs payloads.","operationId":"mobs-keys","responses":{"200":{"description":"Array of property names available for the entity."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/mobs/keys"}},"/api/mobs/{id}":{"get":{"tags":["Mobs"],"summary":"Get one mob","description":"Returns a single mob by its unique id.","operationId":"mobs-item","parameters":[{"name":"id","in":"path","required":true,"description":"Unique mob identifier.","schema":{"type":"string","example":"creeper"}}],"responses":{"200":{"description":"Single entity object."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/mobs/creeper"}},"/api/mobs/{id}/image":{"get":{"tags":["Mobs"],"summary":"Get mob image","description":"Returns the public sprite or artwork for a specific mob.","operationId":"mobs-image","parameters":[{"name":"id","in":"path","required":true,"description":"Unique mob identifier.","schema":{"type":"string","example":"creeper"}}],"responses":{"200":{"description":"Binary image response."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/mobs/creeper/image"}},"/api/mobs/all/{key}":{"get":{"tags":["Mobs"],"summary":"Project one mob field","description":"Returns all entries reduced to id plus the requested field when the key exists.","operationId":"mobs-all-key","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name to project.","schema":{"type":"string","example":"behavior"}}],"responses":{"200":{"description":"Array of reduced objects with id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/mobs/all/behavior"}},"/api/mobs/all/{key}/{value}":{"get":{"tags":["Mobs"],"summary":"Filter mobs by field","description":"Filters the dataset by strict string equality on the provided key and value.","operationId":"mobs-all-key-value","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name used for filtering.","schema":{"type":"string","example":"behavior"}},{"name":"value","in":"path","required":true,"description":"Expected string representation of the field value.","schema":{"type":"string","example":"Hostile"}}],"responses":{"200":{"description":"Array of entities matching the requested field value."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/mobs/all/behavior/Hostile"}},"/api/mobs/{id}/{key}":{"get":{"tags":["Mobs"],"summary":"Get one mob field","description":"Returns only one field from the selected mob entry.","operationId":"mobs-item-key","parameters":[{"name":"id","in":"path","required":true,"description":"Unique mob identifier.","schema":{"type":"string","example":"creeper"}},{"name":"key","in":"path","required":true,"description":"Top-level field name to extract from the entity.","schema":{"type":"string","example":"behavior"}}],"responses":{"200":{"description":"Object containing the id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/mobs/creeper/behavior"}},"/api/structures":{"get":{"tags":["Structures"],"summary":"List all structures","description":"Returns every structures entry enriched with a direct image URL.","operationId":"structures-list","responses":{"200":{"description":"Array of structures objects including an image field."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/structures"}},"/api/structures/count":{"get":{"tags":["Structures"],"summary":"Count structures","description":"Returns the total number of structures stored in the dataset.","operationId":"structures-count","responses":{"200":{"description":"Numeric count of available entries."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/structures/count"}},"/api/structures/keys":{"get":{"tags":["Structures"],"summary":"List structures keys","description":"Returns the top-level keys available in the structures payloads.","operationId":"structures-keys","responses":{"200":{"description":"Array of property names available for the entity."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/structures/keys"}},"/api/structures/{id}":{"get":{"tags":["Structures"],"summary":"Get one structure","description":"Returns a single structure by its unique id.","operationId":"structures-item","parameters":[{"name":"id","in":"path","required":true,"description":"Unique structure identifier.","schema":{"type":"string","example":"village"}}],"responses":{"200":{"description":"Single entity object."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/structures/village"}},"/api/structures/{id}/image":{"get":{"tags":["Structures"],"summary":"Get structure image","description":"Returns the public sprite or artwork for a specific structure.","operationId":"structures-image","parameters":[{"name":"id","in":"path","required":true,"description":"Unique structure identifier.","schema":{"type":"string","example":"village"}}],"responses":{"200":{"description":"Binary image response."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/structures/village/image"}},"/api/structures/all/{key}":{"get":{"tags":["Structures"],"summary":"Project one structure field","description":"Returns all entries reduced to id plus the requested field when the key exists.","operationId":"structures-all-key","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name to project.","schema":{"type":"string","example":"name"}}],"responses":{"200":{"description":"Array of reduced objects with id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/structures/all/name"}},"/api/structures/all/{key}/{value}":{"get":{"tags":["Structures"],"summary":"Filter structures by field","description":"Filters the dataset by strict string equality on the provided key and value.","operationId":"structures-all-key-value","parameters":[{"name":"key","in":"path","required":true,"description":"Top-level field name used for filtering.","schema":{"type":"string","example":"name"}},{"name":"value","in":"path","required":true,"description":"Expected string representation of the field value.","schema":{"type":"string","example":"Village"}}],"responses":{"200":{"description":"Array of entities matching the requested field value."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/structures/all/name/Village"}},"/api/structures/{id}/{key}":{"get":{"tags":["Structures"],"summary":"Get one structure field","description":"Returns only one field from the selected structure entry.","operationId":"structures-item-key","parameters":[{"name":"id","in":"path","required":true,"description":"Unique structure identifier.","schema":{"type":"string","example":"village"}},{"name":"key","in":"path","required":true,"description":"Top-level field name to extract from the entity.","schema":{"type":"string","example":"name"}}],"responses":{"200":{"description":"Object containing the id and the requested key."},"400":{"description":"Bad request caused by an invalid key, parameter count or unsupported input."},"404":{"description":"Entity type, entity id or image resource was not found."}},"x-examplePath":"/api/structures/village/name"}}}}