---
title: "List follower orders"
method: GET
path: "/api/v1/followers/orders"
tags: ["Followers"]
---

# List follower orders

`GET /api/v1/followers/orders`

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/followers/orders`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Orders list

- object
  - `ok` boolean
  - `orders` FollowerOrder[]
    - `orderId` string
    - `status` 'pending_payment' | 'in_progress' | 'completed' | 'cancelled'
    - `linkedin_company_url` string
    - `company_name` string
    - `requested_count` integer
    - `amount_cents` integer
    - `delivery_email` string
    - `csvUrl` string, uri
    - `createdAt` string, date-time
    - `completedAt` string, date-time
    - `filters` object
  - `pagination` object
    - `page` integer
    - `pageSize` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `401`: Missing or invalid API key

---

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