---
title: "Place follower export order"
method: POST
path: "/api/v1/followers/orders"
tags: ["Followers"]
---

# Place follower export order

`POST /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

Place an order to export LinkedIn followers. Debits from wallet balance.

## Request body

- object
  - `linkedin_company_url` string, uri, required
  - `requested_count` integer
  - `delivery_email` string, email
  - `email` string, email: Alias for delivery_email.
  - `filters` object
    - `companySizes` string[]
    - `seniorities` string[]
    - `countries` string[]

## Response `201`

Order created

- object
  - `ok` boolean
  - `order` 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

## Other responses

- `401`: Missing or invalid API key
- `402`: Insufficient wallet balance

---

[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)