# Get Settled Charge Details

Retrieve details of a specific settled charge.

Includes frozen snapshots of:
- resolvedRate - Rate details at time of settlement
- resolvedAllocation - Allocation details at time of settlement
- consolidatedTags - Tags from all sources (profile, rate, subscription, charge)

Endpoint: GET /settledCharges/{settledChargeId}
Version: 1.0.0
Security: OAuth2

## Path parameters:

  - `settledChargeId` (string, required)
    Unique identifier for the settled charge

## Response 200 fields (application/json):

  - `id` (string, required)

  - `originalChargeId` (string, required)

  - `entityId` (string, required)

  - `billableEntityId` (string, required)

  - `accountId` (string, required)

  - `invoiceId` (string,null)

  - `rateId` (string)
    Rate used for this charge

  - `quantity` (number)
    Quantity billed

  - `amount` (integer)
    Full charge amount before proration (cents)

  - `prorationFactor` (number)
    Proration factor (0.0-1.0)

  - `proratedAmount` (integer)
    Amount after proration (cents)

  - `netAmount` (integer)
    Final amount after discounts (cents)

  - `discountRateIds` (array)
    Discount rates applied

  - `discountAmounts` (array)
    Discount amounts in cents (parallel to discountRateIds)

  - `allocationConfigId` (string,null)
    Allocation configuration used

  - `rateVersion` (integer)
    Version of rate at settlement time

  - `subscriptionVersion` (integer,null)
    Version of subscription at settlement time

  - `allocationVersion` (integer,null)
    Version of allocation config at settlement time

  - `discountRateVersions` (array)
    Versions of discount rates at settlement time

  - `settlementType` (string, required)
    How the charge was settled
    Enum: "INVOICED", "DIRECT_PAYMENT"

  - `status` (string, required)
    Status of settled (immutable) charge
    Enum: "INVOICED", "PARTIALLY_PAID", "PAID", "REFUNDED", "VOID"

  - `originalAmount` (integer, required)
    Original charge amount in cents

  - `resolvedAmount` (integer, required)
    Amount after allocation resolution in cents

  - `amountPaid` (integer, required)
    Amount paid so far in cents

  - `amountOutstanding` (integer, required)
    Remaining amount in cents

  - `resolvedAllocation` (object)
    Frozen snapshot of allocation at settlement time

  - `resolvedRate` (object)
    Frozen snapshot of rate at settlement time

  - `consolidatedTags` (object)
    Tags consolidated from all sources with prefixes:
- profile.billableEntity.*
- profile.account.*
- billing.rate.*
- billing.subscription.*
- billing.charge.*

  - `settledAt` (string, required)

  - `optimisticLockVersion` (integer)
    Optimistic locking version (managed by Hibernate @Version). Prevents concurrent update conflicts.

  - `createdAt` (string, required)

## Response 401 fields (application/json):

  - `result` (object, required)

  - `result.status` (string, required)
    Response status (always ERROR for error responses)
    Enum: "ERROR"

  - `error` (object, required)

  - `error.responseCode` (string, required)
    Response code (numeric or contains numbers, e.g., "404", "409", "500", "ERR001")
    Example: "404"

  - `error.responseMessage` (array, required)
    Array of error message strings for multiple error details
    Example: ["Charge not found","The requested charge ID does not exist in the system"]

## Response 404 fields (application/json):

  - `result` (object, required)

  - `result.status` (string, required)
    Response status (always ERROR for error responses)
    Enum: "ERROR"

  - `error` (object, required)

  - `error.responseCode` (string, required)
    Response code (numeric or contains numbers, e.g., "404", "409", "500", "ERR001")
    Example: "404"

  - `error.responseMessage` (array, required)
    Array of error message strings for multiple error details
    Example: ["Charge not found","The requested charge ID does not exist in the system"]