# Get Rate Card Details

Retrieve details of a specific rate card including associated rates

Endpoint: GET /rateCards/{rateCardId}
Version: 1.0.0
Security: OAuth2

## Path parameters:

  - `rateCardId` (string, required)
    Unique identifier for the rate card

## Response 200 fields (application/json):

  - `id` (string, required)

  - `entityId` (string, required)

  - `name` (string, required)

  - `scope` (string, required)
    Scope of rate card availability
    Enum: "MERCHANT", "ACCOUNT"

  - `tags` (object)

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

  - `createdAt` (string, required)

  - `updatedAt` (string)

  - `rates` (array)

  - `rates.rate` (object)

  - `rates.rate.id` (string, required)
    Unique identifier

  - `rates.rate.entityId` (string, required)
    Merchant identifier (from auth context)

  - `rates.rate.description` (string, required)
    Human-readable description of the rate

  - `rates.rate.type` (string, required)
    Type of rate
    Enum: "service fee", "LATE_FEE", "REGISTRATION", "DISCOUNT", "OTHER"

  - `rates.rate.pricePerUnit` (integer)
    Price per unit in cents (e.g., 5000 = $50.00). Required unless type is DISCOUNT.

  - `rates.rate.discountPercentage` (number)
    Discount percentage (only for type DISCOUNT)

  - `rates.rate.tags` (object)
    Tags for categorization and reporting

  - `rates.rate.version` (integer)
    Business version number for audit history and deterministic billing (auto-incremented on updates)

  - `rates.displayOrder` (integer)

  - `rates.addedAt` (string)

## 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"]