# Categories

Discover place and world categories (e.g., art-gallery, social, game). Categories help users find content based on their interests.

## List all categories

> Retrieve all active categories with item counts.\
> \
> \*\*Categories help users discover:\*\*\
> \- Art galleries and museums\
> \- Social hangout spots\
> \- Games and interactive experiences\
> \- Event venues\
> \- Shopping and commerce\
> \- Educational content\
> \
> \*\*Counts:\*\* Each category includes the number of places/worlds tagged with it.\
> \
> \*\*Filtering:\*\* Use the \`target\` parameter to get counts for only places, only worlds, or both.<br>

```json
{"openapi":"3.0.3","info":{"title":"Decentraland Places API","version":"1.0.0"},"tags":[{"name":"Categories","description":"Discover place and world categories (e.g., art-gallery, social, game).\nCategories help users find content based on their interests.\n"}],"servers":[{"url":"https://places.decentraland.org/api","description":"Production server"},{"url":"http://localhost:4000/api","description":"Development server"}],"security":[],"paths":{"/categories":{"get":{"tags":["Categories"],"summary":"List all categories","description":"Retrieve all active categories with item counts.\n\n**Categories help users discover:**\n- Art galleries and museums\n- Social hangout spots\n- Games and interactive experiences\n- Event venues\n- Shopping and commerce\n- Educational content\n\n**Counts:** Each category includes the number of places/worlds tagged with it.\n\n**Filtering:** Use the `target` parameter to get counts for only places, only worlds, or both.\n","operationId":"getCategories","parameters":[{"name":"target","in":"query","description":"Filter category counts by type:\n- `all`: Count both places and worlds (default)\n- `places`: Count only Genesis City places\n- `worlds`: Count only Decentraland Worlds\n","required":false,"schema":{"type":"string","enum":["all","places","worlds"],"default":"all"}}],"responses":{"200":{"description":"Categories retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","description":"A content category for organizing places and worlds","properties":{"name":{"type":"string","description":"Unique category identifier (slug)"},"active":{"type":"boolean","description":"Whether this category is currently active/visible"},"count":{"type":"integer","minimum":0,"description":"Number of places/worlds in this category"},"i18n":{"type":"object","description":"Internationalized display labels","properties":{"en":{"type":"string","description":"English display name"}}}}}}}}}}},"400":{"description":"Bad request - Invalid parameters or malformed request","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","properties":{"ok":{"type":"boolean","description":"Always false for errors"},"error":{"type":"string","description":"Human-readable error message"}}}}}},"500":{"description":"Internal server error - Something went wrong on the server","content":{"application/json":{"schema":{"type":"object","description":"Standard error response","properties":{"ok":{"type":"boolean","description":"Always false for errors"},"error":{"type":"string","description":"Human-readable error message"}}}}}}}}}}}
```