---
title: "List async jobs, newest first."
method: GET
path: "/api/v1/jobs"
tags: ["Async jobs"]
---

# List async jobs, newest first.

`GET /api/v1/jobs`

## Request

- Base URL: `https://deepsearch.app`
- URL: `https://deepsearch.app/api/v1/jobs`
- Auth: HTTP bearer

Returns the caller's async API jobs, newest first, in cursor pages.

Page by passing the previous response's `next_cursor` back as `cursor`. `has_more` is false and `next_cursor` is null on the last page, so an agent can loop until `has_more` is false without a separate count. Cursors are opaque: treat them as strings and do not construct one yourself.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

One page of jobs.

- object
  - `jobs` ApiJob[], required
    - `object` 'job', required
    - `id` string, uuid, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled', required
    - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
    - `request_id` string, nullable, required
    - `sandbox` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required
    - `error` string, nullable, required
    - `result` union
      - SearchResponse
        - `request_id` string, required
        - `metadata` object, required
          - `api_version` 'v1', required
          - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
          - `request_id` string, required
          - `generated_at` string, required
          - `sandbox` boolean
        - `usage` object, required
          - `metered` boolean, required
          - `credits` number, required
          - `percentageCharged` number
          - `remainingPercent` number
          - `resetAt` string
          - `source` 'included' | 'extra' | 'mixed'
          - `allowanceSource` 'weekly' | 'coin'
          - `cached` boolean
          - `idempotencyKey` string
          - `replayed` boolean
          - `sandbox` boolean
        - `events` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `status` 'partial'
        - `warning` string
        - `object` 'search_result', required
        - `hits` object[], required
          - `id` string, required
          - `name` string, required
          - `headline` string
          - `avatarUrl` string, uri
          - `avatarCandidates` string[]
          - `identityContext` 'account' | 'authority' | 'submitted'
          - `avatarContext` 'account' | 'authority' | 'submitted' | 'subject'
          - `initials` string, required
          - `location` string
          - `age` integer
          - `confidence` number, required
          - `tags` string[], required
          - `primaryUsername` string
          - `primaryPlatform` 'instagram' | 'facebook' | 'x' | 'twitter' | 'tiktok' | 'linkedin' | 'youtube' | 'whatsapp' | 'telegram' | 'snapchat' | 'reddit' | 'threads' | 'bluesky' | 'mastodon' | 'pinterest' | 'twitch' | 'discord' | 'tinder' | 'bumble' | 'hinge' | 'onlyfans' | 'fansly' | 'patreon' | 'cameo' | 'vsco' | 'tumblr' | 'flickr' | 'strava' | 'apple_music' | 'bandcamp' | 'lastfm' | 'vimeo' | 'letterboxd' | 'goodreads' | 'quora' | 'github' | 'stack_overflow' | 'hacker_news' | 'npm' | 'kaggle' | 'medium' | 'substack' | 'product_hunt' | 'wellfound' | 'crunchbase' | 'behance' | 'dribbble' | 'soundcloud' | 'spotify' | 'orcid' | 'google_scholar' | 'researchgate' | 'academia' | 'linktree' | 'personal_website' | 'company_page' | 'other'
          - `primaryUrl` string, uri
          - `linkedProfileUrls` string[]
          - `seedEmail` string
          - `seedPhone` string
          - `kind` 'person'
        - `phones` object[]
          - `kind` 'phone', required
          - `id` string, required
          - `e164` string, required
          - `international` string, required
          - `national` string
          - `valid` boolean, required
          - `country` string
          - `countryName` string
          - `lineType` object
            - `value` string, required
            - `source` string, required
            - `tier` string, required
          - `carrier` object
            - `value` string, required
            - `source` string, required
            - `tier` string, required
          - `region` object
            - `value` string, required
            - `source` string, required
            - `tier` string, required
          - `timezones` string[]
          - `capability` object, required
            - `subscriberName` 'found' | 'us-only-no-record' | 'unsupported-country', required
          - `providers` object[], required
            - `name` string, required
            - `status` 'ok' | 'empty' | 'error' | 'unconfigured', required
            - `errorCode` number
      - DossierResponse
        - `request_id` string, required
        - `metadata` object, required
          - `api_version` 'v1', required
          - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
          - `request_id` string, required
          - `generated_at` string, required
          - `sandbox` boolean
        - `usage` object, required
          - `metered` boolean, required
          - `credits` number, required
          - `percentageCharged` number
          - `remainingPercent` number
          - `resetAt` string
          - `source` 'included' | 'extra' | 'mixed'
          - `allowanceSource` 'weekly' | 'coin'
          - `cached` boolean
          - `idempotencyKey` string
          - `replayed` boolean
          - `sandbox` boolean
        - `events` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `status` 'partial'
        - `warning` string
        - `object` 'dossier_result', required
        - `cached` boolean, required
        - `dossier` object, required
          - `summary` string, required
          - `sections` object, required
            - `identity` object
              - …
            - `photos` string[]
            - `contact` object
              - …
            - `socials` object[]
              - …
            - `locations` object
              - …
            - `relatives` object[]
              - …
            - `work` object[]
              - …
            - `education` object[]
              - …
            - `mentions` object[]
              - …
            - `dating` object[]
              - …
            - `relationships` object[]
              - …
          - `sources` object[], required
            - `id` string, required
            - `position` number, required
            - `url` string, required
            - `title` string, required
            - `domain` string, required
            - `snippet` string
            - `authorName` string
            - `authorImageUrl` string
            - `cited` boolean
            - `publishedAt` string
      - ChatResponse
        - `request_id` string, required
        - `metadata` object, required
          - `api_version` 'v1', required
          - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
          - `request_id` string, required
          - `generated_at` string, required
          - `sandbox` boolean
        - `usage` object, required
          - `metered` boolean, required
          - `credits` number, required
          - `percentageCharged` number
          - `remainingPercent` number
          - `resetAt` string
          - `source` 'included' | 'extra' | 'mixed'
          - `allowanceSource` 'weekly' | 'coin'
          - `cached` boolean
          - `idempotencyKey` string
          - `replayed` boolean
          - `sandbox` boolean
        - `events` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `status` 'partial'
        - `warning` string
        - `object` 'chat_result', required
        - `answer` string, required
        - `related_questions` string[], required
      - EntitySearchResponse
        - `request_id` string, required
        - `metadata` object, required
          - `api_version` 'v1', required
          - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
          - `request_id` string, required
          - `generated_at` string, required
          - `sandbox` boolean
        - `usage` object, required
          - `metered` boolean, required
          - `credits` number, required
          - `percentageCharged` number
          - `remainingPercent` number
          - `resetAt` string
          - `source` 'included' | 'extra' | 'mixed'
          - `allowanceSource` 'weekly' | 'coin'
          - `cached` boolean
          - `idempotencyKey` string
          - `replayed` boolean
          - `sandbox` boolean
        - `events` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `status` 'partial'
        - `warning` string
        - `requestId` string, required
        - `object` 'entity_search_result', required
        - `companies` object[], required
          - `id` string, required
          - `name` string, required
          - `legalName` string
          - `headline` string
          - `logoUrl` string, uri
          - `domain` string
          - `initials` string, required
          - `confidence` number, required
          - `tags` string[], required
          - `jurisdiction` string
          - `status` 'active' | 'dissolved' | 'unknown'
          - `seedDomain` string
          - `seedRegistryId` string
          - `seedRegistrySource` string
          - `kind` 'company', required
      - EntityDossierResponse
        - `request_id` string, required
        - `metadata` object, required
          - `api_version` 'v1', required
          - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
          - `request_id` string, required
          - `generated_at` string, required
          - `sandbox` boolean
        - `usage` object, required
          - `metered` boolean, required
          - `credits` number, required
          - `percentageCharged` number
          - `remainingPercent` number
          - `resetAt` string
          - `source` 'included' | 'extra' | 'mixed'
          - `allowanceSource` 'weekly' | 'coin'
          - `cached` boolean
          - `idempotencyKey` string
          - `replayed` boolean
          - `sandbox` boolean
        - `events` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `status` 'partial'
        - `warning` string
        - `requestId` string, required
        - `object` 'entity_dossier_result', required
        - `cached` boolean, required
        - `company` object, required
          - `legalName` string
          - `tradeNames` string[]
          - `website` string
          - `status` 'active' | 'dissolved' | 'unknown', required
          - `registration` object
            - `date` string
            - `jurisdiction` string
            - `registryId` string
            - `entityType` string
            - `registrar` string
            - `legalStatus` string
          - `industry` object, required
            - `naics` object[], required
              - …
            - `sic` object[], required
              - …
            - `label` string
          - `financials` object
            - `revenueEstimate` string
            - `valuation` string
            - `currency` string
          - `funding` object
            - `total` string
            - `rounds` object[], required
              - …
          - `executives` object[], required
            - `name` string, required
            - `title` string
            - `tenure` string
            - `source` string
          - `employeeCount` object
            - `value` number
            - `range` string
            - `asOf` string
          - `locations` object, required
            - `hq` string
            - `offices` string[], required
          - `contact` object, required
            - `phones` string[], required
            - `emails` string[], required
            - `socials` object[], required
              - …
          - `linkage` object, required
            - `parent` string
            - `subsidiaries` string[], required
            - `related` object[], required
              - …
          - `tradeActivity` object
            - `imports` boolean
            - `exports` boolean
            - `hsCodes` string[], required
            - `note` string
          - `mentions` object[], required
            - `title` string, required
            - `url` string, required
            - `source` string, required
            - `snippet` string
            - `date` string
          - `entityId` string, required
          - `name` string, required
          - `summary` string, required
          - `sources` object[], required
            - `id` string, required
            - `position` number, required
            - `url` string, required
            - `title` string, required
            - `domain` string, required
            - `snippet` string
            - `authorName` string
            - `authorImageUrl` string
            - `cited` boolean
            - `publishedAt` string
          - `createdAt` string, required
          - `updatedAt` string, required
      - ReverseImageResponse
        - `request_id` string, required
        - `metadata` object, required
          - `api_version` 'v1', required
          - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
          - `request_id` string, required
          - `generated_at` string, required
          - `sandbox` boolean
        - `usage` object, required
          - `metered` boolean, required
          - `credits` number, required
          - `percentageCharged` number
          - `remainingPercent` number
          - `resetAt` string
          - `source` 'included' | 'extra' | 'mixed'
          - `allowanceSource` 'weekly' | 'coin'
          - `cached` boolean
          - `idempotencyKey` string
          - `replayed` boolean
          - `sandbox` boolean
        - `events` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `status` 'partial'
        - `warning` string
        - `requestId` string, required
        - `object` 'reverse_image_result', required
        - `result` object, required
          - `matches` object[], required
            - `url` string, required
            - `sourceDomain` string, required
            - `title` string
            - `imageUrl` string
            - `thumbnailUrl` string
            - `date` string
            - `snippet` string
            - `matchKind` string
          - `similar` object[], required
            - `imageUrl` string, required
            - `title` string
            - `thumbnailUrl` string
            - `sourceUrl` string
            - `sourceDomain` string
          - `provider` string, required
      - VinResponse
        - `request_id` string, required
        - `metadata` object, required
          - `api_version` 'v1', required
          - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
          - `request_id` string, required
          - `generated_at` string, required
          - `sandbox` boolean
        - `usage` object, required
          - `metered` boolean, required
          - `credits` number, required
          - `percentageCharged` number
          - `remainingPercent` number
          - `resetAt` string
          - `source` 'included' | 'extra' | 'mixed'
          - `allowanceSource` 'weekly' | 'coin'
          - `cached` boolean
          - `idempotencyKey` string
          - `replayed` boolean
          - `sandbox` boolean
        - `events` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `status` 'partial'
        - `warning` string
        - `requestId` string, required
        - `object` 'vin_result', required
        - `cached` boolean, required
        - `vehicle` object, required
          - `vin` string, required
          - `year` number
          - `make` string
          - `model` string
          - `trim` string
          - `headline` string
          - `vehicleType` string
          - `bodyClass` string
          - `manufacturer` string
          - `plant` string
          - `series` string
          - `driveType` string
          - `doors` number
          - `engine` object, required
            - `cylinders` string
            - `displacementL` string
            - `horsepower` string
            - `fuelType` string
            - `transmission` string
            - `electrification` string
          - `safety` object, required
            - `airbags` string[], required
            - `features` string[], required
            - `ratings` object[], required
              - …
          - `recalls` object[], required
            - `campaign` string
            - `component` string
            - `summary` string
            - `remedy` string
            - `reportedDate` string
          - `history` object[], required
            - `type` string, required
            - `date` string
            - `detail` string
            - `source` string
          - `historyProvider` string
          - `summary` string, required
          - `sources` object[], required
            - `id` string, required
            - `position` number, required
            - `url` string, required
            - `title` string, required
            - `domain` string, required
            - `snippet` string
            - `authorName` string
            - `authorImageUrl` string
            - `cited` boolean
            - `publishedAt` string
          - `createdAt` string, required
          - `updatedAt` string, required
    - `links` object, required
      - `self` string, required
      - `events` string, required
      - `cancel` string
  - `next_cursor` string, nullable, required: Pass as `cursor` to fetch the next page. Null on the last page.
  - `has_more` boolean, required: Whether another page exists after this one.

## Other responses

- `400`: The request body was missing, malformed, or failed validation.
- `401`: The API key is missing, invalid, or revoked. The body includes action/url/message - direct the user to sign up and create a key, then retry.
- `402`: The requested capability is unavailable on the user's plan, or included usage and extra credits are exhausted. The body includes action/url/message - direct the user to upgrade, add credits, or wait for the reset, then retry. Agents cannot pay directly.
- `403`: The API key lacks the scope required for this endpoint.
- `409`: The Idempotency-Key was reused with a different request body.
- `413`: The request body is larger than the API accepts.
- `429`: The caller exceeded the API rate limit. Retry after the reset time or Retry-After header.
- `503`: A temporary service-wide spend cap was reached. Retry later.

---

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