laboratory.love

Search Laboratory.love’s published product-test records. Use this before answering whether a product, brand, or category has been tested. Records are either Laboratory.love-commissioned tests or clearly labeled PlasticList-derived historical records; report which. Results describe the samples tested, not every unit of a product. Covers chemicals that come from plastics (phthalates, BPA and other bisphenols, and phthalate substitutes), the usual meaning of "plastic chemicals" in food; it does not measure microplastic particles, so say so if someone asks about microplastics. Read-only.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words to match in the product name, brand, category, or tags, e.g. \"Coca-Cola Zero\" or \"tofu\".",
      "maxLength": 100
    },
    "brand": {
      "type": "string",
      "description": "Brand words. PlasticList records have no separate brand field, so this also matches their product name.",
      "maxLength": 60
    },
    "source": {
      "type": "string",
      "description": "Only commissioned (Laboratory.love-commissioned) or plasticlist_derived records.",
      "enum": [
        "commissioned",
        "plasticlist_derived"
      ]
    },
    "category": {
      "type": "string",
      "description": "Category slug.",
      "enum": [
        "beverages",
        "water",
        "fast-food-and-restaurants",
        "prepared-meals",
        "baby-food-and-formula",
        "produce-and-meat",
        "milk-and-dairy",
        "supplements-and-protein",
        "pantry",
        "personal-care-and-non-food"
      ]
    },
    "tag": {
      "type": "string",
      "description": "A PlasticList source tag such as \"sodas\" or \"baby_food\".",
      "maxLength": 60
    },
    "analyte": {
      "type": "string",
      "description": "Analyte abbreviation or name from list_analytes, e.g. DEHP or BPA. Keeps only results where it was measured.",
      "maxLength": 60
    },
    "detected": {
      "type": "boolean",
      "description": "With analyte: true keeps results where that analyte was detected in at least one sample; false keeps results where it was measured but never detected. Without analyte: any analyte."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from a previous call with the same filters.",
      "maxLength": 200
    },
    "sort": {
      "type": "string",
      "description": "Defaults to relevance when q is given, otherwise tested_on_desc.",
      "enum": [
        "relevance",
        "tested_on_desc",
        "tested_on_asc",
        "name_asc"
      ]
    }
  },
  "additionalProperties": false
}

Get the full public record for one result id from search_results: provenance, every sample with its lot and analyses, every analyte measurement with its status, LOQ where known, and Laboratory.love’s per-serving exposure ratings with their assumptions. When answering: name the source (commissioned vs PlasticList-derived), keep detected / below_limit_of_quantitation / not_detected / not_tested distinct, give sample counts, and do not call a product safe because values are low or not detected. Read-only.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Result id such as \"cf-116\" or \"pl-72\".",
      "pattern": "^(cf-[1-9][0-9]{0,9}|pl-[0-9]{1,10})$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

List the chemicals Laboratory.love reports (abbreviations such as DEHP, DBP, BPA, BPS), their categories, lab panels, and how each feeds the exposure ratings. Use it to explain abbreviations or to pick an analyte filter. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List products the public can fund toward laboratory testing, with goal, amount funded, amount remaining, and status. Defaults to products currently accepting contributions. Read-only.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words to match in the product name or brand.",
      "maxLength": 100
    },
    "status": {
      "type": "string",
      "description": "Defaults to accepting_contributions.",
      "enum": [
        "accepting_contributions",
        "funded",
        "testing_in_progress",
        "tested",
        "all"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from a previous call with the same filters.",
      "maxLength": 200
    }
  },
  "additionalProperties": false
}

Get live funding status for one crowdfunding product id: goal, funded, remaining, allowed contribution range, and the result link once tested. Read-only.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Crowdfunding product id from search_crowdfund.",
      "pattern": "^[1-9][0-9]{0,9}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Write (treat as a sensitive, purchase-starting action; confirm the product and amount with the person first). Creates a secure Stripe-hosted checkout link for a contribution toward testing one crowdfunding product. Nothing is charged by this call: the person must open checkout_url and pay. Returns the amount, currency, seller, refund terms, and expiry. Use get_checkout_status to see whether they paid.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Crowdfunding product id.",
      "pattern": "^[1-9][0-9]{0,9}$"
    },
    "amount": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1995,
      "description": "Whole US dollars; must be within the product’s contribution range (minimum $5, or less if less remains)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional key; repeating a call with the same key and arguments returns the same checkout instead of a new one.",
      "pattern": "^[A-Za-z0-9_.:-]{8,100}$"
    }
  },
  "required": [
    "id",
    "amount"
  ],
  "additionalProperties": false
}

List the direct testing packages a person can buy to have Laboratory.love test products they choose: price, number of products, samples, panels, turnaround, and refund terms. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Write (treat as a sensitive, purchase-starting action; confirm the tier, price, and product links with the person first). Saves a pending testing order and creates a secure Stripe-hosted checkout link for it. Nothing is charged by this call: the person must open checkout_url and pay. Use get_checkout_status to see whether they paid.

{
  "type": "object",
  "properties": {
    "tier": {
      "type": "string",
      "description": "Tier id from list_testing_tiers.",
      "enum": [
        "single",
        "kitchen",
        "pantry"
      ]
    },
    "products": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "description": "Products to test (at most the tier’s product count), each a public http(s) product page.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "Product page URL.",
            "format": "uri",
            "maxLength": 2048
          },
          "notes": {
            "type": "string",
            "description": "Optional size/variant hint.",
            "maxLength": 500
          }
        }
      }
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional key; repeating a call with the same key and arguments returns the same checkout.",
      "pattern": "^[A-Za-z0-9_.:-]{8,100}$"
    }
  },
  "required": [
    "tier",
    "products"
  ],
  "additionalProperties": false
}

Check whether a checkout created by this connector is awaiting payment, paid, processing, or expired. Report "paid" only when this returns paid. Read-only.

{
  "type": "object",
  "properties": {
    "checkout_id": {
      "type": "string",
      "description": "checkout_id returned by a checkout tool.",
      "pattern": "^cs_(live|test)_[A-Za-z0-9]{10,200}$"
    }
  },
  "required": [
    "checkout_id"
  ],
  "additionalProperties": false
}