> ## 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 Model Detail By Internal Name

> Retrieve the full definition and metadata of a content model by its internal name. Use this when you know the model’s identifier and you need to access field definitions and other properties associated with the content model using this endpoint.

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/by_internal_name/{modelInternalName}
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/by_internal_name/{modelInternalName}:
    get:
      summary: Fetch Content Model by Internal Name
      description: >-
        Retrieve the full definition and metadata of a content model by its
        internal name. Use this when you know the model’s identifier and you
        need to access field definitions and other properties associated with
        the content model using this endpoint.
      parameters:
        - $ref: '#/components/parameters/TenantIdHeader'
        - $ref: '#/components/parameters/WorkspaceIdHeader'
        - $ref: '#/components/parameters/EnvironmentIdHeader'
        - name: modelInternalName
          in: path
          required: true
          schema:
            type: string
          description: The unique ID of the record.
        - $ref: '#/components/parameters/LocaleQryPrm'
      responses:
        '200':
          description: Successful response with the content model definition and metadata.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: success
                    description: Request outcome indicator.
                  Data:
                    type: object
                    properties:
                      record:
                        $ref: '#/components/schemas/Model'
                        description: The content model object.
                      _meta_:
                        type: object
                        properties:
                          tenant_id:
                            type: string
                            description: Your tenant identifier.
                          workspace_id:
                            type: string
                            description: Your workspace identifier.
                          content_model_id:
                            type: string
                            description: Your content model identifier
        '400':
          description: >-
            Bad Request – invalid `modelInternalName` or missing required
            parameter.
          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

````