---
title: "Meta Ads payout history"
method: GET
path: "/meta-ads/payouts/history"
tags: ["Meta Ads"]
---

# Meta Ads payout history

`GET /meta-ads/payouts/history`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/meta-ads/payouts/history`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Logged payouts to creators for the shop's Meta Ads rev-share, newest first. Each row is one payout (amount, method, Stripe transfer id, timestamp); method 'manual' is a payout the brand made outside Reacher. All cents are in the shop's Meta ad account currency. Single shop only.

## Query parameters

- `limit` integer: Max rows to return.

## Response `200`

Successful Response

- MetaAdsPayoutHistoryResponse
  - `history` MetaAdsPayoutHistoryItem[]
    - `payout_id` string, required: Payout (transfer log) id.
    - `id` string, required: Deprecated alias of `payout_id`; use `payout_id`.
    - `creator_id` string, required
    - `creator_handle` string, nullable
    - `creator_name` string, nullable
    - `amount_cents` integer, required
    - `method` string, required: 'stripe' for a transfer through Reacher, or 'manual' for a payout the brand made outside Reacher and marked paid (no transfer id).
    - `stripe_transfer_id` string, nullable
    - `created_at` string, required
  - `currency` string, nullable: ISO 4217 currency of the shop's connected Meta ad account.

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-19** `291230805105`: 3 info
  - api operation id `payout_history_meta_ads_payouts_history_get` removed and replaced with `meta_ads_payout_history`
  - response property `history/items/id` deprecated
  - added the required property `history/items/payout_id` to the response with the `200` status

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/meta-ads/payouts/history/get.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)