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

# List Field Recordings

> Retrieve a paginated list of field recordings in your company.



## OpenAPI

````yaml /api/openapi.json get /recordings/
openapi: 3.1.0
info:
  title: Craft API
  description: Public API for programmatic access to your Craft data.
  version: 1.0.0
servers:
  - url: https://data.craftflow.co/api/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /recordings/:
    get:
      tags:
        - Field Recordings
      summary: List Field Recordings
      description: Retrieve a paginated list of field recordings in your company.
      operationId: listRecordings
      parameters:
        - name: ordering
          in: query
          description: Sort results by a field. Prefix with `-` for descending order.
          required: false
          schema:
            type: string
            enum:
              - created_at
              - '-created_at'
            default: '-created_at'
        - name: page
          in: query
          description: Page number.
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: page_size
          in: query
          description: Number of results per page.
          required: false
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: A paginated list of field recordings.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/FieldRecording'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                required:
                  - data
                  - pagination
              example:
                data:
                  - id: e5f6a7b8-c9d0-1234-efab-567890123456
                    name: HVAC Install - 123 Main St
                    start_time: '2025-07-01T09:00:00Z'
                    end_time: '2025-07-01T09:45:00Z'
                    audio_duration_seconds: 2700
                    score: 0.85
                    user:
                      id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                      full_name: John Doe
                    created_at: '2025-07-01T09:00:00Z'
                pagination:
                  count: 1
                  page: 1
                  page_size: 25
                  total_pages: 1
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    FieldRecording:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the field recording.
        name:
          type:
            - string
            - 'null'
          description: Name or label for the field recording.
        start_time:
          type: string
          format: date-time
          description: When the field recording started (ISO 8601).
        end_time:
          type: string
          format: date-time
          description: When the field recording ended (ISO 8601).
        audio_duration_seconds:
          type: integer
          description: Duration of the audio in seconds.
        score:
          type: number
          description: Overall score for the field recording (0.0 - 1.0).
        user:
          oneOf:
            - $ref: '#/components/schemas/NestedUser'
            - type: 'null'
          description: The technician who made the field recording, or null.
        created_at:
          type: string
          format: date-time
          description: When the field recording was created (ISO 8601).
      required:
        - id
        - name
        - start_time
        - end_time
        - audio_duration_seconds
        - score
        - user
        - created_at
    Pagination:
      type: object
      properties:
        count:
          type: integer
          description: Total number of results across all pages.
        page:
          type: integer
          description: Current page number.
        page_size:
          type: integer
          description: Number of results on this page.
        total_pages:
          type: integer
          description: Total number of pages.
      required:
        - count
        - page
        - page_size
        - total_pages
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            detail:
              type: string
              description: Human-readable error message.
          required:
            - detail
      required:
        - error
    NestedUser:
      type: object
      description: The user associated with this record, or null if none.
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the user.
        full_name:
          type: string
          description: The user's full display name.
      required:
        - id
        - full_name
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key, prefixed with `cf_live_`.

````