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

# List developer OAuth billing charges

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

Requires business auth with `business:manage_developer_settings`.

## Query parameters

- `page_size` integer
- `next_cursor` string
- `previous_cursor` string
- `oauth_application_id` integer
- `oauth_authorized_business_id` integer
- `merchant_business_id` integer
- `billing_tag` string
- `action_key` string
- `billing_idempotency_key` string
- `request_id` string

## Response `200`

OAuth billing charge collection

- OAuthBillingChargeCollectionResponseBody — Paginated list payload for v3.
  - `data` OAuthBillingCharge[], required
    - `id` string, uuid
    - `timestamp` string, date-time
    - `captured_at` string, date-time, nullable
    - `billing_tag` string
    - `billing_idempotency_key` string
    - `action_key` string
    - `gross_amount` integer
    - `platform_fee_bps` integer
    - `platform_fee_amount` integer
    - `developer_net_amount` integer
    - `currency` string
    - `reservation_id` string, uuid
    - `request_id` string, nullable
    - `metadata` object
    - `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
    - `oauth_application_id` integer
    - `oauth_authorized_business_id` integer
    - `merchant_business_id` integer
    - `developer_business_id` integer
  - `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/730030bd6477/schema)