{
  "openapi": "3.1.0",
  "info": {
    "title": "Bramante Biologics catalog API",
    "version": "2026-09-16",
    "description": "Read-only access to the published price, specification, stock, and lead time of every product we sell. No key required. The same numbers shown on the product page, and the same numbers checkout charges.",
    "contact": {
      "email": "support@bramantebio.com",
      "url": "https://bramantebio.com/support/"
    },
    "termsOfService": "https://bramantebio.com/legal/terms/"
  },
  "servers": [
    {
      "url": "https://bramantebio.com"
    }
  ],
  "paths": {
    "/api/company/": {
      "get": {
        "summary": "Company, catalog and ordering interface discovery",
        "responses": {
          "200": {
            "description": "Public interfaces and their authentication and payment boundaries."
          }
        }
      }
    },
    "/api/custom-media/ingredients/": {
      "post": {
        "summary": "Find a custom media ingredient",
        "description": "Search by name or CAS number. Use ingredientId with source catalog in the recipe.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 250
                  },
                  "offset": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740983
                  }
                },
                "required": [
                  "query"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Matches with names, CAS numbers, and opaque ingredient IDs."
          },
          "400": {
            "description": "Invalid request."
          },
          "429": {
            "description": "Rate limit reached. Wait and try again."
          },
          "503": {
            "description": "Pricing or lookup temporarily unavailable."
          }
        }
      }
    },
    "/api/custom-media/estimate/": {
      "post": {
        "summary": "Estimate the product price of a custom recipe",
        "description": "Use the delivery estimate for price and shipping by ZIP code.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "format": {
                    "type": "string",
                    "enum": [
                      "bottle500",
                      "bottle1000",
                      "tube50",
                      "bag18",
                      "bag20",
                      "bag200"
                    ]
                  },
                  "fillMl": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 200000
                  },
                  "containers": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "mixingBagType": {
                    "default": "standard",
                    "description": "Deprecated. Bramante uses food-safe mixing liners for all new runs. Omit this field.",
                    "deprecated": true,
                    "type": "string",
                    "enum": [
                      "standard",
                      "autoclaved"
                    ]
                  },
                  "finishedBagType": {
                    "default": "standard",
                    "type": "string",
                    "enum": [
                      "standard",
                      "autoclaved"
                    ]
                  },
                  "minimumShippingTemperature": {
                    "description": "Required shipping condition. Omit it to use the formulation and packaging defaults.",
                    "type": "string",
                    "enum": [
                      "ambient",
                      "cold_pack",
                      "dry_ice"
                    ]
                  },
                  "labelName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 150
                  },
                  "researchUseOnly": {
                    "type": "boolean",
                    "const": true
                  },
                  "ingredients": {
                    "minItems": 1,
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "amountPerLiter": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 1000000
                            },
                            "unit": {
                              "type": "string",
                              "enum": [
                                "mg",
                                "uL",
                                "U"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "const": "catalog"
                            },
                            "ingredientId": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9_-]{40,1024}$",
                              "description": "Copy the ingredientId returned by chemical name or CAS search."
                            },
                            "requireExactProduct": {
                              "description": "Use only the selected catalog match.",
                              "type": "boolean",
                              "const": true
                            }
                          },
                          "required": [
                            "amountPerLiter",
                            "unit",
                            "source",
                            "ingredientId"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "amountPerLiter": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 1000000
                            },
                            "unit": {
                              "type": "string",
                              "enum": [
                                "mg",
                                "uL",
                                "U"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 250
                            },
                            "form": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 120
                            },
                            "casNumber": {
                              "type": "string",
                              "pattern": "^\\d{2,7}-\\d{2}-\\d$"
                            },
                            "source": {
                              "type": "string",
                              "const": "customer"
                            },
                            "supplyDetails": {
                              "description": "Known details about the material being supplied, such as stock concentration, solvent, available quantity, grade, supplier, or lot.",
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 500
                            }
                          },
                          "required": [
                            "amountPerLiter",
                            "unit",
                            "name",
                            "form",
                            "source"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "amountPerLiter": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 1000000
                            },
                            "unit": {
                              "type": "string",
                              "enum": [
                                "mg",
                                "uL",
                                "U"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 250
                            },
                            "form": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 120
                            },
                            "casNumber": {
                              "type": "string",
                              "pattern": "^\\d{2,7}-\\d{2}-\\d$"
                            },
                            "source": {
                              "type": "string",
                              "const": "external"
                            },
                            "purchase": {
                              "type": "object",
                              "properties": {
                                "supplierName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 120
                                },
                                "productCode": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 120
                                },
                                "productUrl": {
                                  "type": "string",
                                  "maxLength": 700,
                                  "format": "uri"
                                },
                                "packAmount": {
                                  "type": "number",
                                  "exclusiveMinimum": 0,
                                  "maximum": 1000000000000,
                                  "description": "Quantity in one pack, in the ingredient’s unit: mg, uL or U. Never convert enzyme activity into mass."
                                },
                                "packPriceCents": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 100000000,
                                  "description": "Customer-entered price in US cents for one entire pack, excluding shipping. This is unverified supplier pricing."
                                }
                              },
                              "required": [
                                "supplierName",
                                "packAmount",
                                "packPriceCents"
                              ],
                              "additionalProperties": false
                            },
                            "requirements": {
                              "type": "string",
                              "maxLength": 300
                            }
                          },
                          "required": [
                            "amountPerLiter",
                            "unit",
                            "name",
                            "form",
                            "source",
                            "purchase"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "amountPerLiter": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 1000000
                            },
                            "unit": {
                              "type": "string",
                              "enum": [
                                "mg",
                                "uL",
                                "U"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 250
                            },
                            "form": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 120
                            },
                            "casNumber": {
                              "type": "string",
                              "pattern": "^\\d{2,7}-\\d{2}-\\d$"
                            },
                            "source": {
                              "type": "string",
                              "const": "unlisted"
                            },
                            "requirements": {
                              "type": "string",
                              "maxLength": 300
                            }
                          },
                          "required": [
                            "amountPerLiter",
                            "unit",
                            "name",
                            "form",
                            "source"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "format",
                  "fillMl",
                  "containers",
                  "labelName",
                  "researchUseOnly",
                  "ingredients"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Beta product price or a request for review."
          },
          "400": {
            "description": "Invalid request."
          },
          "429": {
            "description": "Rate limit reached. Wait and try again."
          },
          "503": {
            "description": "Pricing or lookup temporarily unavailable."
          }
        }
      }
    },
    "/api/custom-media/delivered-estimate/": {
      "post": {
        "summary": "Estimate custom media with shipping by US ZIP",
        "description": "Get a custom media or buffer product price and delivery estimates for a US ZIP code. Pass the full recipe and the customer's postal code or a representative ZIP for their city and state. No street address or sign-in is needed. Show each available service and its product-plus-shipping subtotal before tax. Rates use the recipe’s minimum shipping temperature. Set minimumShippingTemperature on the recipe to compare a colder option. Explain rates that require a carrier account or staff review. Ask before assuming the shipment is non-hazardous for pallet freight. Use the review link to continue on Bramante, where the actual address and shipping rates are confirmed.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "estimate": {
                    "type": "object",
                    "properties": {
                      "format": {
                        "type": "string",
                        "enum": [
                          "bottle500",
                          "bottle1000",
                          "tube50",
                          "bag18",
                          "bag20",
                          "bag200"
                        ]
                      },
                      "fillMl": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 200000
                      },
                      "containers": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 10000
                      },
                      "mixingBagType": {
                        "default": "standard",
                        "description": "Deprecated. Bramante uses food-safe mixing liners for all new runs. Omit this field.",
                        "deprecated": true,
                        "type": "string",
                        "enum": [
                          "standard",
                          "autoclaved"
                        ]
                      },
                      "finishedBagType": {
                        "default": "standard",
                        "type": "string",
                        "enum": [
                          "standard",
                          "autoclaved"
                        ]
                      },
                      "minimumShippingTemperature": {
                        "description": "Required shipping condition. Omit it to use the formulation and packaging defaults.",
                        "type": "string",
                        "enum": [
                          "ambient",
                          "cold_pack",
                          "dry_ice"
                        ]
                      },
                      "labelName": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 150
                      },
                      "researchUseOnly": {
                        "type": "boolean",
                        "const": true
                      },
                      "ingredients": {
                        "minItems": 1,
                        "maxItems": 200,
                        "type": "array",
                        "items": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "amountPerLiter": {
                                  "type": "number",
                                  "exclusiveMinimum": 0,
                                  "maximum": 1000000
                                },
                                "unit": {
                                  "type": "string",
                                  "enum": [
                                    "mg",
                                    "uL",
                                    "U"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "const": "catalog"
                                },
                                "ingredientId": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9_-]{40,1024}$",
                                  "description": "Copy the ingredientId returned by chemical name or CAS search."
                                },
                                "requireExactProduct": {
                                  "description": "Use only the selected catalog match.",
                                  "type": "boolean",
                                  "const": true
                                }
                              },
                              "required": [
                                "amountPerLiter",
                                "unit",
                                "source",
                                "ingredientId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "amountPerLiter": {
                                  "type": "number",
                                  "exclusiveMinimum": 0,
                                  "maximum": 1000000
                                },
                                "unit": {
                                  "type": "string",
                                  "enum": [
                                    "mg",
                                    "uL",
                                    "U"
                                  ]
                                },
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 250
                                },
                                "form": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 120
                                },
                                "casNumber": {
                                  "type": "string",
                                  "pattern": "^\\d{2,7}-\\d{2}-\\d$"
                                },
                                "source": {
                                  "type": "string",
                                  "const": "customer"
                                },
                                "supplyDetails": {
                                  "description": "Known details about the material being supplied, such as stock concentration, solvent, available quantity, grade, supplier, or lot.",
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 500
                                }
                              },
                              "required": [
                                "amountPerLiter",
                                "unit",
                                "name",
                                "form",
                                "source"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "amountPerLiter": {
                                  "type": "number",
                                  "exclusiveMinimum": 0,
                                  "maximum": 1000000
                                },
                                "unit": {
                                  "type": "string",
                                  "enum": [
                                    "mg",
                                    "uL",
                                    "U"
                                  ]
                                },
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 250
                                },
                                "form": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 120
                                },
                                "casNumber": {
                                  "type": "string",
                                  "pattern": "^\\d{2,7}-\\d{2}-\\d$"
                                },
                                "source": {
                                  "type": "string",
                                  "const": "external"
                                },
                                "purchase": {
                                  "type": "object",
                                  "properties": {
                                    "supplierName": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 120
                                    },
                                    "productCode": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 120
                                    },
                                    "productUrl": {
                                      "type": "string",
                                      "maxLength": 700,
                                      "format": "uri"
                                    },
                                    "packAmount": {
                                      "type": "number",
                                      "exclusiveMinimum": 0,
                                      "maximum": 1000000000000,
                                      "description": "Quantity in one pack, in the ingredient’s unit: mg, uL or U. Never convert enzyme activity into mass."
                                    },
                                    "packPriceCents": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 100000000,
                                      "description": "Customer-entered price in US cents for one entire pack, excluding shipping. This is unverified supplier pricing."
                                    }
                                  },
                                  "required": [
                                    "supplierName",
                                    "packAmount",
                                    "packPriceCents"
                                  ],
                                  "additionalProperties": false
                                },
                                "requirements": {
                                  "type": "string",
                                  "maxLength": 300
                                }
                              },
                              "required": [
                                "amountPerLiter",
                                "unit",
                                "name",
                                "form",
                                "source",
                                "purchase"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "amountPerLiter": {
                                  "type": "number",
                                  "exclusiveMinimum": 0,
                                  "maximum": 1000000
                                },
                                "unit": {
                                  "type": "string",
                                  "enum": [
                                    "mg",
                                    "uL",
                                    "U"
                                  ]
                                },
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 250
                                },
                                "form": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 120
                                },
                                "casNumber": {
                                  "type": "string",
                                  "pattern": "^\\d{2,7}-\\d{2}-\\d$"
                                },
                                "source": {
                                  "type": "string",
                                  "const": "unlisted"
                                },
                                "requirements": {
                                  "type": "string",
                                  "maxLength": 300
                                }
                              },
                              "required": [
                                "amountPerLiter",
                                "unit",
                                "name",
                                "form",
                                "source"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      }
                    },
                    "required": [
                      "format",
                      "fillMl",
                      "containers",
                      "labelName",
                      "researchUseOnly",
                      "ingredients"
                    ],
                    "additionalProperties": false
                  },
                  "destination": {
                    "type": "object",
                    "properties": {
                      "postalCode": {
                        "type": "string",
                        "pattern": "^\\d{5}$",
                        "description": "Five-digit US postal code. Use a known representative ZIP if only the city and state are available."
                      },
                      "city": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 80
                      },
                      "state": {
                        "type": "string",
                        "pattern": "^[a-zA-Z]{2}$"
                      },
                      "country": {
                        "type": "string",
                        "const": "US"
                      }
                    },
                    "required": [
                      "postalCode"
                    ],
                    "additionalProperties": false
                  },
                  "freightDetails": {
                    "type": "object",
                    "properties": {
                      "nonHazardous": {
                        "type": "boolean",
                        "const": true,
                        "description": "Confirm that the finished goods are non-hazardous for transport."
                      },
                      "pickupDate": {
                        "description": "Optional planning pickup date. Defaults to the next weekday for rating.",
                        "type": "string",
                        "format": "date",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                      }
                    },
                    "required": [
                      "nonHazardous"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "estimate",
                  "destination"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Beta product price or review status. On success, delivery.options lists estimated, carrier-billed and review options. Money fields use integer US cents. subtotalBeforeTaxCents includes the product price and Bramante shipping for that option, and completeBeforeTax indicates whether other shipping costs remain unconfirmed.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "estimate",
                        "needs_review"
                      ]
                    },
                    "priceCents": {
                      "description": "Beta product price before outbound shipping, in US cents.",
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "message": {
                      "type": "string"
                    },
                    "reviewUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "reviewLinkExpiresAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "delivery": {
                      "type": "object",
                      "properties": {
                        "destination": {
                          "type": "object",
                          "properties": {
                            "postalCode": {
                              "type": "string",
                              "pattern": "^\\d{5}$",
                              "description": "Five-digit US postal code. Use a known representative ZIP if only the city and state are available."
                            },
                            "city": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "state": {
                              "type": "string",
                              "pattern": "^[a-zA-Z]{2}$"
                            },
                            "country": {
                              "type": "string",
                              "const": "US"
                            }
                          },
                          "required": [
                            "postalCode",
                            "country"
                          ],
                          "additionalProperties": false
                        },
                        "temperature": {
                          "type": "string",
                          "enum": [
                            "ambient",
                            "cold_pack",
                            "dry_ice"
                          ]
                        },
                        "estimateOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "notice": {
                          "type": "string"
                        },
                        "carrierNotice": {
                          "type": "string"
                        },
                        "options": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "label": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "estimated",
                                  "carrier_billed",
                                  "needs_review"
                                ]
                              },
                              "description": {
                                "type": "string"
                              },
                              "carrierCents": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "packingCents": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "shippingCents": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Amount Bramante charges for outbound shipping and packing. A separate carrier bill does not appear here."
                              },
                              "subtotalBeforeTaxCents": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Product plus known Bramante outbound charges. Null when a shipping quote is needed."
                              },
                              "completeBeforeTax": {
                                "type": "boolean",
                                "description": "Whether the subtotal includes all known shipping costs. False when carrier or unconfirmed supplier charges are additional, or the rate is a test rate."
                              },
                              "boxes": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "testMode": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "label",
                              "status",
                              "description",
                              "carrierCents",
                              "packingCents",
                              "shippingCents",
                              "subtotalBeforeTaxCents",
                              "completeBeforeTax"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "destination",
                        "temperature",
                        "estimateOnly",
                        "notice",
                        "options"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "status"
                  ],
                  "additionalProperties": {}
                }
              }
            }
          },
          "400": {
            "description": "Invalid request."
          },
          "429": {
            "description": "Rate limit reached. Wait and try again."
          },
          "503": {
            "description": "Pricing or lookup temporarily unavailable."
          }
        }
      }
    },
    "/api/catalog/": {
      "get": {
        "summary": "Discovery document",
        "description": "Every endpoint, its parameters, and its meaning, plus the category list and the URL templates for public product documents and guidance for private order certificates. Start here.",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog/products/": {
      "get": {
        "summary": "List products",
        "description": "Listed products only: everything returned here has a product page and can be ordered or waitlisted. Filters combine with AND.",
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by category. Exact match.",
            "schema": {
              "type": "string",
              "enum": [
                "growth-factor",
                "media",
                "reagent",
                "resin"
              ]
            }
          },
          {
            "name": "family",
            "in": "query",
            "required": false,
            "description": "Filter by family name, case-insensitive. Exact match, not a prefix.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Free text over name, id, family, and SKU. Every whitespace-separated term must match.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "in_stock",
            "in": "query",
            "required": false,
            "description": "Pass \"true\" for only products with a variant on the shelf. Any other value is ignored.",
            "schema": {
              "type": "string",
              "enum": [
                "true"
              ]
            }
          },
          {
            "name": "buyable",
            "in": "query",
            "required": false,
            "description": "Pass \"true\" for only products with a purchasable variant. Any other value is ignored.",
            "schema": {
              "type": "string",
              "enum": [
                "true"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "1-200, clamped into range. Default 50.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. Negative values are treated as 0.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of products.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "total": {
                      "type": "integer",
                      "description": "Matches before paging."
                    },
                    "limit": {
                      "type": "integer"
                    },
                    "offset": {
                      "type": "integer"
                    },
                    "next": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "uri",
                      "description": "Absolute URL of the next page with the same filters. null on the last page."
                    },
                    "products": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "short_name": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "category": {
                            "type": "string",
                            "enum": [
                              "growth-factor",
                              "media",
                              "reagent",
                              "resin"
                            ]
                          },
                          "family": {
                            "type": "string"
                          },
                          "cas_number": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "description": {
                            "type": "string"
                          },
                          "spec": {
                            "type": "object",
                            "description": "Scientific specification. Shape depends on `category`: growth-factor, media, reagent, or resin."
                          },
                          "cold_chain": {
                            "type": "string",
                            "enum": [
                              "ambient",
                              "cold_pack",
                              "dry_ice"
                            ]
                          },
                          "hazards": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "research_use_only": {
                            "type": "boolean"
                          },
                          "variants": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "sku": {
                                  "type": "string"
                                },
                                "pack": {
                                  "type": "string",
                                  "description": "Human pack label, e.g. \"50 µg\"."
                                },
                                "bottles_per_pack": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "enum": [
                                    1,
                                    6,
                                    12,
                                    24,
                                    null
                                  ]
                                },
                                "bottle_size": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "value": {
                                      "type": "number"
                                    },
                                    "unit": {
                                      "type": "string"
                                    }
                                  }
                                },
                                "size": {
                                  "type": "object",
                                  "description": "Total physical quantity in one purchase pack.",
                                  "properties": {
                                    "value": {
                                      "type": "number"
                                    },
                                    "unit": {
                                      "type": "string"
                                    }
                                  }
                                },
                                "price_usd": {
                                  "type": [
                                    "number",
                                    "null"
                                  ],
                                  "description": "List price. null when not sold separately."
                                },
                                "unit_price_usd": {
                                  "type": [
                                    "number",
                                    "null"
                                  ]
                                },
                                "unit_price_per": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "availability": {
                                  "type": "string",
                                  "enum": [
                                    "in_stock",
                                    "made_to_order",
                                    "backorder",
                                    "waitlist"
                                  ]
                                },
                                "stock_qty": {
                                  "type": "null",
                                  "deprecated": true,
                                  "description": "Always null. Use availability for public stock status."
                                },
                                "lead_time_days": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Preparation time, interpreted with lead_time_unit."
                                },
                                "lead_time_unit": {
                                  "type": "string",
                                  "enum": [
                                    "calendar",
                                    "business"
                                  ]
                                },
                                "buyable": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "sku",
                                "pack",
                                "size",
                                "price_usd",
                                "availability",
                                "stock_qty",
                                "lead_time_days",
                                "lead_time_unit",
                                "buyable"
                              ]
                            }
                          },
                          "documents": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "enum": [
                                    "datasheet",
                                    "sds"
                                  ]
                                },
                                "label": {
                                  "type": "string"
                                },
                                "version": {
                                  "type": "integer",
                                  "description": "Canonical retained revision number; approval and publication are separately checked."
                                },
                                "issued_at": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "format": "date",
                                  "description": "Original document date, when supplied."
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri",
                                  "description": "Exact current published retained PDF URL."
                                },
                                "publication_id": {
                                  "type": "string",
                                  "format": "uuid"
                                },
                                "revision_id": {
                                  "type": "string",
                                  "format": "uuid"
                                },
                                "sha256": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$"
                                },
                                "applicable_skus": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              },
                              "required": [
                                "kind",
                                "label",
                                "version",
                                "issued_at",
                                "url",
                                "publication_id",
                                "revision_id",
                                "sha256",
                                "applicable_skus"
                              ]
                            }
                          },
                          "related_skus": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Variant SKUs of related products, filtered to the listed catalog, so every one of them resolves at the single-product endpoint."
                          },
                          "url": {
                            "type": "string",
                            "format": "uri",
                            "description": "The product page for a human."
                          },
                          "coa_support_url": {
                            "type": "string",
                            "format": "uri",
                            "description": "Look up a published batch certificate by lot and SKU, or scan the QR code on the bottle."
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "name",
                          "category",
                          "family",
                          "description",
                          "spec",
                          "cold_chain",
                          "hazards",
                          "research_use_only",
                          "variants",
                          "documents",
                          "related_skus",
                          "url",
                          "coa_support_url"
                        ]
                      }
                    }
                  },
                  "required": [
                    "total",
                    "limit",
                    "offset",
                    "next",
                    "products"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/catalog/products/{sku_or_id}/": {
      "get": {
        "summary": "One product",
        "description": "Accepts a variant SKU, a product id, or a slug, case-insensitive for the id form. Listed products only, so a 200 here always has a page behind it.",
        "parameters": [
          {
            "name": "sku_or_id",
            "in": "path",
            "required": true,
            "description": "Variant SKU (33479-6), product id (MD-LIQ-DPBS-1X-NO-CA-MG), or slug.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "short_name": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "category": {
                          "type": "string",
                          "enum": [
                            "growth-factor",
                            "media",
                            "reagent",
                            "resin"
                          ]
                        },
                        "family": {
                          "type": "string"
                        },
                        "cas_number": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "description": {
                          "type": "string"
                        },
                        "spec": {
                          "type": "object",
                          "description": "Scientific specification. Shape depends on `category`: growth-factor, media, reagent, or resin."
                        },
                        "cold_chain": {
                          "type": "string",
                          "enum": [
                            "ambient",
                            "cold_pack",
                            "dry_ice"
                          ]
                        },
                        "hazards": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "research_use_only": {
                          "type": "boolean"
                        },
                        "variants": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "sku": {
                                "type": "string"
                              },
                              "pack": {
                                "type": "string",
                                "description": "Human pack label, e.g. \"50 µg\"."
                              },
                              "bottles_per_pack": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "enum": [
                                  1,
                                  6,
                                  12,
                                  24,
                                  null
                                ]
                              },
                              "bottle_size": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "properties": {
                                  "value": {
                                    "type": "number"
                                  },
                                  "unit": {
                                    "type": "string"
                                  }
                                }
                              },
                              "size": {
                                "type": "object",
                                "description": "Total physical quantity in one purchase pack.",
                                "properties": {
                                  "value": {
                                    "type": "number"
                                  },
                                  "unit": {
                                    "type": "string"
                                  }
                                }
                              },
                              "price_usd": {
                                "type": [
                                  "number",
                                  "null"
                                ],
                                "description": "List price. null when not sold separately."
                              },
                              "unit_price_usd": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "unit_price_per": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "availability": {
                                "type": "string",
                                "enum": [
                                  "in_stock",
                                  "made_to_order",
                                  "backorder",
                                  "waitlist"
                                ]
                              },
                              "stock_qty": {
                                "type": "null",
                                "deprecated": true,
                                "description": "Always null. Use availability for public stock status."
                              },
                              "lead_time_days": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "description": "Preparation time, interpreted with lead_time_unit."
                              },
                              "lead_time_unit": {
                                "type": "string",
                                "enum": [
                                  "calendar",
                                  "business"
                                ]
                              },
                              "buyable": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "sku",
                              "pack",
                              "size",
                              "price_usd",
                              "availability",
                              "stock_qty",
                              "lead_time_days",
                              "lead_time_unit",
                              "buyable"
                            ]
                          }
                        },
                        "documents": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "datasheet",
                                  "sds"
                                ]
                              },
                              "label": {
                                "type": "string"
                              },
                              "version": {
                                "type": "integer",
                                "description": "Canonical retained revision number; approval and publication are separately checked."
                              },
                              "issued_at": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "date",
                                "description": "Original document date, when supplied."
                              },
                              "url": {
                                "type": "string",
                                "format": "uri",
                                "description": "Exact current published retained PDF URL."
                              },
                              "publication_id": {
                                "type": "string",
                                "format": "uuid"
                              },
                              "revision_id": {
                                "type": "string",
                                "format": "uuid"
                              },
                              "sha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "applicable_skus": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "kind",
                              "label",
                              "version",
                              "issued_at",
                              "url",
                              "publication_id",
                              "revision_id",
                              "sha256",
                              "applicable_skus"
                            ]
                          }
                        },
                        "related_skus": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Variant SKUs of related products, filtered to the listed catalog, so every one of them resolves at the single-product endpoint."
                        },
                        "url": {
                          "type": "string",
                          "format": "uri",
                          "description": "The product page for a human."
                        },
                        "coa_support_url": {
                          "type": "string",
                          "format": "uri",
                          "description": "Look up a published batch certificate by lot and SKU, or scan the QR code on the bottle."
                        }
                      },
                      "required": [
                        "id",
                        "slug",
                        "name",
                        "category",
                        "family",
                        "description",
                        "spec",
                        "cold_chain",
                        "hazards",
                        "research_use_only",
                        "variants",
                        "documents",
                        "related_skus",
                        "url",
                        "coa_support_url"
                      ]
                    },
                    "matched_variant": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The variant SKU the lookup landed on, when asked by SKU. null when asked by product id or slug."
                    }
                  },
                  "required": [
                    "product",
                    "matched_variant"
                  ]
                }
              }
            }
          },
          "404": {
            "description": "No listed product matches.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "enum": [
                        "not_found"
                      ]
                    },
                    "message": {
                      "type": "string"
                    },
                    "list": {
                      "type": "string",
                      "format": "uri",
                      "description": "The list endpoint."
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/assets/product-documents/{publication_id}/{revision_id}.pdf": {
      "get": {
        "summary": "Exact published SDS or datasheet PDF",
        "description": "Serves the retained approved revision bytes only while current Quality approval and website publication remain valid. Use documents[].url. Responses are not cached; no PDF is generated from catalog text.",
        "parameters": [
          {
            "name": "publication_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "revision_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Exact retained PDF bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "404": {
            "description": "No currently eligible publication exists at this exact URL."
          },
          "503": {
            "description": "The retained document could not be verified."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Product": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "short_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "growth-factor",
              "media",
              "reagent",
              "resin"
            ]
          },
          "family": {
            "type": "string"
          },
          "cas_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": "string"
          },
          "spec": {
            "type": "object",
            "description": "Scientific specification. Shape depends on `category`: growth-factor, media, reagent, or resin."
          },
          "cold_chain": {
            "type": "string",
            "enum": [
              "ambient",
              "cold_pack",
              "dry_ice"
            ]
          },
          "hazards": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "research_use_only": {
            "type": "boolean"
          },
          "variants": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sku": {
                  "type": "string"
                },
                "pack": {
                  "type": "string",
                  "description": "Human pack label, e.g. \"50 µg\"."
                },
                "bottles_per_pack": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "enum": [
                    1,
                    6,
                    12,
                    24,
                    null
                  ]
                },
                "bottle_size": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "properties": {
                    "value": {
                      "type": "number"
                    },
                    "unit": {
                      "type": "string"
                    }
                  }
                },
                "size": {
                  "type": "object",
                  "description": "Total physical quantity in one purchase pack.",
                  "properties": {
                    "value": {
                      "type": "number"
                    },
                    "unit": {
                      "type": "string"
                    }
                  }
                },
                "price_usd": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "List price. null when not sold separately."
                },
                "unit_price_usd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "unit_price_per": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "availability": {
                  "type": "string",
                  "enum": [
                    "in_stock",
                    "made_to_order",
                    "backorder",
                    "waitlist"
                  ]
                },
                "stock_qty": {
                  "type": "null",
                  "deprecated": true,
                  "description": "Always null. Use availability for public stock status."
                },
                "lead_time_days": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "Preparation time, interpreted with lead_time_unit."
                },
                "lead_time_unit": {
                  "type": "string",
                  "enum": [
                    "calendar",
                    "business"
                  ]
                },
                "buyable": {
                  "type": "boolean"
                }
              },
              "required": [
                "sku",
                "pack",
                "size",
                "price_usd",
                "availability",
                "stock_qty",
                "lead_time_days",
                "lead_time_unit",
                "buyable"
              ]
            }
          },
          "documents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "datasheet",
                    "sds"
                  ]
                },
                "label": {
                  "type": "string"
                },
                "version": {
                  "type": "integer",
                  "description": "Canonical retained revision number; approval and publication are separately checked."
                },
                "issued_at": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date",
                  "description": "Original document date, when supplied."
                },
                "url": {
                  "type": "string",
                  "format": "uri",
                  "description": "Exact current published retained PDF URL."
                },
                "publication_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "revision_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "sha256": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "applicable_skus": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "kind",
                "label",
                "version",
                "issued_at",
                "url",
                "publication_id",
                "revision_id",
                "sha256",
                "applicable_skus"
              ]
            }
          },
          "related_skus": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Variant SKUs of related products, filtered to the listed catalog, so every one of them resolves at the single-product endpoint."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The product page for a human."
          },
          "coa_support_url": {
            "type": "string",
            "format": "uri",
            "description": "Look up a published batch certificate by lot and SKU, or scan the QR code on the bottle."
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "category",
          "family",
          "description",
          "spec",
          "cold_chain",
          "hazards",
          "research_use_only",
          "variants",
          "documents",
          "related_skus",
          "url",
          "coa_support_url"
        ]
      },
      "Variant": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string"
          },
          "pack": {
            "type": "string",
            "description": "Human pack label, e.g. \"50 µg\"."
          },
          "bottles_per_pack": {
            "type": [
              "integer",
              "null"
            ],
            "enum": [
              1,
              6,
              12,
              24,
              null
            ]
          },
          "bottle_size": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "value": {
                "type": "number"
              },
              "unit": {
                "type": "string"
              }
            }
          },
          "size": {
            "type": "object",
            "description": "Total physical quantity in one purchase pack.",
            "properties": {
              "value": {
                "type": "number"
              },
              "unit": {
                "type": "string"
              }
            }
          },
          "price_usd": {
            "type": [
              "number",
              "null"
            ],
            "description": "List price. null when not sold separately."
          },
          "unit_price_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "unit_price_per": {
            "type": [
              "string",
              "null"
            ]
          },
          "availability": {
            "type": "string",
            "enum": [
              "in_stock",
              "made_to_order",
              "backorder",
              "waitlist"
            ]
          },
          "stock_qty": {
            "type": "null",
            "deprecated": true,
            "description": "Always null. Use availability for public stock status."
          },
          "lead_time_days": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Preparation time, interpreted with lead_time_unit."
          },
          "lead_time_unit": {
            "type": "string",
            "enum": [
              "calendar",
              "business"
            ]
          },
          "buyable": {
            "type": "boolean"
          }
        },
        "required": [
          "sku",
          "pack",
          "size",
          "price_usd",
          "availability",
          "stock_qty",
          "lead_time_days",
          "lead_time_unit",
          "buyable"
        ]
      },
      "Document": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "datasheet",
              "sds"
            ]
          },
          "label": {
            "type": "string"
          },
          "version": {
            "type": "integer",
            "description": "Canonical retained revision number; approval and publication are separately checked."
          },
          "issued_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Original document date, when supplied."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Exact current published retained PDF URL."
          },
          "publication_id": {
            "type": "string",
            "format": "uuid"
          },
          "revision_id": {
            "type": "string",
            "format": "uuid"
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "applicable_skus": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "kind",
          "label",
          "version",
          "issued_at",
          "url",
          "publication_id",
          "revision_id",
          "sha256",
          "applicable_skus"
        ]
      }
    }
  }
}