KERN ERP API: masters | Codeverse Developers

✦Developers

KERN ERP API — Masters

Masters, products and styles, Buyer POs, purchase orders, GRNs, sales invoices, packing slips and stock.

Version 2026-10-09.1 · published 9 Oct 2026 · 105 APIs

Base URL https://kronex.codeverse.co/cedge

Download: OpenAPI (JSON) · Postman collection · Guides · Changelog

Masters

Grouped by screen, as in the app. Scope for the whole module: erp.masters.*:read or :write.

Vendor & Customer

Access: erp.masters.vendors:read(or :write)

GET/public/v1/masters/vendors

List vendors and customers (paged; search, gstNo, vendorType)

Scope erp.masters.vendors:read · the client's role needs view on Vendor & Customer

Parameters

Name	In	Type	Notes
`page`	query	integer (int32)	Zero-based page index
`size`	query	integer (int32)	Page size
`search`	query	string	Filter by name (partial, case-insensitive)
`gstNo`	query	string	Filter by GST number (partial, case-insensitive)
`vendorType`	query	string	Filter by vendor type: VENDOR, CUSTOMER, VENDOR_CUSTOMER
`sortBy`	query	string	Sort field
`sortDir`	query	string	Sort direction: asc or desc

Response (200) — data

Field	Type	Notes
`content`	array of object
`id`	integer (int64)
`vendorType`	string
`type`	string
`name`	string
`address`	string
`country`	string
`countryCode`	string
`state`	string
`stateCode`	string
`city`	string
`postalCode`	string
`phone`	string
`altPhone`	string
`whatsappPhone`	string
`supplyType`	string
`currency`	string
`gstNo`	string
`email`	string
`contactPerson`	string
`termsConditions`	string
`customFields`	array of object
`createdAt`	string (date-time)
`updatedAt`	string (date-time)
`page`	integer (int32)
`size`	integer (int32)
`totalElements`	integer (int64)
`totalPages`	integer (int32)
`last`	boolean

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — List vendors and customers (paged; search, gstNo, vendorType)
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/masters/vendors?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

POST/public/v1/masters/vendors

Create a vendor or customer

Scope erp.masters.vendors:write · the client's role needs create on Vendor & Customer · send an Idempotency-Key

Parameters

Name	In	Type	Notes
`Idempotency-Key` *	header	string	Any unique text up to 120 characters (e.g. a UUID). A retry with the same key and body returns the first answer instead of doing the work twice.

Request body

Field	Type	Notes
`vendorType` *	string
`type` *	string
`name` *	string
`address` *	string
`country` *	string
`countryCode` *	string
`state` *	string
`stateCode` *	string
`city` *	string
`postalCode` *	string
`phone`	string
`altPhone`	string
`whatsappPhone`	string
`supplyType` *	string
`currency`	string
`gstNo`	string
`email`	string
`contactPerson`	string
`termsConditions`	string
`customFields`	array of object
`label`	string
`value`	string

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`vendorType`	string
`type`	string
`name`	string
`address`	string
`country`	string
`countryCode`	string
`state`	string
`stateCode`	string
`city`	string
`postalCode`	string
`phone`	string
`altPhone`	string
`whatsappPhone`	string
`supplyType`	string
`currency`	string
`gstNo`	string
`email`	string
`contactPerson`	string
`termsConditions`	string
`customFields`	array of object
`label`	string
`value`	string
`createdAt`	string (date-time)
`updatedAt`	string (date-time)

Errors: 400, 401, 403, 404, 405, 409, 413, 422, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — Create a vendor or customer
curl -X POST "https://kronex.codeverse.co/cedge/public/v1/masters/vendors" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

GET/public/v1/masters/vendors/{id}

Get one vendor or customer

Scope erp.masters.vendors:read · the client's role needs view on Vendor & Customer

Parameters

Name	In	Type	Notes
`id` *	path	integer (int64)	The record's id.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`vendorType`	string
`type`	string
`name`	string
`address`	string
`country`	string
`countryCode`	string
`state`	string
`stateCode`	string
`city`	string
`postalCode`	string
`phone`	string
`altPhone`	string
`whatsappPhone`	string
`supplyType`	string
`currency`	string
`gstNo`	string
`email`	string
`contactPerson`	string
`termsConditions`	string
`customFields`	array of object
`label`	string
`value`	string
`createdAt`	string (date-time)
`updatedAt`	string (date-time)

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — Get one vendor or customer
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/masters/vendors/{id}" \
  -H "Authorization: Bearer $KERN_API_KEY"

PUT/public/v1/masters/vendors/{id}

Update a vendor or customer

Scope erp.masters.vendors:write · the client's role needs edit on Vendor & Customer · send an Idempotency-Key

Parameters

Name	In	Type	Notes
`id` *	path	integer (int64)	The record's id.
`Idempotency-Key` *	header	string	Any unique text up to 120 characters (e.g. a UUID). A retry with the same key and body returns the first answer instead of doing the work twice.

Request body

Field	Type	Notes
`vendorType` *	string
`type` *	string
`name` *	string
`address` *	string
`country` *	string
`countryCode` *	string
`state` *	string
`stateCode` *	string
`city` *	string
`postalCode` *	string
`phone`	string
`altPhone`	string
`whatsappPhone`	string
`supplyType` *	string
`currency`	string
`gstNo`	string
`email`	string
`contactPerson`	string
`termsConditions`	string
`customFields`	array of object
`label`	string
`value`	string

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`vendorType`	string
`type`	string
`name`	string
`address`	string
`country`	string
`countryCode`	string
`state`	string
`stateCode`	string
`city`	string
`postalCode`	string
`phone`	string
`altPhone`	string
`whatsappPhone`	string
`supplyType`	string
`currency`	string
`gstNo`	string
`email`	string
`contactPerson`	string
`termsConditions`	string
`customFields`	array of object
`label`	string
`value`	string
`createdAt`	string (date-time)
`updatedAt`	string (date-time)

Errors: 400, 401, 403, 404, 405, 409, 413, 422, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — Update a vendor or customer
curl -X PUT "https://kronex.codeverse.co/cedge/public/v1/masters/vendors/{id}" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

Color

Access: erp.masters.colors:read(or :write)

GET/public/v1/masters/colors

List colours

Scope erp.masters.colors:read · the client's role needs view on Color

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`colorName`	string
`colorCode`	string

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — List colours
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/masters/colors?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

POST/public/v1/masters/colors

Create a colour

Scope erp.masters.colors:write · the client's role needs create on Color · send an Idempotency-Key

Parameters

Name	In	Type	Notes
`Idempotency-Key` *	header	string	Any unique text up to 120 characters (e.g. a UUID). A retry with the same key and body returns the first answer instead of doing the work twice.

Request body

Field	Type	Notes
`colorName` *	string
`colorCode`	string

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`colorName`	string
`colorCode`	string

Errors: 400, 401, 403, 404, 405, 409, 413, 422, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — Create a colour
curl -X POST "https://kronex.codeverse.co/cedge/public/v1/masters/colors" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

Fabric Master

Access: erp.masters.uoms:read(or :write)

GET/public/v1/masters/uoms

List units of measure

Scope erp.masters.uoms:read · the client's role needs view on Fabric Master

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`uomName`	string

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — List units of measure
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/masters/uoms?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

Product List

Access: erp.masters.sizes:read(or :write)

GET/public/v1/masters/sizes

List sizes

Scope erp.masters.sizes:read · the client's role needs view on Product List

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`sizeCode`	string
`sizeName`	string

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — List sizes
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/masters/sizes?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

Config & Settings

Access: erp.masters.warehouses:read(or :write)

GET/public/v1/masters/warehouses

List active warehouses

Scope erp.masters.warehouses:read · the client's role needs view on Config & Settings

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`code`	string
`name`	string
`address`	string
`virtual`	boolean
`default`	boolean
`active`	boolean
`isDefault`	boolean
`isActive`	boolean
`isVirtual`	boolean

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — List active warehouses
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/masters/warehouses?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

Build on KERN.

Read the guides Talk to us