# List Jobs

Returns the company's jobs, most recently updated first.

Endpoint: GET /api/v1/jobs
Security: BearerAuth

## Query parameters:

  - `page` (number)
    Page number, starting at 1
    Example: "1"

  - `per_page` (number)
    Number of jobs per page (1-100)
    Example: "20"

  - `name` (string)
    Filters to jobs whose name starts with this value. Case-insensitive.
    Example: "HVAC"

  - `status` (string)
    Comma-separated status keys to filter by. Defaults to all statuses.
    Example: "not_started,in_progress"

  - `sort_by` (string)
    Field to sort by. One of name, status, start_date, end_date, created_by_name, updated_at. Defaults to updated_at.
    Example: "updated_at"

  - `sort_direction` (string)
    asc or desc. Defaults to desc.
    Example: "desc"

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (number)

  - `data.name` (string)

  - `data.status` (string)

  - `data.folder_id` (number)

  - `data.custom_field_values` (array)

  - `data.custom_field_values.custom_field_id` (number)

  - `data.custom_field_values.value` (string,null)

  - `data.custom_field_values.version` (number,null)

  - `data.created_by` (object)

  - `data.created_at` (string)

  - `data.updated_at` (string)

  - `data.start_date` (string,null)

  - `data.end_date` (string,null)

  - `data.external_job_link` (string,null)

  - `meta` (object)

  - `meta.page` (number)

  - `meta.per_page` (number)

  - `meta.has_next` (boolean)
    True when a further page is available

  - `meta.has_prev` (boolean)
    True when an earlier page is available

## Response 400 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 401 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 429 fields (application/json):

  - `message` (string)