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

# Get a machine data source



## OpenAPI

````yaml /openapi.json get /machine-data-sources/{id}
openapi: 3.1.0
info:
  title: Cula Tracking API
  version: 0.3.20
servers:
  - url: https://api.demo.cula.earth/tracking/v1
security: []
tags:
  - name: Organisations
    description: ''
  - name: Sites
    description: ''
  - name: Machine Data Sources
    description: ''
  - name: Machines
    description: ''
  - name: Machine Variables
    description: ''
  - name: Machine Data Imports
    description: ''
  - name: Machine Data Annotations
    description: ''
  - name: Delivery Configs
    description: ''
  - name: Deliveries
    description: ''
  - name: Material Sourcing Configs
    description: ''
  - name: Material Sourcings
    description: ''
  - name: Material Conversion Configs
    description: ''
  - name: Material Conversions
    description: ''
  - name: Material Utilization Configs
    description: ''
  - name: Material Utilizations
    description: ''
  - name: Material Batches
    description: ''
  - name: Material Pools
    description: ''
  - name: Material Containers
    description: ''
  - name: Sinks
    description: ''
  - name: Documents
    description: ''
  - name: Webhooks
    description: ''
paths:
  /machine-data-sources/{id}:
    get:
      tags:
        - Machine Data Sources
      summary: Get a machine data source
      parameters:
        - name: Cula-Organisation-Id
          in: header
          description: >-
            ID of the organisation the request operates on behalf of (e.g.
            `org_...`). Must be an organisation the API client has access to.
          required: true
          schema:
            type: string
            example: org_01k83mfmhgchya944v86ryvhpq
        - name: id
          required: true
          in: path
          schema:
            type: string
            example: mds_01kqzcjrpyf27tge7875y20mmr
      responses:
        '200':
          description: Machine data source
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MachineDataSourceResponse'
        '400':
          description: Invalid request payload or parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: bad_request
                message: The field limit must not be greater than 50.
        '401':
          description: Missing or invalid access token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: unauthorized
                message: Invalid or expired token
        '404':
          description: Object not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: not_found
                message: >-
                  Object with ID xyz_01k56g7aec6dt5zrtamc72vw446 could not be
                  found.
        '429':
          description: >-
            The API client sent more requests than its limit allows. Try again
            after the time given in the `Retry-After` header.
          headers:
            Retry-After:
              description: Seconds until the API client can send requests again.
              schema:
                type: integer
                example: 42
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: too_many_requests
                message: >-
                  Too many requests. Try again after the time given in the
                  Retry-After header.
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: internal_server_error
                message: Internal server error.
      security:
        - AccessToken: []
components:
  schemas:
    MachineDataSourceResponse:
      type: object
      properties:
        id:
          type: string
          example: mds_01kqzcjrpyf27tge7875y20mmr
          description: Unique identifier of the machine data source.
        name:
          type: string
          example: Truck Scale
          description: Human-readable name of the machine data source.
        site:
          description: The site that owns this machine data source.
          example:
            id: ste_01k8g7aec6dt5zrtamc72ww446
            external_id: null
          allOf:
            - $ref: '#/components/schemas/SiteReference'
        transport:
          type:
            - string
            - 'null'
          enum:
            - mqtt_ixon
            - mqtt_dingx
            - null
          example: mqtt_ixon
          description: >-
            How the values of the source reach Cula: `mqtt_ixon` (published over
            MQTT in the IXON format) or `mqtt_dingx` (published over MQTT in the
            DingX format). Null for sources whose values are pushed through this
            API, imported or generated.
        protocol:
          type:
            - string
            - 'null'
          enum:
            - opc_ua
            - siemens_s7
            - modbus
            - mc_protocol
            - bacnet_ip
            - ethernet_ip
            - null
          example: opc_ua
          description: >-
            Protocol between the gateway and the PLC or device behind the
            source. Null when the gateway does not report it, e.g. for a
            customer system publishing on its own.
      required:
        - id
        - name
        - site
        - transport
        - protocol
    Error:
      type: object
      properties:
        code:
          type: string
          example: bad_request
        message:
          type: string
          example: The field limit must not be greater than 50.
      required:
        - code
        - message
    SiteReference:
      type: object
      properties:
        id:
          type:
            - string
            - 'null'
          example: ste_01k8g7aec6dt5zrtamc72ww446
        external_id:
          type:
            - string
            - 'null'
          example: SITE-EXT-0001
      description: >-
        References a site by its ID and the external ID you assigned to it (if
        any).
      required:
        - id
        - external_id
  securitySchemes:
    AccessToken:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://auth.demo.cula.earth/oauth2/token
          scopes: {}
      description: >-
        OAuth 2.0 client credentials. Exchange your client_id and client_secret
        for an access token scoped to the organisation that provides data
        access.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.