---
title: "PATCH /policy/{tenantLocator}/transactions/{locator}/price"
method: PATCH
path: "/policy/{tenantLocator}/transactions/{locator}/price"
---

# PATCH /policy/{tenantLocator}/transactions/{locator}/price

`PATCH /policy/{tenantLocator}/transactions/{locator}/price`

## Request

- Base URL: `https://docs.socotra.com`
- URL: `https://docs.socotra.com/policy/{tenantLocator}/transactions/{locator}/price`
- Auth: none declared
- TypeScript: <https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/docs/policy/:tenantLocator/transactions/:locator/price/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `tenantLocator` string, uuid, required
- `locator` string, ulid, required

## Query parameters

- `stateless` boolean

## Response `200`

OK

- TransactionPriceResponse
  - `locator` string, ulid, required
  - `policyLocator` string, ulid, required
  - `transactionCategory` 'issuance' | 'change' | 'renewal' | 'cancellation' | 'continuation' | 'flatCancellation' | 'reinstatement' | 'reversal' | 'aggregate', required
  - `transactionState` 'draft' | 'initialized' | 'validated' | 'earlyUnderwritten' | 'priced' | 'underwritten' | 'accepted' | 'issued' | 'underwrittenBlocked' | 'declined' | 'rejected' | 'refused' | 'discarded' | 'invalidated' | 'reversed', required
  - `effectiveTime` string, date-time, required
  - `charges` PolicyChargeResponse[], required
    - `locator` string, ulid, required
    - `elementLocator` string, ulid, required
    - `chargeType` string, required
    - `chargeCategory` 'none' | 'premium' | 'tax' | 'fee' | 'credit' | 'invoiceFee' | 'cededPremium' | 'nonFinancial' | 'surcharge', required
    - `amount` number, required
    - `rate` number, required
    - `referenceRate` number, required
    - `tag` string
    - `rateDifference` number
    - `elementStaticLocator` string, ulid, required
    - `reversalOfLocator` string, ulid
    - `handling` 'flat' | 'normal' | 'retention', required
    - `invoicing` 'scheduled' | 'next' | 'immediate', required
  - `aggregatedTransactions` TransactionPriceResponse[]
  - `validationResult` ValidationResult
    - `validationItems` ValidationItemResponse[]
      - `elementType` string, required
      - `locator` string, ulid, required
      - `errors` string[], required
    - `success` boolean, required

---

[API](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi.md) - [All operations](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/revisions/6537d24b3693?raw)