---
title: "List developer OAuth billing earnings ledger entries"
method: GET
path: "/v3/developer/oauth-billing/ledger"
tags: ["OAuth Billing"]
---

# List developer OAuth billing earnings ledger entries

`GET /v3/developer/oauth-billing/ledger`

Requires business auth with `business:manage_developer_settings`.

## Query parameters

- `page_size` integer
- `next_cursor` string
- `previous_cursor` string
- `oauth_application_id` integer
- `entry_type` 'accrual' | 'withdrawal' | 'adjustment'

## Response `200`

OAuth billing earnings ledger collection

- OAuthBillingLedgerCollectionResponseBody — Paginated list payload for v3.
  - `data` OAuthBillingEarningsEntry[], required
    - `id` string, uuid
    - `timestamp` string, date-time
    - `entry_type` string
    - `amount` integer
    - `currency` string
    - `balance_before` integer
    - `balance_after` integer
    - `description` string
    - `charge_id` string, uuid, nullable
    - `settlement_id` string, uuid, nullable
    - `business_id` integer
    - `oauth_application_id` integer, nullable
    - `capture_context` OAuthBillingCaptureContext — Safe OAuth app billing capture summary returned on developer-facing billing reservation, billing charge, and developer earnings ledger payloads. Raw request/response bodies, headers, customer message text, and raw webhook payloads are intentionally excluded.
      - `application_id` integer, nullable
      - `application_name` string, nullable
      - `billing_tag` string, nullable
      - `action_key` string, nullable
      - `action_label` string, nullable
      - `reservation_id` string, nullable
      - `charge_id` string, nullable
      - `request_id` string, nullable
      - `billing_idempotency_key` string, nullable
      - `merchant_business_id` integer, nullable
      - `developer_business_id` integer, nullable
      - `oauth_authorized_business_id` integer, nullable
      - `gross_amount` integer, nullable
      - `platform_fee_amount` integer, nullable
      - `developer_net_amount` integer, nullable
      - `currency` string, nullable
      - `response_status` integer, nullable
    - `metadata` object
  - `is_paginated` true, required
  - `has_next` boolean
  - `has_previous` boolean
  - `next_cursor` string, nullable
  - `previous_cursor` string, nullable
  - `page_size` integer

## Other responses

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

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/versions/4354959d76dc/schema)