---
title: "List your jobs"
method: GET
path: "/v1/jobs"
tags: ["Jobs"]
---

# List your jobs

`GET /v1/jobs`

## Request

- Base URL: `https://api.onegoodarea.com`
- URL: `https://api.onegoodarea.com/v1/jobs`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

The caller's jobs, newest first.

## Query parameters

- `limit` integer

## Response `200`

Default Response

- object
  - `jobs` object[], required
    - `id` string, required
    - `kind` 'portfolio_map', required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed', required
    - `attempts` integer, required
    - `progress` object, required
      - `total` integer, required
      - `done` integer, required
    - `summary` object, required
      - `count` integer, required
      - `resolved` integer, required
      - `ambiguous` integer, required
      - `not_found` integer, required
      - `with_signals` integer, required
      - `without_signals` integer, required
      - `portfolio` object, required
        - `id` string, required
        - `added` integer, required
        - `updated` integer, required
    - `error` string, required
    - `created_at` string, date-time, required
    - `started_at` string, date-time, required
    - `finished_at` string, date-time, required
  - `meta` object, required
    - `engine_version` string, required
    - `generated_at` string, required

## Other responses

- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `429`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/onegoodarea/apis/onegoodarea-api.md) · [All operations](https://skmtc.dev/onegoodarea/apis/onegoodarea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/onegoodarea/apis/onegoodarea-api/revisions/b318d28b3412?raw)