---
title: "List read-only invoice credit-note and chargeback evidence gates"
method: GET
path: "/providers/current/invoice-credit-note-chargeback-gates"
tags: ["Billing"]
---

# List read-only invoice credit-note and chargeback evidence gates

`GET /providers/current/invoice-credit-note-chargeback-gates`

## Request

- Base URL: `https://platform-api.homejourney.sg/v1`
- URL: `https://platform-api.homejourney.sg/v1/providers/current/invoice-credit-note-chargeback-gates`
- Auth: HTTP bearer

Returns invoice credit-note and chargeback evidence gates for all platform launch verticals when the authenticated automation client has `platform.billing_owner_visibility.read`. External URL: `/v1/providers/current/invoice-credit-note-chargeback-gates`. Current Next.js implementation path: `/api/platform/v1/providers/current/invoice-credit-note-chargeback-gates`. This read-only route does not require `Idempotency-Key`; it exposes payment-collection gate, refund/dispute gate, credit-note policy, chargeback evidence policy, adjustment ledger, processor credit-note, customer-notice, support-owner, and audit prerequisites; blocked credit-note, chargeback evidence, chargeback provider, payment, quota, and credential side effects; hidden payment-method, credit-note, and chargeback evidence payload posture; and next operator actions only. It never reads usage event tables or partner-facing billing tables, returns raw usage payloads, raw payment payloads, payment method payloads, credit-note payloads, chargeback evidence payloads, chargeback payloads, or processor payloads, sends invoices, records delivery receipts, collects payments, mutates credit notes or chargeback evidence, enforces quota, suspends credentials, or calls external finance providers.

## Headers

- `X-Correlation-Id` string

## Response `200`

Read-only invoice credit-note and chargeback evidence gates.

- InvoiceCreditNoteChargebackGatesResponse
  - `invoice_credit_note_chargeback_gates` InvoiceCreditNoteChargebackGate[], required
    - `module_id` 'agent' | 'agency' | 'business' | 'mortgage' | 'legal' | 'developer' | 'renovation', required
    - `label` string, required
    - `workspace_root` string, required
    - `invoice_id` string, required
    - `billing_account_org_id` string, required
    - `billing_account_client_id` string, required
    - `billing_owner` string, required
    - `invoice_contact` string, email, required
    - `billing_period` string, required
    - `currency` string, required
    - `invoice_state` 'draft' | 'review_required' | 'approved' | 'issued' | 'paid' | 'partially_paid' | 'voided' | 'credited' | 'disputed' | 'uncollectible', required
    - `payment_terms` string, required
    - `credit_note_mode` 'manual_credit_note_review_blocked', required
    - `chargeback_evidence_mode` 'support_owner_evidence_review_blocked', required
    - `credit_note_decision` 'blocked_until_policy_ledger_and_notice_proof', required
    - `chargeback_evidence_decision` 'blocked_until_evidence_policy_support_and_audit_proof', required
    - `required_scope` 'platform.billing_owner_visibility.read', required
    - `satisfied_prerequisites` string[], required
    - `missing_prerequisites` string[], required
    - `credit_note_workflow_ready` false, required
    - `chargeback_evidence_ready` false, required
    - `adjustment_ledger_ready` false, required
    - `credit_note_mutation_allowed` false, required
    - `chargeback_evidence_mutation_allowed` false, required
    - `processor_credit_note_call_allowed` false, required
    - `chargeback_provider_call_allowed` false, required
    - `payment_method_payload_visible` false, required
    - `credit_note_payload_visible` false, required
    - `chargeback_evidence_payload_visible` false, required
    - `customer_notice_ready` false, required
    - `support_owner_review_ready` false, required
    - `invoice_external_send_allowed` false, required
    - `payment_collection_allowed` false, required
    - `finance_provider_call_allowed` false, required
    - `quota_enforcement_allowed` false, required
    - `credential_suspension_allowed` false, required
    - `billing_write_mutations_enabled` false, required
    - `proof_command` string, required
    - `evidence_path` string, required
    - `blocker` string, required
    - `next_action` string, required
  - `summary` InvoiceCreditNoteChargebackGatesAggregate, required
    - `total_verticals` integer, required
    - `plan_state_visible` integer, required
    - `billing_owner_visible` integer, required
    - `invoice_contact_visible` integer, required
    - `billing_owner_visibility_gates` integer, required
    - `partner_billing_table_reads_deferred` integer, required
    - `usage_events_present` integer, required
    - `customer_visible_usage_summaries` integer, required
    - `automatic_overage_enforcement_blocked` integer, required
    - `billing_owner_gate_side_effects_blocked` integer, required
    - `launch_ready_contracts` integer, required
    - `source_contract` 'vertical_billing_usage_contract', required
    - `invoice_credit_note_chargeback_contract` 'invoice_credit_note_chargeback_blocked_v1', required
    - `credit_note_chargeback_gates_declared` integer, required
    - `credit_note_workflows_ready` integer, required
    - `chargeback_evidence_ready` integer, required
    - `credit_note_mutations_blocked` integer, required
    - `chargeback_evidence_mutations_blocked` integer, required
    - `processor_credit_note_calls_blocked` integer, required
    - `chargeback_provider_calls_blocked` integer, required
    - `credit_note_payloads_visible` integer, required
    - `chargeback_evidence_payloads_visible` integer, required
    - `adjustment_ledgers_ready` integer, required
    - `support_escalations_required` integer, required
    - `finance_provider_calls_blocked` integer, required
  - `authorization` InvoiceCreditNoteChargebackGatesAuthorization, required
    - `organization_id` string, uuid, required
    - `client_id` string, uuid, required
    - `api_key_id` string, uuid, required
    - `required_scope` 'platform.billing_owner_visibility.read', required
    - `granted_billing_scopes` PlatformScope[], required
    - `actor_model` 'api_key_automation_client', required
    - `data_access` 'invoice_credit_note_chargeback_gate_contract_only', required
    - `table_access` 'no_usage_event_or_partner_billing_table_reads', required
    - `mutation_access` 'billing_writes_deferred', required
  - `public_safety` InvoiceCreditNoteChargebackGatesPublicSafety, required
    - `usage_event_table_reads_allowed` false, required
    - `partner_billing_table_reads_allowed` false, required
    - `raw_usage_event_payload_visible` false, required
    - `raw_payment_payload_visible` false, required
    - `payment_method_payload_visible` false, required
    - `credit_note_payload_visible` false, required
    - `chargeback_evidence_payload_visible` false, required
    - `processor_credit_note_call_allowed` false, required
    - `chargeback_provider_call_allowed` false, required
    - `credit_note_mutation_allowed` false, required
    - `chargeback_evidence_mutation_allowed` false, required
    - `credit_note_chargeback_mutations_enabled` false, required
    - `invoice_external_send_allowed` false, required
    - `payment_collection_allowed` false, required
    - `finance_provider_call_allowed` false, required
    - `quota_enforcement_allowed` false, required
    - `credential_suspension_allowed` false, required
    - `external_finance_calls` false, required
    - `billing_write_mutations_enabled` false, required
  - `principal` Principal, required (unresolved $ref)
  - `livemode` boolean, 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)