---
title: "GET /tasks"
method: GET
path: "/tasks"
tags: ["tasks"]
---

# GET /tasks

`GET /tasks`

## Request

- Base URL: `https://api.mrscraper.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mrscraper.com/tasks`
- Auth: one of:
  - API key in header `x-api-token`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/mrscraper/apis/scraper-service-gateway-api/docs/tasks/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `pageSize` integer
- `page` integer
- `sortField` string
- `sortOrder` string
- `search` string
- `startAt` string, required
- `endAt` string, required
- `dateRangeColumn` string
- `domain` string
- `action` string
- `status` string
- `jobId` integer
- `isParent` boolean
- `countOnly` boolean

## Response `200`

Paginated tasks; countOnly=true returns an empty data array

- object
  - `data` TaskTask[]
    - `action` string
    - `browserType` 'CHROME' | 'FIREFOX' | 'SAFARI'
    - `callbackUrl` string
    - `createdAt` string
    - `deviceOs` 'WINDOWS' | 'MACOS' | 'LINUX'
    - `domain` string
    - `fingerprintId` integer
    - `id` integer
    - `jobId` integer
    - `proxy` string
    - `result` string
    - `retryCount` integer
    - `scrapeTime` number
    - `solution` string
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED'
    - `statusMessage` string
    - `taskDetails` object
    - `updatedAt` string
    - `userId` string
  - `meta` ApiTPaginationMeta
    - `page` integer
    - `pageSize` integer
    - `total` integer
    - `totalPage` integer

---

[API](https://skmtc.dev/mrscraper/apis/scraper-service-gateway-api.md) - [All operations](https://skmtc.dev/mrscraper/apis/scraper-service-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mrscraper/apis/scraper-service-gateway-api/revisions/8bc866001a0b?raw)