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

# Get a specific materialization



## OpenAPI

````yaml /dataplane-public-api-doc.yaml get /environments/{environmentName}/packages/{packageName}/materializations/{materializationId}
openapi: 3.1.0
info:
  title: Malloy Publisher - Semantic Model Serving API
  description: >
    The Malloy Publisher - Semantic Model Serving API provides comprehensive
    access to Malloy packages and their associated resources.

    A Malloy package is a directory containing Malloy models (.malloy files),
    Malloy notebooks (.malloynb files), and embedded databases

    (.parquet files) with a malloy-publisher.json manifest at the package's root
    directory.


    ## Key Features


    - **Environment Management**: Create and manage environments with their
    associated packages and connections

    - **Package Lifecycle**: Full CRUD operations for Malloy packages and their
    versions

    - **Model & Notebook Access**: Retrieve and execute Malloy models and
    notebooks

    - **Connection Management**: Secure database connection configuration and
    testing

    - **Query Execution**: Execute queries against models and retrieve results

    - **Watch Mode**: Real-time file watching for development workflows


    ## Resource Hierarchy


    The API follows a hierarchical resource structure:

    ```

    Environments

    ├── Connections

    └── Packages
        ├── Models
        ├── Notebooks
        └── Databases
    ```


    For examples, see the Malloy samples packages
    (https://github.com/malloydata/malloy-samples) repository.
  version: v0
servers:
  - url: https://{organization}.data.credibledata.com/api/v0/
    description: Production API server
    variables:
      organization:
        default: demo
        description: Your organization subdomain
security:
  - bearerAuth: []
tags:
  - name: publisher
    description: Publisher status and health check operations
  - name: environments
    description: >-
      Environment lifecycle management including creation, configuration, and
      deletion of data modeling environments
  - name: connections
    description: >-
      Database connection management for secure data source configuration and
      access
  - name: packages
    description: >-
      Package management for Malloy data models, including versioning and
      distribution
  - name: models
    description: Malloy model access and compilation operations
  - name: notebooks
    description: Malloy notebook access and execution operations
  - name: pages
    description: Static HTML pages (in-package data apps)
  - name: databases
    description: Embedded database management and access
  - name: watch-mode
    description: Real-time file watching for development workflows
  - name: materializations
    description: Package-level materializations for persisting Malloy sources
paths:
  /environments/{environmentName}/packages/{packageName}/materializations/{materializationId}:
    get:
      tags:
        - materializations
      summary: Get a specific materialization
      operationId: get-materialization
      parameters:
        - $ref: '#/components/parameters/environmentName'
        - $ref: '#/components/parameters/packageName'
        - $ref: '#/components/parameters/materializationId'
      responses:
        '200':
          description: Materialization details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Materialization'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    environmentName:
      name: environmentName
      in: path
      required: true
      description: Name of the environment
      schema:
        type: string
    packageName:
      name: packageName
      in: path
      required: true
      description: Name of the package
      schema:
        type: string
    materializationId:
      name: materializationId
      in: path
      required: true
      description: ID of the materialization
      schema:
        type: string
  schemas:
    Materialization:
      type: object
      description: A record of one materialization run for a package.
      properties:
        id:
          type: string
        environmentId:
          type: string
        packageName:
          type: string
        status:
          $ref: '#/components/schemas/MaterializationStatus'
        manifest:
          oneOf:
            - $ref: '#/components/schemas/BuildManifest'
            - type: 'null'
          description: Build output. Null until status = MANIFEST_FILE_READY.
        startedAt:
          type:
            - string
            - 'null'
          format: date-time
        completedAt:
          type:
            - string
            - 'null'
          format: date-time
        error:
          type:
            - string
            - 'null'
          description: Error message if the materialization failed
        metadata:
          type:
            - object
            - 'null'
          description: >-
            Materialization metadata including build options, source counts, and
            durations
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    MaterializationStatus:
      type: string
      description: Phase-aware status of a materialization run.
      enum:
        - PENDING
        - MANIFEST_ROWS_READY
        - MANIFEST_FILE_READY
        - FAILED
        - CANCELLED
    BuildManifest:
      type: object
      description: >-
        Build output. Maps each sourceEntityId a build produced to its physical
        table. Returned inline; the caller persists it.
      properties:
        builtAt:
          type: string
          format: date-time
        entries:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ManifestEntry'
          description: Map of sourceEntityId to manifest entry.
        strict:
          type: boolean
          description: Whether unresolved references should error.
    Error:
      type: object
      description: Standard error response format
      properties:
        message:
          type: string
          description: Human-readable error message describing what went wrong
        details:
          type: string
          description: Additional error details or context
      required:
        - message
    ManifestEntry:
      type: object
      description: A single entry in the build manifest.
      required:
        - sourceEntityId
        - physicalTableName
      properties:
        sourceEntityId:
          type: string
        sourceName:
          type: string
        materializedTableId:
          type: string
          description: Echoes the caller-assigned id from the BuildInstruction.
        physicalTableName:
          type: string
          description: Name of the materialized table.
        connectionName:
          type: string
        realization:
          $ref: '#/components/schemas/Realization'
        rowCount:
          type:
            - integer
            - 'null'
    Realization:
      type: string
      enum:
        - SNAPSHOT
        - COPY
      description: SNAPSHOT = warehouse clone/snapshot; COPY = CREATE TABLE AS SELECT.
  responses:
    NotFound:
      description: The specified resource was not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````