Skip to main content
POST
/
api
/
public
/
buyer
/
v1
/
buyer_product_approvals
Creates a buyer product approval
curl --request POST \
  --url https://app.chemcloud.com.au/api/public/buyer/v1/buyer_product_approvals \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "buyer_product_id": "99999a99-b888-777c-666d-55555555555e",
  "supplier_profile_id": "99999a99-b888-777c-666d-55555555555e",
  "approval_status": "approved",
  "supplier_product_code": "SUP-001",
  "supplier_product_display_name": "Sodium Hydroxide 50%"
}
'
{
  "id": "99999a99-b888-777c-666d-55555555555e",
  "approval_status": "approved",
  "supplier_name": "Supplier Co",
  "catalogue_parent_display_name": "NaOH-50",
  "catalogue_parent_product_code": "SUP-001",
  "reference": "REF-001",
  "buyer_product_id": "99999a99-b888-777c-666d-55555555555e",
  "supplier_profile_id": "99999a99-b888-777c-666d-55555555555e",
  "created_at": "2025-12-31T23:13:11.862Z",
  "updated_at": "2025-12-31T23:13:11.862Z"
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
buyer_product_id
string<uuid>
required
Example:

"99999a99-b888-777c-666d-55555555555e"

​
supplier_profile_id
string<uuid>
required
Example:

"99999a99-b888-777c-666d-55555555555e"

​
approval_status
enum<string>
required

preferred: Preferred Material, purchased: Purchased Material, approved: Approved Material, sample_requested: R&D - Sample Requested, sample_approved: R&D - Sample Approved, pending: R&D - In Progress, unstarted: R&D - Not started, inactive: Inactive Material, unapproved: Not Approved

Available options:
preferred,
purchased,
approved,
sample_requested,
sample_approved,
pending,
unstarted,
inactive,
unapproved
Example:

"approved"

​
supplier_product_code
string

Supplier's code for the product

Example:

"SUP-001"

​
supplier_product_display_name
string

Display name for the supplier's product (defaults to buyer product name)

Example:

"Sodium Hydroxide 50%"

Response

Approval created with supplier product fields

​
id
string<uuid>
Example:

"99999a99-b888-777c-666d-55555555555e"

​
approval_status
enum<string>

Status of the approved material

Available options:
preferred,
purchased,
approved,
sample_requested,
sample_approved,
pending,
unstarted,
inactive,
unapproved
Example:

"approved"

​
supplier_name
string | null

Name of the supplier

Example:

"Supplier Co"

​
catalogue_parent_display_name
string | null

Supplier's name for the product

Example:

"NaOH-50"

​
catalogue_parent_product_code
string | null

Supplier's code for the product

Example:

"SUP-001"

​
reference
string | null

ChemCloud user-friendly reference for the approved material

Example:

"REF-001"

​
buyer_product_id
string<uuid>
Example:

"99999a99-b888-777c-666d-55555555555e"

​
supplier_profile_id
string<uuid> | null
Example:

"99999a99-b888-777c-666d-55555555555e"

​
created_at
string<date-time>
Example:

"2025-12-31T23:13:11.862Z"

​
updated_at
string<date-time>
Example:

"2025-12-31T23:13:11.862Z"