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

# Get Entry

> Retrieve a specific entry by ID.

Returns the entry's extracted data, processing status, price, validation errors, and associated documents.



## OpenAPI

````yaml /api-reference/openapi.json get /v3/entries/{entry_id}
openapi: 3.1.0
info:
  title: matil API
  description: Structured data extraction for documents
  version: 3.0.0
servers:
  - url: https://api.matil.ai
security:
  - ApiKeyAuth: []
paths:
  /v3/entries/{entry_id}:
    get:
      tags:
        - Entries
      summary: Get Entry
      description: >-
        Retrieve a specific entry by ID.


        Returns the entry's extracted data, processing status, price, validation
        errors, and associated documents.
      operationId: get_entry_v3_entries__entry_id__get
      parameters:
        - name: entry_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Entry Id
        - name: include_details
          in: query
          required: false
          schema:
            type: boolean
            description: Include additional details
            default: false
            title: Include Details
          description: Include additional details
        - name: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
        - name: x-api-key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
        - name: X-Tenant-ID
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Tenant-Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntryResponse'
        '401':
          description: >-
            Authentication required. Provide a valid `x-api-key` or
            `Authorization: Bearer` token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: AUTHENTICATION_REQUIRED
                message: Authentication required. Provide a valid x-api-key header.
                details: null
        '404':
          description: Entry not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: ENTRY_NOT_FOUND
                message: Entry not found.
                details: null
components:
  schemas:
    EntryResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        tenant_id:
          type: string
          format: uuid
          title: Tenant Id
        deployment_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Deployment Id
        structure_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Structure Id
        structure_version_number:
          anyOf:
            - type: integer
            - type: 'null'
          title: Structure Version Number
        parent_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Parent Id
          description: Parent entry ID for group child entries
        children:
          anyOf:
            - items:
                $ref: '#/components/schemas/EntryResponse'
              type: array
            - type: 'null'
          title: Children
          description: Child entries (only included when requested)
        page_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Count
          description: Number of pages processed (for pricing)
        resource_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Resource Name
        created_by_info:
          anyOf:
            - $ref: '#/components/schemas/CreatedByInfo'
            - type: 'null'
        documents:
          items:
            $ref: '#/components/schemas/DocumentResponse'
          type: array
          title: Documents
          description: Associated documents
        data:
          additionalProperties: true
          type: object
          title: Data
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Errors
          description: All errors including validation and document issues
        time_ms:
          anyOf:
            - type: integer
            - type: 'null'
          title: Time Ms
        status:
          type: string
          title: Status
        price:
          type: number
          title: Price
          description: Price for this entry
        request_metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Request Metadata
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        corrections_count:
          type: integer
          title: Corrections Count
          default: 0
        correction:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Correction
        corrected_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Corrected Data
        correction_notes:
          anyOf:
            - type: string
            - type: 'null'
          title: Correction Notes
      type: object
      required:
        - id
        - tenant_id
        - deployment_id
        - data
        - status
        - price
        - created_at
        - updated_at
      title: EntryResponse
      description: Schema for entry responses.
      example:
        created_at: '2023-01-01T00:00:00Z'
        created_by_info:
          id: 123e4567-e89b-12d3-a456-426614174005
          name: My API Key
          type: api-key
        data:
          field1: value1
          field2: value2
        deployment_id: 123e4567-e89b-12d3-a456-426614174003
        documents: []
        id: 123e4567-e89b-12d3-a456-426614174000
        resource_name: My Structure
        status: completed
        steps:
          - data:
              field1: initial_value
            errors: []
          - data:
              field1: value1
              field2: value2
            errors: []
        tenant_id: 123e4567-e89b-12d3-a456-426614174001
        updated_at: '2023-01-01T00:00:00Z'
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Machine-readable error code.
        message:
          type: string
          description: Human-readable description.
        details:
          type: object
          nullable: true
          description: Additional context when available.
      required:
        - error
        - message
    CreatedByInfo:
      properties:
        type:
          type: string
          title: Type
        id:
          type: string
          title: Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
      type: object
      required:
        - type
        - id
      title: CreatedByInfo
      description: Schema for creator information.
    DocumentResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        tenant_id:
          type: string
          format: uuid
          title: Tenant Id
        original_filename:
          type: string
          title: Original Filename
        file_type:
          type: string
          title: File Type
        mime_type:
          type: string
          title: Mime Type
        size_bytes:
          type: integer
          title: Size Bytes
        url_endpoint:
          type: string
          title: Url Endpoint
          description: API path to obtain a presigned download URL
          default: ''
        has_processed_content:
          type: boolean
          title: Has Processed Content
          description: Whether a processed version exists
          default: false
        retention_policy:
          type: string
          title: Retention Policy
        retention_days:
          type: integer
          title: Retention Days
        delete_after:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Delete After
        status:
          type: string
          title: Status
        processing_error:
          anyOf:
            - type: string
            - type: 'null'
          title: Processing Error
        page_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Count
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        deleted_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Deleted At
      type: object
      required:
        - id
        - tenant_id
        - original_filename
        - file_type
        - mime_type
        - size_bytes
        - retention_policy
        - retention_days
        - status
        - created_at
        - updated_at
      title: DocumentResponse
      description: Response schema for document operations.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````