biosecure.co

Order & verification via API

Embed biosecurity checks into your plasmid checkout with a single POST request.

Core endpoint: verify order

Request

POST https://api.biosecure.co/passport/verify-order
Authorization: Bearer <vendor_api_key>
Content-Type: application/json

{
  "sequence_hash": "sha256:<hash-of-plasmid-sequence>",
  "user_passport_id": "usr_123",
  "institution_id": "inst_oxford_lab1",
  "order_metadata": {
    "plasmid_type": "expression",
    "biosafety_level": "BSL2",
    "use_case": "preclinical research"
  }
}

Response

{
  "decision": "approve",       // "approve" | "deny" | "flag"
  "risk_score": 0.17,          // 0.0 (low) – 1.0 (high)
  "flags": [],
  "passport_status": "active",
  "institution_status": "good_standing",
  "audit_log_url": "https://biosecure.co/audit/ord_987",
  "review_recommended": false
}

Intended integration pattern

1.

Call from your backend right before an order is accepted.

2.

Store the decision, risk_score, and audit_log_url with your order.

3.

Optionally show a risk badge in your internal tools.

Future endpoints (for hackathon, can be dummy text)

POST /passport/create-user
POST /passport/create-institution
GET /audit/{order_id}