> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mentionlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List the entity types a project can track

> Every type with its labels, and whether the organisation can create a project of it now.



## OpenAPI

````yaml https://api.mentionlab.io/api/docs-json get /api/entity-types
openapi: 3.0.0
info:
  title: MentionLab Public API v0.6.10-rc
  description: ''
  version: 0.6.10-rc
  contact: {}
servers:
  - url: https://api.mentionlab.io
security: []
tags: []
paths:
  /api/entity-types:
    get:
      tags:
        - Entity Types
      summary: List the entity types a project can track
      description: >-
        Every type with its labels, and whether the organisation can create a
        project of it now.
      operationId: EntityTypesController_list
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/EntityTypeResponse'
        '400':
          description: >-
            The request failed validation — the body, query or path parameters
            are malformed or out of range.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: The request is missing valid authentication credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '403':
          description: >-
            The authenticated principal lacks the required permission, or access
            to the requested organisation/project.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    EntityTypeResponse:
      type: object
      properties:
        key:
          type: string
          enum:
            - brands
            - brands_and_products
            - countries_cities
            - organisations
            - people
            - places
            - facilities
            - events
          description: Stable key, as a project's entityType stores it
          example: countries_cities
        displayName:
          type: string
          description: Label for the type picker
          example: Countries & Cities
        status:
          type: string
          enum:
            - available
            - coming_soon
          description: 'available: the organisation can create a project of this type now'
          example: available
        mentionVocab:
          type: object
          additionalProperties:
            type: string
          description: Label of each mention stance, worded for this type
          example:
            chosen: Top pick
            mentioned: Favorably positioned
            named: Named
            negative_mentioned: Unfavorably positioned
            negative_named: Listed among the weaker options
        levelVocab:
          nullable: true
          description: >-
            Tiers an entity of this type is tagged with (an entity's level),
            top-down; null when the type has none
          example:
            - region
            - country
            - city
          type: array
          items:
            type: string
      required:
        - key
        - displayName
        - status
        - mentionVocab
        - levelVocab
    ApiErrorResponse:
      type: object
      properties:
        statusCode:
          type: number
          description: HTTP status code of the error.
          example: 400
        message:
          type: string
          description: >-
            Human-readable description of the error. Validation failures return
            an array of per-field validation errors instead of a single string.
          example: Validation failed
        error:
          type: string
          description: Short name of the HTTP error.
          example: Bad Request
      required:
        - statusCode

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.