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

# List technicians

> The technician list.

Team, site, skills, certifications, availability, load and the latest computed performance period.

user_id and user_email are the account they sign in with, and are read-only here: the link is made
from Settings → Access by api.add_user_to_workforce. Null is the ordinary answer for a contractor.



## OpenAPI

````yaml /api-reference/integration.json get /technicians
openapi: 3.0.0
info:
  description: >-
    The calls an integration needs first. Every endpoint the application uses is
    in the complete reference.
  title: Asset Infinity integration API
  version: 12.2.3
servers:
  - url: https://app.assetinfinity.ai/api
security: []
tags:
  - description: >-
      Exchange an API key, or an email and password, for a short-lived session
      token, and send it as `Authorization: Bearer <token>` on every other call.
    name: Signing in
  - description: >-
      Where assets are and work happens. A location belongs to a site and may
      sit inside another location.
    name: Sites and locations
  - description: >-
      The asset register: read it, add to it, correct it, move an asset between
      sites and locations, and change its status.
    name: Assets
  - description: >-
      Report a problem. A request is triaged by a person, who turns it into a
      work order or turns it down.
    name: Work requests
  - description: >-
      Raise a job, give it to somebody, move it through the organisation's
      statuses, complete it and close it.
    name: Work orders
  - description: >-
      Send readings in. A meter reading brings the meter forward and raises any
      maintenance the usage has made due. A sensor reading can open or clear an
      alert.
    name: Meters and sensors
  - description: >-
      The part catalogue and what is on the shelf in each store, and the three
      movements an outside system most often records: a delivery in, an issue
      out and a correction.
    name: Parts and stock
  - description: >-
      Have the product call your system when something happens, instead of
      asking it on a timer.
    name: Webhooks
  - description: >-
      The calls behind every register that has no call of its own, answers to
      the organisation's own fields, and the two calls that answer what to send.
      `list_options` returns the ids a field accepts. `describe_call` returns
      the fields any call takes.
    name: Any record
externalDocs:
  description: PostgREST Documentation
  url: https://postgrest.org/en/v12/references/api.html
paths:
  /technicians:
    get:
      tags:
        - Work orders
      summary: List technicians
      description: >-
        The technician list.


        Team, site, skills, certifications, availability, load and the latest
        computed performance period.


        user_id and user_email are the account they sign in with, and are
        read-only here: the link is made

        from Settings → Access by api.add_user_to_workforce. Null is the
        ordinary answer for a contractor.
      parameters:
        - $ref: '#/components/parameters/rowFilter.technicians.worker_id'
        - $ref: '#/components/parameters/rowFilter.technicians.worker_number'
        - $ref: '#/components/parameters/rowFilter.technicians.name'
        - $ref: '#/components/parameters/rowFilter.technicians.worker_type'
        - $ref: '#/components/parameters/rowFilter.technicians.primary_site_id'
        - $ref: >-
            #/components/parameters/rowFilter.technicians.max_concurrent_work_orders
        - $ref: '#/components/parameters/rowFilter.technicians.is_active'
        - $ref: '#/components/parameters/rowFilter.technicians.open_work_orders'
        - $ref: '#/components/parameters/rowFilter.technicians.active_work_orders'
        - $ref: '#/components/parameters/rowFilter.technicians.overdue_work_orders'
        - $ref: >-
            #/components/parameters/rowFilter.technicians.planned_minutes_outstanding
        - $ref: '#/components/parameters/rowFilter.technicians.skills'
        - $ref: '#/components/parameters/rowFilter.technicians.email'
        - $ref: '#/components/parameters/rowFilter.technicians.phone'
        - $ref: '#/components/parameters/rowFilter.technicians.user_id'
        - $ref: '#/components/parameters/rowFilter.technicians.user_email'
        - $ref: '#/components/parameters/rowFilter.technicians.user_status'
        - $ref: '#/components/parameters/rowFilter.technicians.employment_status'
        - $ref: '#/components/parameters/rowFilter.technicians.employment_start_date'
        - $ref: '#/components/parameters/rowFilter.technicians.can_travel'
        - $ref: '#/components/parameters/rowFilter.technicians.travel_radius_km'
        - $ref: '#/components/parameters/rowFilter.technicians.track_location'
        - $ref: '#/components/parameters/rowFilter.technicians.site_code'
        - $ref: '#/components/parameters/rowFilter.technicians.site_name'
        - $ref: '#/components/parameters/rowFilter.technicians.department_name'
        - $ref: '#/components/parameters/rowFilter.technicians.team_name'
        - $ref: '#/components/parameters/rowFilter.technicians.is_team_lead'
        - $ref: '#/components/parameters/rowFilter.technicians.availability'
        - $ref: '#/components/parameters/rowFilter.technicians.valid_certifications'
        - $ref: >-
            #/components/parameters/rowFilter.technicians.certifications_expiring
        - $ref: '#/components/parameters/rowFilter.technicians.certifications_lapsed'
        - $ref: >-
            #/components/parameters/rowFilter.technicians.next_certification_expiry
        - $ref: >-
            #/components/parameters/rowFilter.technicians.performance_period_start
        - $ref: '#/components/parameters/rowFilter.technicians.performance_period_end'
        - $ref: '#/components/parameters/rowFilter.technicians.utilisation_rate'
        - $ref: '#/components/parameters/rowFilter.technicians.first_time_fix_rate'
        - $ref: '#/components/parameters/rowFilter.technicians.sla_compliance_rate'
        - $ref: '#/components/parameters/rowFilter.technicians.completed_in_period'
        - $ref: '#/components/parameters/rowFilter.technicians.custom_fields'
        - $ref: '#/components/parameters/rowFilter.technicians.created_at'
        - $ref: '#/components/parameters/rowFilter.technicians.created_by_id'
        - $ref: '#/components/parameters/rowFilter.technicians.created_by_name'
        - $ref: '#/components/parameters/rowFilter.technicians.created_source'
        - $ref: '#/components/parameters/rowFilter.technicians.updated_at'
        - $ref: '#/components/parameters/rowFilter.technicians.updated_by_id'
        - $ref: '#/components/parameters/rowFilter.technicians.updated_by_name'
        - $ref: '#/components/parameters/select'
        - $ref: '#/components/parameters/order'
        - $ref: '#/components/parameters/range'
        - $ref: '#/components/parameters/rangeUnit'
        - $ref: '#/components/parameters/offset'
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/preferCount'
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/technicians'
                type: array
            application/vnd.pgrst.object+json:
              schema:
                items:
                  $ref: '#/components/schemas/technicians'
                type: array
            application/vnd.pgrst.object+json;nulls=stripped:
              schema:
                items:
                  $ref: '#/components/schemas/technicians'
                type: array
            text/csv:
              schema:
                items:
                  $ref: '#/components/schemas/technicians'
                type: array
          description: OK
        '206':
          description: Partial Content
components:
  parameters:
    rowFilter.technicians.worker_id:
      in: query
      name: worker_id
      required: false
      schema:
        type: string
    rowFilter.technicians.worker_number:
      in: query
      name: worker_number
      required: false
      schema:
        type: string
    rowFilter.technicians.name:
      in: query
      name: name
      required: false
      schema:
        type: string
    rowFilter.technicians.worker_type:
      in: query
      name: worker_type
      required: false
      schema:
        type: string
    rowFilter.technicians.primary_site_id:
      in: query
      name: primary_site_id
      required: false
      schema:
        type: string
    rowFilter.technicians.max_concurrent_work_orders:
      in: query
      name: max_concurrent_work_orders
      required: false
      schema:
        type: string
    rowFilter.technicians.is_active:
      in: query
      name: is_active
      required: false
      schema:
        type: string
    rowFilter.technicians.open_work_orders:
      in: query
      name: open_work_orders
      required: false
      schema:
        type: string
    rowFilter.technicians.active_work_orders:
      in: query
      name: active_work_orders
      required: false
      schema:
        type: string
    rowFilter.technicians.overdue_work_orders:
      in: query
      name: overdue_work_orders
      required: false
      schema:
        type: string
    rowFilter.technicians.planned_minutes_outstanding:
      in: query
      name: planned_minutes_outstanding
      required: false
      schema:
        type: string
    rowFilter.technicians.skills:
      in: query
      name: skills
      required: false
      schema:
        type: string
    rowFilter.technicians.email:
      in: query
      name: email
      required: false
      schema:
        type: string
    rowFilter.technicians.phone:
      in: query
      name: phone
      required: false
      schema:
        type: string
    rowFilter.technicians.user_id:
      in: query
      name: user_id
      required: false
      schema:
        type: string
    rowFilter.technicians.user_email:
      in: query
      name: user_email
      required: false
      schema:
        type: string
    rowFilter.technicians.user_status:
      in: query
      name: user_status
      required: false
      schema:
        type: string
    rowFilter.technicians.employment_status:
      in: query
      name: employment_status
      required: false
      schema:
        type: string
    rowFilter.technicians.employment_start_date:
      in: query
      name: employment_start_date
      required: false
      schema:
        type: string
    rowFilter.technicians.can_travel:
      in: query
      name: can_travel
      required: false
      schema:
        type: string
    rowFilter.technicians.travel_radius_km:
      in: query
      name: travel_radius_km
      required: false
      schema:
        type: string
    rowFilter.technicians.track_location:
      in: query
      name: track_location
      required: false
      schema:
        type: string
    rowFilter.technicians.site_code:
      in: query
      name: site_code
      required: false
      schema:
        type: string
    rowFilter.technicians.site_name:
      in: query
      name: site_name
      required: false
      schema:
        type: string
    rowFilter.technicians.department_name:
      in: query
      name: department_name
      required: false
      schema:
        type: string
    rowFilter.technicians.team_name:
      in: query
      name: team_name
      required: false
      schema:
        type: string
    rowFilter.technicians.is_team_lead:
      in: query
      name: is_team_lead
      required: false
      schema:
        type: string
    rowFilter.technicians.availability:
      in: query
      name: availability
      required: false
      schema:
        type: string
    rowFilter.technicians.valid_certifications:
      in: query
      name: valid_certifications
      required: false
      schema:
        type: string
    rowFilter.technicians.certifications_expiring:
      in: query
      name: certifications_expiring
      required: false
      schema:
        type: string
    rowFilter.technicians.certifications_lapsed:
      in: query
      name: certifications_lapsed
      required: false
      schema:
        type: string
    rowFilter.technicians.next_certification_expiry:
      in: query
      name: next_certification_expiry
      required: false
      schema:
        type: string
    rowFilter.technicians.performance_period_start:
      in: query
      name: performance_period_start
      required: false
      schema:
        type: string
    rowFilter.technicians.performance_period_end:
      in: query
      name: performance_period_end
      required: false
      schema:
        type: string
    rowFilter.technicians.utilisation_rate:
      in: query
      name: utilisation_rate
      required: false
      schema:
        type: string
    rowFilter.technicians.first_time_fix_rate:
      in: query
      name: first_time_fix_rate
      required: false
      schema:
        type: string
    rowFilter.technicians.sla_compliance_rate:
      in: query
      name: sla_compliance_rate
      required: false
      schema:
        type: string
    rowFilter.technicians.completed_in_period:
      in: query
      name: completed_in_period
      required: false
      schema:
        type: string
    rowFilter.technicians.custom_fields:
      in: query
      name: custom_fields
      required: false
      schema:
        type: string
    rowFilter.technicians.created_at:
      in: query
      name: created_at
      required: false
      schema:
        type: string
    rowFilter.technicians.created_by_id:
      in: query
      name: created_by_id
      required: false
      schema:
        type: string
    rowFilter.technicians.created_by_name:
      in: query
      name: created_by_name
      required: false
      schema:
        type: string
    rowFilter.technicians.created_source:
      in: query
      name: created_source
      required: false
      schema:
        type: string
    rowFilter.technicians.updated_at:
      in: query
      name: updated_at
      required: false
      schema:
        type: string
    rowFilter.technicians.updated_by_id:
      in: query
      name: updated_by_id
      required: false
      schema:
        type: string
    rowFilter.technicians.updated_by_name:
      in: query
      name: updated_by_name
      required: false
      schema:
        type: string
    select:
      description: Filtering Columns
      in: query
      name: select
      required: false
      schema:
        type: string
    order:
      description: Ordering
      in: query
      name: order
      required: false
      schema:
        type: string
    range:
      description: Limiting and Pagination
      in: header
      name: Range
      required: false
      schema:
        type: string
    rangeUnit:
      description: Limiting and Pagination
      in: header
      name: Range-Unit
      required: false
      schema:
        default: items
        type: string
    offset:
      description: Limiting and Pagination
      in: query
      name: offset
      required: false
      schema:
        type: string
    limit:
      description: Limiting and Pagination
      in: query
      name: limit
      required: false
      schema:
        type: string
    preferCount:
      description: Preference
      in: header
      name: Prefer
      required: false
      schema:
        enum:
          - count=none
        type: string
  schemas:
    technicians:
      description: >-
        The technician list.


        Team, site, skills, certifications, availability, load and the latest
        computed performance period.


        user_id and user_email are the account they sign in with, and are
        read-only here: the link is made

        from Settings → Access by api.add_user_to_workforce. Null is the
        ordinary answer for a contractor.
      properties:
        active_work_orders:
          format: bigint
          type: integer
        availability:
          format: text
          type: string
        can_travel:
          format: boolean
          type: boolean
        certifications_expiring:
          format: bigint
          type: integer
        certifications_lapsed:
          format: bigint
          type: integer
        completed_in_period:
          format: integer
          type: integer
        created_at:
          format: timestamp with time zone
          type: string
        created_by_id:
          description: >-
            Note:

            This is a Foreign Key to `capex_invite_candidates.id`.<fk
            table='capex_invite_candidates' column='id'/>
          format: uuid
          type: string
        created_by_name:
          format: character varying
          maxLength: 200
          type: string
        created_source:
          format: text
          type: string
        custom_fields:
          format: jsonb
        department_name:
          format: character varying
          maxLength: 200
          type: string
        email:
          format: public.citext
          type: string
        employment_start_date:
          format: date
          type: string
        employment_status:
          format: character varying
          maxLength: 30
          type: string
        first_time_fix_rate:
          format: numeric
          type: number
        is_active:
          format: boolean
          type: boolean
        is_team_lead:
          format: boolean
          type: boolean
        max_concurrent_work_orders:
          format: smallint
          type: integer
        name:
          format: character varying
          maxLength: 200
          type: string
        next_certification_expiry:
          format: date
          type: string
        open_work_orders:
          format: bigint
          type: integer
        overdue_work_orders:
          format: bigint
          type: integer
        performance_period_end:
          format: date
          type: string
        performance_period_start:
          format: date
          type: string
        phone:
          format: character varying
          maxLength: 40
          type: string
        planned_minutes_outstanding:
          format: integer
          type: integer
        primary_site_id:
          description: >-
            Note:

            This is a Foreign Key to `entry_currencies.for_site_id`.<fk
            table='entry_currencies' column='for_site_id'/>
          format: uuid
          type: string
        site_code:
          format: character varying
          maxLength: 50
          type: string
        site_name:
          format: character varying
          maxLength: 200
          type: string
        skills:
          format: jsonb
        sla_compliance_rate:
          format: numeric
          type: number
        team_name:
          format: character varying
          maxLength: 200
          type: string
        track_location:
          format: boolean
          type: boolean
        travel_radius_km:
          format: integer
          type: integer
        updated_at:
          format: timestamp with time zone
          type: string
        updated_by_id:
          description: >-
            Note:

            This is a Foreign Key to `capex_invite_candidates.id`.<fk
            table='capex_invite_candidates' column='id'/>
          format: uuid
          type: string
        updated_by_name:
          format: character varying
          maxLength: 200
          type: string
        user_email:
          format: text
          type: string
        user_id:
          description: >-
            Note:

            This is a Foreign Key to `capex_invite_candidates.id`.<fk
            table='capex_invite_candidates' column='id'/>
          format: uuid
          type: string
        user_status:
          format: character varying
          maxLength: 30
          type: string
        utilisation_rate:
          format: numeric
          type: number
        valid_certifications:
          format: bigint
          type: integer
        worker_id:
          description: |-
            Note:
            This is a Primary Key.<pk/>
          format: uuid
          type: string
        worker_number:
          format: character varying
          maxLength: 60
          type: string
        worker_type:
          format: character varying
          maxLength: 40
          type: string
      type: object

````

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