---
title: "Simulation transaction add"
method: POST
path: "/simulation/transactions"
---

# Simulation transaction add

`POST /simulation/transactions`

Lets you perform the simulation of the Transaction Add.

## Query parameters

- `identifierName` 'mobile' | 'email' | 'externalId' | 'id' | 'wechat' | 'martjackId' | 'fbId' | 'cardnumber' | 'cardExternalId', required
- `identifierValue` string, required

## Headers

- `X-CAP-DIRECT-REPLAY` boolean

## Request body

- object
  - `type` 'REGULAR' | 'RETURN' | 'MIXED', required
  - `billAmount` number, float, required — Bill Amount is the net transaction value.
  - `billNumber` string, required — Bill Number

## Response `200`

200

- object
  - `warnings` unknown[]
    - unknown
  - `errors` unknown[]
    - unknown
  - `sideEffects` object[]
    - `entityType` string
    - `rawAwardedPoints` number
    - `awardedPoints` integer
    - `type` string
  - `simulatedPointsBreakup` object
    - `eventLogId` integer
    - `eventName` string
    - `eventDetails` object
      - `maxConversionDate` string
      - `eventTime` string
      - `tillId` integer
    - `billDetails` object
      - `type` string
      - `billNumber` string
      - `billAmount` integer
      - `note` string
      - `pointsEarned` object
        - `regular` unknown[]
          - unknown
        - `promo` unknown[]
          - unknown
        - `promised` object[]
          - `value` integer
          - `conversionDate` string
          - `programId` integer
          - `programName` string
      - `lineItems` object[]
        - `id` integer
        - `itemCode` string
        - `grossAmount` integer
        - `discount` integer
        - `amount` integer
        - `rate` integer
        - `qty` integer
        - `pointsEarned` object
          - `regular` object[]
            - `value` integer
            - `expiresOn` string
            - `programId` integer
            - `programName` string
            - `expiryType` string
          - `promo` unknown[]
            - unknown
          - `promised` unknown[]
            - unknown
    - `customFields` unknown[]
      - unknown
    - `extendedFields` object[]
      - `name` string
      - `value` string
    - `paymentModes` unknown[]
      - unknown
    - `pointInTimeSlabs` object[]
      - `pointInTimeSlabNumber` integer
      - `pointInTimeSlabName` string
      - `programId` integer
      - `isDefaultProgram` boolean

## Other responses

- `403` — 403

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/versions/de241f2ed9b3/schema)