Skip to content

Price ​

INFO

Every response arrives in the shared envelope — code, message, messages, status_code, time — with the payload in data. The tables below describe what is inside data.

GET /price/get-all ​

Get all prices

Query parameters

ParameterTypeRequiredDescription
statusstringNoOne of: active, inactive
typestringNoOne of: sale, income
currency_idstringNo
searchstringNo

Request body

No request body.

Response

json
{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": [],
  "time": "2025-05-01T12:00:00Z"
}

POST /price/items/get-paging ​

Price items

Request body

FieldTypeRequiredDescription
pagenumberYesDefault: 1
limitnumberYesDefault: 20
organization_idstringNo
price_idstringNo
product_idstringNo
json
{
  "page": 1,
  "limit": 20,
  "organization_id": "string",
  "price_id": "string",
  "product_id": "string"
}

Response

Same response shape as GET /price/get-all.

GET /price/get-by-id/{id} ​

Get a price by its _id.

Path parameters

ParameterTypeRequiredDescription
idstringYes

Request body

No request body.

Response

FieldTypeDescription
_idstringThe ID of the price
codestringThe code of the price
short_namestringThe short name of the price
namestringThe name of the price
currency_idstringThe currency ID of the price
statusstringThe status of the price. One of: active, inactive
typestringThe type of the price. One of: sale, income
updated_bystringThe ID of the user who updated the price
is_defaultbooleanWhether the price is the default price
can_be_updatedbooleanWhether the price can be updated
is_mainbooleanWhether the price is the main price
has_accessbooleanWhether the price has access
employee_idsstring[]The IDs of the employees who have access to the price
json
{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "_id": "string",
    "code": "string",
    "short_name": "string",
    "name": "string",
    "currency_id": "string",
    "status": "active",
    "type": "sale",
    "updated_by": "string",
    "is_default": false,
    "can_be_updated": false,
    "is_main": false,
    "has_access": false,
    "employee_ids": [
      "string"
    ]
  },
  "time": "2025-05-01T12:00:00Z"
}

This page is generated from the OpenAPI spec.

Bito 2.0 Integration API