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

# List audit events for a physical asset



## OpenAPI

````yaml https://api.trlyr.com/physical-assets/docs/doc.json get /physical-assets/{physicalAssetID}/events
openapi: 3.1.0
info:
  description: >
    This API manages physical assets on the terralayr platform: asset
    parameters, schedules, ancillary bids and results, metadata, logbook
    entries, unavailabilities, and EEX notifications.


    Endpoints documented here require a valid Bearer token and the appropriate
    organisation permissions for the physical asset.


    ### Authorization


    All documented endpoints require a Bearer-type `Authorization` header:


    ```

    Authorization: Bearer <YOUR_TOKEN>

    ```


    Obtain a token via the Auth API:


    ```

    POST https://api.trlyr.com/auth/public/authenticate

    ```


    Example POST body:


    ```

    {
        "username": "YOUR_USERNAME",
        "password": "YOUR_PASSWORD"
    }

    ```



    If you have any questions, contact support@trlyr.com.
  title: terralayr Physical Assets API
  version: 1.0.1
servers:
  - description: Production API
    url: https://api.trlyr.com
  - description: Sandbox API
    url: https://api.sandbox.trlyr.com
security: []
tags:
  - name: health
  - name: physical-assets
  - name: schedule
  - name: ancillary
  - name: metadata
  - name: logbook
  - name: eex
externalDocs:
  description: ''
  url: ''
paths:
  /physical-assets/{physicalAssetID}/events:
    get:
      tags:
        - physical-assets
      summary: List audit events for a physical asset
      parameters:
        - description: Access token
          in: header
          name: Authorization
          required: true
          schema:
            default: Bearer <access token value>
            type: string
        - description: Physical asset ID
          in: path
          name: physicalAssetID
          required: true
          schema:
            format: uuid
            type: string
        - description: Comma-separated audit event types
          in: query
          name: types
          schema:
            type: string
        - description: Query start time
          in: query
          name: start
          schema:
            type: string
        - description: Query end time
          in: query
          name: end
          schema:
            type: string
        - description: Page number (1-based)
          in: query
          name: page
          schema:
            type: integer
        - description: Page size
          in: query
          name: limit
          schema:
            type: integer
        - description: Sort field
          in: query
          name: sortBy
          schema:
            enum:
              - created
              - type
              - id
              - traceId
              - userId
            type: string
        - description: Sort order
          in: query
          name: sortOrder
          schema:
            enum:
              - asc
              - desc
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditEventsResponseBody'
          description: OK
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
components:
  schemas:
    AuditEventsResponseBody:
      properties:
        events:
          items:
            $ref: '#/components/schemas/AuditEventBody'
          type: array
          uniqueItems: false
        pagination:
          $ref: '#/components/schemas/PaginationBody'
      type: object
    AuditEventBody:
      properties:
        cloudEventId:
          type: string
        context:
          items:
            type: integer
          type: array
          uniqueItems: false
        created:
          type: string
        id:
          type: string
        origin:
          type: string
        traceId:
          type: string
        type:
          type: string
        user:
          $ref: '#/components/schemas/AuditUserBody'
      type: object
    PaginationBody:
      properties:
        limit:
          type: integer
        page:
          type: integer
        pages:
          type: integer
        total:
          type: integer
      type: object
    AuditUserBody:
      properties:
        id:
          type: string
      type: object

````