---
title: "Get My Listing Earnings"
method: GET
path: "/v1/marketplace/publisher/earnings"
tags: ["Marketplace"]
---

# Get My Listing Earnings

`GET /v1/marketplace/publisher/earnings`

## Request

- Base URL: `https://api.mixpeek.com`
- URL: `https://api.mixpeek.com/v1/marketplace/publisher/earnings`
- Auth: HTTP bearer

What your listings earned: calls, the per-call price charged and your
share, by month and listing, with the payouts sent.

You keep 80% of each listing's per-call price; the caller pays the compute
each call uses. `paid` says whether a month is covered by a payout yet.

## Response `200`

Successful Response

- PublisherEarningsResponse: What the organization's listings earned, and what has been paid.
  - `months` PublisherEarningsMonth[]
    - `period` string, required: Billing month, YYYY-MM
    - `listing_id` string, required: The listing
    - `calls` integer, required: Priced calls in the month
    - `price_credits` integer, required: Per-call price charged to callers
    - `publisher_share_credits` integer, required: Your 80% share, in credits
    - `publisher_share_usd` number, required: Your share at the list rate
    - `paid` boolean, required: Whether a payout covers this month
  - `payouts` PublisherPayout[]
    - `transfer_id` string, nullable: Stripe transfer id
    - `amount_usd` number, required: Amount sent
    - `periods` string[]: Months it covers
    - `created_at` unknown
  - `payout_account_connected` boolean, required: Whether a payout account exists for this organization

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-11-11** `c52e631995d0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/marketplace/publisher/earnings/get.md)

---

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