---
title: "Return Transaction"
method: POST
path: "/add"
---

# Return Transaction

`POST /add`

Lets you submit a return transaction of any transaction type.

## Request body

- object
  - `transaction type` string — The type of transaction.
  - `country` string — The country in which the transaction took place.
  - `number` string — The unique identifier for the transaction.
  - `not_interested_reason` string — The reason provided for the return transaction.
  - `return_type` string — The type of return.
  - `parent_bill_number` string — The original bill number associated with the transaction.
  - `purchase_time` string — The date of the original purchase.
  - `amount` string — The amount associated with the return.
  - `billing_time` string — The time the bill was issued.
  - `customer mobile` string — The mobile number of the customer.
  - `customer email` string — The email address of the customer.
  - `customer external_id` string — An external identifier for the customer.
  - `customer firstname` string — The customer's first name.
  - `customer lastname` string — The customer's last name.
  - `line_item serial` string — The serial number of the item.
  - `line_item amount` string — The amount for the line item.
  - `line_item description` string — The description of the line item.
  - `line_item item_code` string — The unique code associated with the line item.
  - `line_item qty` string — The quantity of the line item.
  - `line_item rate` string — The rate of the line item.
  - `line_item value` string — The value of the line item.
  - `line_item attribute name` string — The attribute name of the line item.
  - `line_item attribute value` string — The attribute value of the line item.
  - `custom_data_item field_name` string — The custom field name.
  - `custom_data_item field_value` string — The value associated with the custom field.
  - `id` integer — Transaction ID of the transaction that needs to be returned.

## Response `200`

200

- union
  - object
    - `response` object
      - `status` object
        - `success` string
        - `code` integer
        - `message` string
      - `transactions` object
        - `transaction` unknown[]
          - unknown
  - object
    - `response` object
      - `status` object
        - `success` string
        - `code` integer
        - `message` string
      - `transactions` object
        - `transaction` object[]
          - `id` integer
          - `shipping_source_till_code` string
          - `number` string
          - `bill_client_id` string
          - `type` string
          - `delivery_status` string
          - `parent_bill_number` string
          - `outlier_status` string
          - `customer` object
            - `user_id` string
            - `mobile` string
            - `firstname` string
            - `lastname` string
            - `email` string
            - `external_id` string
            - `lifetime_points` string
            - `loyalty_points` string
            - `current_slab` string
            - `tier_expiry_date` string
            - `points_summaries` object
              - …
            - `lifetime_purchases` string
            - `type` string
            - `source` string
          - `side_effects` object
            - `effect` unknown[]
              - …
          - `points_deducted` integer
          - `points_balance` integer
          - `source` string
          - `item_status` object
            - `success` string
            - `code` integer
            - `message` string

## Other responses

- `400` — 400

---

[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)