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

# Get Evidence



## OpenAPI

````yaml GET /evidences/{COMPANY_ID}/evidence/{EVIDENCE_EXTERNAL_ID}
openapi: 3.0.0
info:
  title: TimeLockData API
  description: Public API for evidence management and blockchain traceability
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.timelockdata.com/api/v1
    description: Production
security: []
tags: []
paths:
  /evidences/{COMPANY_ID}/evidence/{EVIDENCE_EXTERNAL_ID}:
    get:
      tags:
        - Evidence Management
      summary: Get a evidence by external ID
      operationId: DigitalTwinController_getDigitalTwin
      parameters:
        - name: COMPANY_ID
          required: true
          in: path
          description: Company identifier
          schema:
            type: string
        - name: EVIDENCE_EXTERNAL_ID
          required: true
          in: path
          description: Evidence external identifier
          schema:
            type: string
        - name: last
          required: false
          in: query
          description: Last event index for pagination
          schema:
            type: string
        - name: len
          required: false
          in: query
          description: Number of events to return
          schema:
            type: string
      responses:
        '200':
          description: Evidence details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDigitalTwinResponse'
      security:
        - APIKeyAuth: []
components:
  schemas:
    GetDigitalTwinResponse:
      type: object
      properties:
        object:
          description: Evidence object details
          allOf:
            - $ref: '#/components/schemas/BlockchainObject'
        events:
          description: List of events associated with the evidence
          type: array
          items:
            $ref: '#/components/schemas/BlockchainEvent'
        lastVersion:
          type: number
          description: Version of the last retrieved history element
        isMore:
          type: boolean
          description: Indicates whether additional events exist
    BlockchainObject:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the evidence object
        categoryId:
          type: string
          description: ID of the category this object belongs to
        subcategoryId:
          type: string
          description: ID of the subcategory this object belongs to
        externalId:
          type: string
          description: External identifier of the object
        createDate:
          format: date-time
          type: string
          description: Date when the object was created
        name:
          type: string
          description: Name of the object
        status:
          type: string
          description: Current status of the object
        description:
          type: string
          description: Description of the object
        imageId:
          type: string
          description: ID of the associated image
        summary:
          type: string
          description: Summary of the object
        owner:
          type: string
          description: Current owner of the object
        txId:
          type: string
          description: Transaction ID of the blockchain transaction for object creation
        meta:
          type: object
          description: Additional metadata associated with the object
      required:
        - id
        - categoryId
        - subcategoryId
        - externalId
        - createDate
        - name
        - status
        - txId
    BlockchainEvent:
      type: object
      properties:
        timestamp:
          format: date-time
          type: string
          description: Timestamp of when the event occurred
        personaName:
          type: string
          description: Name of the persona associated with the event
        ownerName:
          type: string
          description: Name of the owner at the time of the event
        type:
          type: string
          description: Type of action performed
          enum:
            - update
            - transfer
            - create
        updateType:
          type: string
          description: Subtype of the update action
          enum:
            - stolen
            - repair
            - custom
            - change
            - addfile
            - deletefile
        eventDescription:
          type: string
          description: Description of the event
        updateDescription:
          type: string
          description: Description of the update
        txId:
          type: string
          description: Transaction ID of the blockchain transaction for this event
        version:
          type: number
          description: Version number of the event
        meta:
          type: object
          description: Additional metadata associated with the event
        merkleBatchId:
          type: string
          description: Merkle batch ID (null if not yet batched)
        merkleSendStatus:
          type: string
          description: >-
            Merkle batch send status: P=Pending, S=Sent, C=Confirmed (null if
            not batched)
      required:
        - timestamp
        - ownerName
        - type
        - txId
  securitySchemes:
    APIKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````