---
title: "Inspect current sandbox service-provider earnings"
method: GET
path: "/service-providers/current/earnings"
tags: ["Service provider payments"]
---

# Inspect current sandbox service-provider earnings

`GET /service-providers/current/earnings`

## Request

- Base URL: `https://platform-api.homejourney.sg/v1`
- URL: `https://platform-api.homejourney.sg/v1/service-providers/current/earnings`
- Auth: HTTP bearer

Returns a sandbox-only, ledger-backed provider earnings summary when the authenticated automation client has `services.payments.read`. External URL: `/v1/service-providers/current/earnings`. Current Next.js implementation path: `/api/platform/v1/service-providers/current/earnings`. This read-only route does not require `Idempotency-Key`; SDK, CLI, and MCP provider earnings inspection may call this sandbox route, while live provider payment identity, payout execution, raw Stripe data, card details, bank-account data, and settlement mutations remain deferred.

## Headers

- `X-Correlation-Id` string

## Response `200`

Current sandbox service-provider earnings summary.

- CurrentServiceProviderEarningsResponse
  - `earnings` object, required: Sandbox provider earnings summary backed by ledger source references. Customer PII, card details, Stripe secrets, bank-account data, and raw processor payloads are not returned.
    - `provider_id` string, required
    - `provider_name` string, required
    - `period` object, required
      - `start_date` string, date, required
      - `end_date` string, date, required
      - `timezone` 'Asia/Singapore', required
    - `currency` 'SGD', required
    - `totals` object, required
      - `gross_booking_amount_cents` integer, required
      - `platform_fee_cents` integer, required
      - `net_payable_cents` integer, required
      - `pending_payout_cents` integer, required
      - `paid_payout_cents` integer, required
      - `held_amount_cents` integer, required
      - `adjustment_cents` integer, required
      - `refund_reversal_cents` integer, required
    - `booking_summary` object, required
      - `completed_bookings` integer, required
      - `pending_completion_bookings` integer, required
      - `failed_payments` integer, required
      - `refunded_bookings` integer, required
    - `payout_summary` object, required
      - `next_payout_status` 'ready_for_payout', required
      - `next_payout_eta` string, date, required
      - `last_payout_reference` string, required
      - `failed_payouts` integer, required
    - `ledger_sources` object, required
      - `transactions_table` 'services_transactions', required
      - `payouts_table` 'services_payouts', required
      - `payout_batch_source` 'services_payouts.id', required
      - `refunds_table` 'services_booking_refunds', required
      - `client_side_calculation_used` false, required
      - `fee_schedule_id` 'fee_schedule_transaction_only_2026_06', required
      - `pricing_model` 'transaction_only', required
      - `platform_access_fee_basis_points` 0, required
      - `transaction_fee_rates` object, required
        - `domestic_card` object, required
          - `basis_points` 430, required
          - `fixed_fee_cents` 70, required
        - `paynow` object, required
          - `basis_points` 170, required
          - `fixed_fee_cents` 10, required
      - `marketplace_commission_basis_points` 0, required
      - `standard_payout_fee_cents` 0, required
      - `standard_payout_timing` 'T+30_calendar_days_after_payable_accrual', required
    - `public_safety` object, required
      - `customer_pii_returned` false, required
      - `card_details_returned` false, required
      - `stripe_secret_returned` false, required
      - `bank_account_returned` false, required
      - `raw_processor_payload_returned` false, required
  - `authorization` object, required
    - `organization_id` string, uuid, required
    - `client_id` string, uuid, required
    - `api_key_id` string, uuid, required
    - `granted_service_payment_scopes` PlatformScope[], required
    - `actor_model` 'api_key_automation_client', required
    - `live_payment_identity` 'deferred', required
    - `live_payout_execution` 'admin_controlled', required
    - `sandbox_side_effects` 'blocked', required
  - `principal` Principal, required (unresolved $ref)
  - `livemode` false, required
  - `request_id` string, required

## Other responses

- `400`: Request validation failed.
- `401`: Missing or invalid platform API key.
- `403`: Credential, environment, or scope is not allowed.
- `404`: Platform API feature or resource is not available.
- `429`: Rate limit exceeded.
- `500`: Unexpected platform API failure.

---

[API](https://skmtc.dev/homejourney/apis/homejourney-platform-api.md) · [All operations](https://skmtc.dev/homejourney/apis/homejourney-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/homejourney/apis/homejourney-platform-api/revisions/a2c6fe063db1?raw)