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

# Get Models List

> Retrieve a complete list of every content model defined in your workspace. Content models define the structure and fields of your content types (e.g. blog posts, products, landing pages). Use the optional `locale` parameter to fetch localized model definitions.

Before calling this endpoint, make sure you’ve generated an API token and picked the correct domain. See [Authentication & Base URLs](/api-reference/authbaseurl).


## OpenAPI

````yaml GET /content/v2/content-models
openapi: 3.1.0
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://apis.experro.app
    description: Admin Server
  - url: https://{base-address}
    description: Custom Server
    variables:
      base-address:
        default: ''
        description: Enter your custom domain or server address.
security:
  - bearerAuth: []
paths:
  /content/v2/content-models:
    get:
      summary: List All Content Models
      description: >-
        Retrieve a complete list of every content model defined in your
        workspace. Content models define the structure and fields of your
        content types (e.g. blog posts, products, landing pages). Use the
        optional `locale` parameter to fetch localized model definitions.
      parameters:
        - $ref: '#/components/parameters/TenantIdHeader'
        - $ref: '#/components/parameters/WorkspaceIdHeader'
        - $ref: '#/components/parameters/EnvironmentIdHeader'
        - $ref: '#/components/parameters/LocaleQryPrm'
      responses:
        '200':
          description: Successful response containing all content models.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: success
                    description: Overall status of the request.
                  Data:
                    type: object
                    properties:
                      records:
                        type: array
                        description: Array of content model definitions.
                        items:
                          $ref: '#/components/schemas/Model'
                      _meta_:
                        type: object
                        description: Request metadata.
                        properties:
                          tenant_id:
                            type: string
                            description: Identifier of the tenant.
                          workspace_id:
                            type: string
                            description: Identifier of the workspace.
                          content_model_id:
                            type: string
                            description: Identifier of the content model.
        '400':
          description: Bad Request – e.g. invalid `locale` value.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: failure
                  Data:
                    $ref: '#/components/schemas/Error404'
        '401':
          description: Unauthorized – Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: failure
                  Data:
                    $ref: '#/components/schemas/Error401'
        '500':
          description: Internal Server Error – an unexpected error on the server.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: failure
                  Data:
                    $ref: '#/components/schemas/Error500'
      servers:
        - url: https://apis.experro.app
          description: Admin Server
components:
  parameters:
    TenantIdHeader:
      name: x-tenant-id
      in: header
      required: true
      schema:
        type: string
      description: Identifier for the tenant. Ensures data isolation per tenant.
    WorkspaceIdHeader:
      name: x-workspace-id
      in: header
      required: true
      schema:
        type: string
      description: >-
        Workspace identifier within the tenant. Scopes resources to a specific
        workspace.
    EnvironmentIdHeader:
      name: x-environment-id
      in: header
      required: true
      schema:
        type: string
        example: PRODUCTION-15a0f8c2-a5e8-4e40-ae74-cb1389d22f45-w49jkngj
      description: >-
        Unique identifier of the target environment. Used to scope the API call
        to a specific deployment environment.
    LocaleQryPrm:
      name: locale
      in: query
      description: Specifies the language or region for the response data
      required: true
      schema:
        type: string
  schemas:
    Model:
      type: object
      description: >-
        Definition of a content model, including its fields, behavior flags, and
        metadata.
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the content model.
        internal_name:
          type: string
          description: Internal model name.
        name:
          type: string
          description: Model name.
        type:
          type: string
          description: Category of model.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the model was first created.
        template:
          type:
            - string
            - 'null'
          description: Template identifier.
        act_as_web_page:
          type: boolean
          description: Flag indicating if instances render as standalone web pages.
        is_localization_enabled:
          type: boolean
          description: Whether this model supports multiple locales.
        group_id:
          type: string
          description: Optional grouping identifier for model organization.
        description:
          type:
            - string
            - 'null'
          description: Optional description explaining the model’s purpose.
        is_versionable:
          type: boolean
          description: Flag to allow multiple versions per record.
        fields:
          type: array
          description: List of field definitions in this model.
          items:
            type: object
            properties:
              component_id:
                type:
                  - string
                  - 'null'
                description: UUID of the UI component.
              destination_relation_field_id:
                type:
                  - string
                  - 'null'
                description: UUID of a related model field, if any.
              field_properties:
                type: object
                description: Additional metadata specific to this field.
                additionalProperties: true
              is_required:
                type: boolean
              relation_type:
                type:
                  - string
                  - 'null'
                description: Type of relationship.
              position:
                type: integer
                description: Zero-based index for ordering fields.
              is_removable:
                type: boolean
                description: If `true`, users may delete this field from a record.
              is_editable:
                type: boolean
                description: If `false`, the UI will render this field read-only.
    Error404:
      type: object
      properties:
        Status:
          type: string
          example: failure
        Error:
          type: object
          properties:
            message:
              type: string
            name:
              type: string
            code:
              type: string
          required:
            - message
            - name
      required:
        - Status
        - Error
    Error401:
      type: object
      properties:
        Status:
          type: string
          example: failure
        Error:
          type: object
          properties:
            message:
              type: string
            name:
              type: string
            code:
              type: string
          required:
            - message
            - name
      required:
        - Status
        - Error
    Error500:
      type: object
      properties:
        Status:
          type: string
          example: failure
        Error:
          type: object
          properties:
            message:
              type: string
            name:
              type: string
            code:
              type: string
          required:
            - message
            - name
      required:
        - Status
        - Error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````