---
title: "Get due payout stats"
method: GET
path: "/payouts/due_stats"
---

# Get due payout stats

`GET /payouts/due_stats`

This endpoint returns statistics about due payouts. 
 <Tip>**HTTP Request** <br/>`GET https://api.firstpromoter.com/api/v2/company/payouts/due_stats`</Tip>

## Query parameters

- `q` string
- `filters[status]` 'pending' | 'completed' | 'failed' | 'processing' | 'cancelled'
- `filters[campaign_id]` union
  - integer
  - integer[]

## Headers

- `Account-ID` string, required

## Response `200`

Successful response

- PayoutDueStats
  - `meta` object
    - `net_payout_days` integer — Number of days for net payout
    - `payout_cycle` string — Payout cycle (e.g., monthly)
    - `min_payment` integer — Minimum payment amount
    - `min_paying_customers` integer — Minimum number of paying customers
    - `terms_description` string — Description of payment terms
    - `selected_payout_methods` string[] — List of selected payout methods
    - `payout_method_options` object — Options for payout methods
    - `managed_payouts` boolean — Whether payouts are managed by us (auto-payouts)
  - `data` object
    - `next` object
      - `promoters_count` integer — Count of promoters
      - `amounts` object — Amounts by currency or unit
      - `total_incl_tax` number — Total amount including tax
      - `due_date` string, date — Due date for the next payout
      - `period_end` string, date — End date of the period
    - `overdue` object
      - `promoters_count` integer — Count of promoters
      - `amounts` object — Amounts by currency or unit
      - `total_incl_tax` number — Total amount including tax
      - `due_date` string, date — Due date for overdue payout
      - `period_end` string, date — End date of the period
    - `custom` object
      - `promoters_count` integer — Count of promoters
      - `amounts` object — Amounts by currency or unit
      - `total_incl_tax` number — Total amount including tax

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/firstpromoter/apis/firstpromoter-batch-processes-api.md) · [All operations](https://skmtc.net/firstpromoter/apis/firstpromoter-batch-processes-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firstpromoter/firstpromoter-batch-processes-api/versions/e15f0d026ccf/schema)
