---
title: "create pricing-category"
method: POST
path: "/ops/pricing_categories"
tags: ["ops"]
---

# create pricing-category

`POST /ops/pricing_categories`

Create new pricing categories

## Request body

- CreateRequestBody
  - `pricing_category` NewPricingCategory
    - `description` string — description of the pricing category
    - `headrooms` Headroom[], required — the headrooms for the pricing category
      - `expected_residual_value_ratio` number, double, required — Expected residual value ratio for this tenure
      - `headroom_ratio` number, double, required — Headroom ratio applied to this product for this tenure
      - `is_default` boolean, required — Whether this tenure is the default tenure
      - `tenure` integer, required — The tenure in months (6, 12, 24, or 36)
    - `identifier` string, required — name of the pricing category
    - `services` NewPricingCategoryService[], required — the services for the pricing category
      - `name` string, required — name of the service
      - `service_prices` NewPricingCategoryServicePrice[], required — the prices for the service per tenure
        - `kind` string, required — the price of the service price
        - `price` number, double — price of the service for this tenure
        - `tenure` integer, required — the tenure for this price

## Response `201`

Created response.

- PricingCategoryResult
  - `pricing_category` PricingCategory
    - `description` string — description of the pricing category
    - `headrooms` Headroom[], required — the headrooms for the pricing category
      - `expected_residual_value_ratio` number, double, required — Expected residual value ratio for this tenure
      - `headroom_ratio` number, double, required — Headroom ratio applied to this product for this tenure
      - `is_default` boolean, required — Whether this tenure is the default tenure
      - `tenure` integer, required — The tenure in months (6, 12, 24, or 36)
    - `id` string, regexp, required — topi pricing category ID
    - `identifier` string, required — name of the pricing category
    - `services` PricingCategoryService[], required — the services for the pricing category
      - `id` string, regexp, required — topi service ID
      - `name` string, required — name of the service
      - `service_prices` PricingCategoryServicePrice[], required — the prices for the service per tenure
        - `id` string, regexp, required — topi servicePrice ID
        - `kind` string, required — the price of the service price
        - `price` number, double — price of the service for this tenure
        - `tenure` integer, required — the tenure for this price

## Other responses

- `400` — BadRequest: Bad Request response.
- `401` — Unauthorized: Unauthorized response.
- `403` — InvalidScopes: Forbidden response.

---

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