---
title: "POST /billing/{tenantLocator}/accounts/{accountLocator}/charges"
method: POST
path: "/billing/{tenantLocator}/accounts/{accountLocator}/charges"
---

# POST /billing/{tenantLocator}/accounts/{accountLocator}/charges

`POST /billing/{tenantLocator}/accounts/{accountLocator}/charges`

## Request

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

## Path parameters

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

## Request body

- ChargesCreateRequest
  - `policyLocator` string, ulid
  - `invoicing` 'scheduled' | 'next' | 'immediate'
  - `currency` string
  - `charges` ChargeCreateRequest[], required
    - `amount` number, required
    - `chargeType` string, required
    - `transactionLocator` string, ulid
    - `elementLocator` string, ulid
    - `elementStaticLocator` string, ulid
    - `tag` string

## Response `200`

OK

- ChargeResponse[]
  - `locator` string, ulid, required
  - `amount` number, required
  - `currency` string, required
  - `chargeCategory` 'none' | 'premium' | 'tax' | 'fee' | 'credit' | 'invoiceFee' | 'cededPremium' | 'nonFinancial' | 'surcharge', required
  - `chargeType` string, required
  - `chargeInvoicing` 'scheduled' | 'next' | 'immediate', required
  - `accountLocator` string, ulid, required
  - `tag` string
  - `policyLocator` string, ulid
  - `transactionLocator` string, ulid
  - `elementLocator` string, ulid
  - `elementStaticLocator` string, ulid
  - `reversalOfLocator` string, ulid
  - `bundleTransactionLocator` string, ulid

---

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