{"components":{"schemas":{"Address":{"description":"A postal address","properties":{"city":{"description":"City","example":"Ashburn","type":"string"},"country":{"description":"ISO 3166-1 alpha-2","example":"US","type":"string"},"line1":{"description":"Street address","example":"21571 Beaumeade Circle","type":"string"},"postal_code":{"description":"Postal code","example":"20147","type":"string"},"region":{"description":"State or region","example":"VA","type":"string"}},"required":["city","country","line1","postal_code","region"],"type":"object"},"Entity":{"description":"A legal entity in a deal: operator, buyer, lender or platform","properties":{"beneficial_owners":{"description":"Owners of 25% or more, as declared and verified","items":{"description":"Beneficial owner","properties":{"name":{"description":"Full name","example":"A. Rivera","type":"string"},"share_pct":{"description":"Ownership share, percent","example":40,"type":"number"},"verified":{"description":"Identity verified against documents","example":true,"type":"boolean"}},"required":["name","share_pct","verified"],"type":"object"},"type":"array"},"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"id":{"description":"Synpute ID; the prefix gives the role","example":"SYN-OP-21C9","format":"synpute-id:OP|BY|LN|PL","type":"string"},"jurisdiction":{"description":"Place of incorporation, ISO 3166-2","example":"US-DE","type":"string"},"legal_name":{"description":"Registered legal name","example":"Example Compute LLC","type":"string"},"object":{"description":"Object type","enum":["entity"],"example":"entity","type":"string"},"registration_number":{"description":"Company registry number","example":"7741265","type":"string"},"role":{"description":"Role in the market","enum":["operator","buyer","lender","platform"],"example":"operator","type":"string"},"verification":{"$ref":"#/components/schemas/VerificationSummary","description":"Latest status of each check"}},"required":["beneficial_owners","created","id","jurisdiction","legal_name","object","registration_number","role","verification"],"type":"object"},"VerificationSummary":{"description":"Latest status per check, without the evidence","properties":{"checked_at":{"description":"When the most recent check finished","example":"2026-10-02T16:00:00Z","format":"date-time","type":"string"},"checks":{"description":"One entry per check that has run","items":{"description":"Check status","properties":{"status":{"description":"Result","enum":["verified","clear","flagged","failed","pending"],"example":"verified","type":"string"},"type":{"description":"Check","enum":["kyb","beneficial_owners","sanctions","serials","ownership","ucc_liens","site_lease","power_contract"],"example":"kyb","type":"string"}},"required":["status","type"],"type":"object"},"type":"array"},"status":{"description":"Rolled-up status","enum":["verified","partial","pending","flagged"],"example":"verified","type":"string"}},"required":["checked_at","checks","status"],"type":"object"},"Site":{"description":"A data-centre site a cluster runs in","properties":{"address":{"$ref":"#/components/schemas/Address"},"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"id":{"description":"Site ID","example":"SYN-ST-0B12","format":"synpute-id:ST","type":"string"},"lease":{"description":"The operator's right to occupy the site","properties":{"expires_on":{"description":"Lease end date","example":"2036-06-30","format":"date","type":"string"},"landlord":{"description":"Landlord legal name","example":"Beaumeade Data Partners LP","type":"string"},"verified":{"description":"Lease reviewed against the signed document","example":true,"type":"boolean"}},"required":["expires_on","landlord","verified"],"type":"object"},"object":{"description":"Object type","enum":["site"],"example":"site","type":"string"},"operator":{"description":"Operator that occupies the site","example":"SYN-OP-21C9","format":"synpute-id:OP","type":"string"},"power":{"description":"Contracted power","properties":{"contract_ends_on":{"description":"Power contract end date","example":"2036-06-30","format":"date","type":"string"},"contracted_mw":{"description":"Contracted capacity, megawatts","example":24,"type":"number"},"utility":{"description":"Utility or supplier","example":"Dominion Energy","type":"string"}},"required":["contract_ends_on","contracted_mw","utility"],"type":"object"},"tier":{"description":"Uptime Institute tier, if certified","enum":["I","II","III","IV","none"],"example":"III","type":"string"}},"required":["address","created","id","lease","object","operator","power","tier"],"type":"object"},"Cluster":{"description":"A physical GPU cluster registered in the Synpute Standard","properties":{"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"hardware":{"description":"What the cluster is","properties":{"gpu":{"description":"GPU model","enum":["H100","H200","B200","B300","GB200","A100"],"example":"B200","type":"string"},"interconnect":{"description":"Fabric","enum":["infiniband","roce","ethernet"],"example":"infiniband","type":"string"},"node_count":{"description":"Servers","example":128,"type":"integer"},"unit_count":{"description":"GPUs","example":1024,"type":"integer"}},"required":["gpu","interconnect","node_count","unit_count"],"type":"object"},"id":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"liens":{"description":"Most recent UCC search","properties":{"filings":{"description":"Active filings found against the units","example":0,"type":"integer"},"searched_at":{"description":"Search date","example":"2026-10-03","format":"date","type":"string"}},"required":["filings","searched_at"],"type":"object"},"object":{"description":"Object type","enum":["cluster"],"example":"cluster","type":"string"},"operator":{"description":"Operator that runs the cluster","example":"SYN-OP-21C9","format":"synpute-id:OP","type":"string"},"owner":{"description":"Legal owner of the hardware (may differ from operator)","example":"SYN-OP-21C9","format":"synpute-id:OP","type":"string"},"serials":{"description":"Serial attestation","properties":{"attested":{"description":"Units whose serials matched invoices and on-site inventory","example":1024,"type":"integer"},"total":{"description":"Units registered","example":1024,"type":"integer"}},"required":["attested","total"],"type":"object"},"site":{"description":"Site the cluster runs in","example":"SYN-ST-0B12","format":"synpute-id:ST","type":"string"},"standard":{"description":"Standard version the record conforms to","example":"synpute/v0.1","type":"string"},"status":{"description":"Lifecycle","enum":["registered","verifying","verified","in_transfer","retired"],"example":"verified","type":"string"}},"required":["created","hardware","id","liens","object","operator","owner","serials","site","standard","status"],"type":"object"},"Unit":{"description":"One GPU, identified by its serial","properties":{"cluster":{"description":"Cluster the unit belongs to","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"model":{"description":"GPU model","enum":["H100","H200","B200","B300","GB200","A100"],"example":"B200","type":"string"},"node":{"description":"Host node","example":"node-017","type":"string"},"object":{"description":"Object type","enum":["unit"],"example":"unit","type":"string"},"serial":{"description":"Manufacturer serial","example":"1652124007841","type":"string"},"status":{"description":"Attestation","enum":["attested","unmatched","missing","retired"],"example":"attested","type":"string"}},"required":["cluster","model","node","object","serial","status"],"type":"object"},"Contract":{"description":"A capacity contract: a buyer renting a cluster's capacity","properties":{"buyer":{"description":"Buyer (tenant)","example":"SYN-BY-0A9E","format":"synpute-id:BY","type":"string"},"cluster":{"description":"Cluster the capacity comes from","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"ends_on":{"description":"Contract end date","example":"2029-09-30","format":"date","type":"string"},"id":{"description":"Contract ID","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"},"object":{"description":"Object type","enum":["contract"],"example":"contract","type":"string"},"payment":{"description":"Payment terms","properties":{"frequency":{"description":"Invoice frequency","enum":["monthly","quarterly"],"example":"monthly","type":"string"},"net_days":{"description":"Days to pay after invoice","example":30,"type":"integer"},"prepaid_months":{"description":"Months prepaid at signing","example":3,"type":"integer"}},"required":["frequency","net_days","prepaid_months"],"type":"object"},"rate":{"description":"Price","properties":{"amount":{"description":"Rate per unit","example":2.1,"type":"number"},"currency":{"description":"Currency","enum":["USD","EUR","GBP"],"example":"USD","type":"string"},"unit":{"description":"Billing unit","enum":["gpu_hour","gpu_month","node_month"],"example":"gpu_hour","type":"string"}},"required":["amount","currency","unit"],"type":"object"},"reserved_units":{"description":"GPUs reserved under the contract","example":512,"type":"integer"},"starts_on":{"description":"Contract start date","example":"2026-10-01","format":"date","type":"string"},"status":{"description":"Lifecycle","enum":["draft","active","in_cure","terminated","expired"],"example":"active","type":"string"},"step_in":{"description":"Lender rights if the buyer defaults","properties":{"assignable":{"description":"Contract can be assigned to a replacement buyer","example":true,"type":"boolean"},"cure_period_days":{"description":"Days the buyer has to cure a default","example":30,"type":"integer"},"lender_directed":{"description":"The lender, not the operator, directs a transition","example":true,"type":"boolean"}},"required":["assignable","cure_period_days","lender_directed"],"type":"object"},"term_months":{"description":"Term","example":36,"type":"integer"}},"required":["buyer","cluster","created","ends_on","id","object","payment","rate","reserved_units","starts_on","status","step_in","term_months"],"type":"object"},"Facility":{"description":"A lender's financing, secured by clusters and their contracts","properties":{"borrower":{"description":"Borrowing operator","example":"SYN-OP-21C9","format":"synpute-id:OP","type":"string"},"collateral":{"description":"Clusters pledged","items":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"type":"array"},"contracts":{"description":"Contracts whose cash flows support the loan","items":{"description":"Contract ID","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"},"type":"array"},"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"id":{"description":"Facility ID","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"},"lender":{"description":"Lender (or agent)","example":"SYN-LN-8C31","format":"synpute-id:LN","type":"string"},"matures_on":{"description":"Maturity","example":"2031-10-01","format":"date","type":"string"},"object":{"description":"Object type","enum":["facility"],"example":"facility","type":"string"},"principal":{"description":"Committed principal","properties":{"amount":{"description":"Amount in the currency's minor unit (cents)","example":25000000000,"type":"integer"},"currency":{"description":"ISO 4217 currency","enum":["USD","EUR","GBP"],"example":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"status":{"description":"Lifecycle","enum":["proposed","active","in_transfer","repaid","defaulted"],"example":"active","type":"string"},"transfer_program":{"description":"Transfer program ID, if one is in place","example":"tp_2Lq9","type":["string","null"]}},"required":["borrower","collateral","contracts","created","id","lender","matures_on","object","principal","status","transfer_program"],"type":"object"},"Check":{"description":"One verification check and its evidence","properties":{"completed_at":{"description":"When it finished","example":"2026-10-02T15:58:00Z","format":"date-time","type":["string","null"]},"evidence":{"description":"What the result rests on","items":{"description":"Evidence item","properties":{"kind":{"description":"Source","enum":["registry_filing","document","inventory_scan","ucc_search","sanctions_list","attestation"],"example":"registry_filing","type":"string"},"reference":{"description":"Pointer to the source (no personal data)","example":"DE SOS #7741265","type":"string"}},"required":["kind","reference"],"type":"object"},"type":"array"},"notes":{"description":"Reviewer notes, if any","example":null,"type":["string","null"]},"status":{"description":"Result","enum":["verified","clear","flagged","failed","pending"],"example":"verified","type":"string"},"type":{"description":"Check","enum":["kyb","beneficial_owners","sanctions","serials","ownership","ucc_liens","site_lease","power_contract"],"example":"kyb","type":"string"}},"required":["completed_at","evidence","notes","status","type"],"type":"object"},"Verification":{"description":"A run of checks on one entity, site or cluster","properties":{"checks":{"description":"Checks in this run","items":{"$ref":"#/components/schemas/Check"},"type":"array"},"completed_at":{"description":"When the last check finished","example":"2026-10-02T16:00:00Z","format":"date-time","type":["string","null"]},"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"id":{"description":"Verification ID","example":"ver_9QmT2","type":"string"},"object":{"description":"Object type","enum":["verification"],"example":"verification","type":"string"},"requested_by":{"description":"Who asked for it","example":"SYN-LN-8C31","format":"synpute-id:LN|PL|OP","type":"string"},"status":{"description":"Lifecycle","enum":["pending","in_review","completed","failed"],"example":"completed","type":"string"},"subject":{"description":"What was verified","example":"SYN-OP-21C9","format":"synpute-id:OP|BY|ST|CL","type":"string"}},"required":["checks","completed_at","created","id","object","requested_by","status","subject"],"type":"object"},"Lien":{"description":"A UCC financing statement found against a cluster's units","properties":{"collateral_description":{"description":"As filed","example":"All GPU servers at 21571 Beaumeade Circle","type":"string"},"filed_on":{"description":"Filing date","example":"2025-03-11","format":"date","type":"string"},"filing_number":{"description":"State filing number","example":"VA-2025-0311-0042","type":"string"},"jurisdiction":{"description":"Filing state","example":"US-VA","type":"string"},"lapses_on":{"description":"Lapse date","example":"2030-03-11","format":"date","type":"string"},"object":{"description":"Object type","enum":["lien"],"example":"lien","type":"string"},"secured_party":{"description":"Secured party as filed","example":"Prior Lender NA","type":"string"},"status":{"description":"Status","enum":["active","terminated","lapsed"],"example":"active","type":"string"}},"required":["collateral_description","filed_on","filing_number","jurisdiction","lapses_on","object","secured_party","status"],"type":"object"},"RiskIndicator":{"description":"One risk indicator: flagged or clear, with the reason. Not a score.","properties":{"detail":{"description":"Plain-language finding","example":"Contract ends 12 months before loan maturity","type":"string"},"key":{"description":"Indicator","enum":["buyer_concentration","term_mismatch","re_lease_depth","hardware_generation","power_tenor","payment_history","related_party"],"example":"term_mismatch","type":"string"},"section":{"description":"Section","enum":["buyer","asset","contract"],"example":"contract","type":"string"},"status":{"description":"Status","enum":["flagged","clear","not_assessed"],"example":"flagged","type":"string"}},"required":["detail","key","section","status"],"type":"object"},"CreditProfile":{"description":"A standard diligence report on buyer, asset and contract","properties":{"asset":{"description":"Asset section","properties":{"cluster":{"description":"Cluster","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"hardware_generation":{"description":"GPU generation, as of report","example":"Blackwell","type":"string"},"re_lease_depth":{"description":"Comparable buyers for this hardware","enum":["deep","moderate","thin"],"example":"deep","type":"string"}},"required":["cluster","hardware_generation","re_lease_depth"],"type":"object"},"buyer":{"description":"Buyer section","properties":{"entity":{"description":"Buyer","example":"SYN-BY-0A9E","format":"synpute-id:BY","type":"string"},"public_rating":{"description":"Third-party agency rating, if the buyer has one (not issued by Synpute)","example":null,"type":["string","null"]},"revenue_share_pct":{"description":"This contract as a share of the buyer's compute spend, percent","example":41,"type":"number"}},"required":["entity","public_rating","revenue_share_pct"],"type":"object"},"contract":{"description":"Contract section","properties":{"contract":{"description":"Contract","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"},"months_short_of_maturity":{"description":"Months the contract ends before loan maturity (0 = covers it)","example":12,"type":"integer"},"step_in_rights":{"description":"Lender step-in rights present","example":true,"type":"boolean"}},"required":["contract","months_short_of_maturity","step_in_rights"],"type":"object"},"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"id":{"description":"Credit Profile ID","example":"cp_6Nw1","type":"string"},"indicators":{"description":"Risk indicators; flagged or clear, never a grade","items":{"$ref":"#/components/schemas/RiskIndicator"},"type":"array"},"methodology":{"description":"Methodology version","example":"cp/v0.1","type":"string"},"object":{"description":"Object type","enum":["credit_profile"],"example":"credit_profile","type":"string"},"status":{"description":"Lifecycle","enum":["requested","in_progress","ready","superseded"],"example":"ready","type":"string"}},"required":["asset","buyer","contract","created","id","indicators","methodology","object","status"],"type":"object"},"TelemetrySample":{"description":"One interval of cluster telemetry, pushed by the operator","properties":{"available_units":{"description":"GPUs up and schedulable","example":1021,"type":"integer"},"interval_end":{"description":"End of the interval","example":"2026-11-20T15:05:00Z","format":"date-time","type":"string"},"interval_start":{"description":"Start of the interval","example":"2026-11-20T15:00:00Z","format":"date-time","type":"string"},"utilized_units":{"description":"GPUs running customer workloads","example":893,"type":"integer"}},"required":["available_units","interval_end","interval_start","utilized_units"],"type":"object"},"PerformancePeriod":{"description":"Performance over one period, computed from telemetry and payments","properties":{"payments":{"description":"Payments in the period","properties":{"due":{"description":"Invoices due","example":3,"type":"integer"},"late":{"description":"Paid after due date","example":0,"type":"integer"},"received_on_time":{"description":"Paid on time","example":3,"type":"integer"}},"required":["due","late","received_on_time"],"type":"object"},"period":{"description":"Period label","example":"2026-Q3","type":"string"},"uptime_pct":{"description":"Share of unit-hours available","example":99.94,"type":"number"},"utilization_pct":{"description":"Share of available unit-hours in use","example":87.2,"type":"number"}},"required":["payments","period","uptime_pct","utilization_pct"],"type":"object"},"Payment":{"description":"A rent payment under a contract, as recorded by the operator or bank feed","properties":{"amount":{"description":"Amount paid","properties":{"amount":{"description":"Amount in the currency's minor unit (cents)","example":387000000,"type":"integer"},"currency":{"description":"ISO 4217 currency","enum":["USD","EUR","GBP"],"example":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"contract":{"description":"Contract","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"},"due_on":{"description":"Due date","example":"2026-10-31","format":"date","type":"string"},"id":{"description":"Payment ID","example":"pay_4Rt8","type":"string"},"object":{"description":"Object type","enum":["payment"],"example":"payment","type":"string"},"paid_on":{"description":"Date received","example":"2026-10-29","format":"date","type":["string","null"]},"source":{"description":"How it was recorded","enum":["bank_feed","operator","lender"],"example":"bank_feed","type":"string"},"status":{"description":"Status","enum":["paid","late","missed","pending"],"example":"paid","type":"string"}},"required":["amount","contract","due_on","id","object","paid_on","source","status"],"type":"object"},"Covenant":{"description":"A monitored condition on a facility","properties":{"facility":{"description":"Facility","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"},"id":{"description":"Covenant ID","example":"cov_1Bx5","type":"string"},"metric":{"description":"What's measured","enum":["uptime_pct","utilization_pct","payment_days_late","contract_coverage_months"],"example":"uptime_pct","type":"string"},"object":{"description":"Object type","enum":["covenant"],"example":"covenant","type":"string"},"status":{"description":"Current state","enum":["in_compliance","breached","cured"],"example":"in_compliance","type":"string"},"threshold":{"description":"Breach rule","properties":{"operator":{"description":"Comparison","enum":["lt","lte","gt","gte"],"example":"lt","type":"string"},"value":{"description":"Threshold","example":99.5,"type":"number"},"window":{"description":"Measured over","enum":["week","month","quarter"],"example":"month","type":"string"}},"required":["operator","value","window"],"type":"object"}},"required":["facility","id","metric","object","status","threshold"],"type":"object"},"Alert":{"description":"A covenant breach or monitoring signal worth a lender's attention","properties":{"cluster":{"description":"Cluster","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"covenant":{"description":"Covenant breached, if any","example":"cov_1Bx5","type":["string","null"]},"facility":{"description":"Facility","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"},"id":{"description":"Alert ID","example":"alr_3Pz8","type":"string"},"object":{"description":"Object type","enum":["alert"],"example":"alert","type":"string"},"opened_at":{"description":"When the condition was detected","example":"2026-08-14T09:00:00Z","format":"date-time","type":"string"},"resolved_at":{"description":"When it cleared","example":"2026-08-20T11:00:00Z","format":"date-time","type":["string","null"]},"severity":{"description":"How urgent","enum":["info","warning","critical"],"example":"warning","type":"string"},"status":{"description":"State","enum":["open","acknowledged","resolved"],"example":"resolved","type":"string"},"type":{"description":"Signal","enum":["payment_late","payment_missed","uptime_below","utilization_below","telemetry_gap","lien_filed"],"example":"payment_late","type":"string"}},"required":["cluster","covenant","facility","id","object","opened_at","resolved_at","severity","status","type"],"type":"object"},"Report":{"description":"A periodic monitoring report for a facility","properties":{"covenants":{"description":"Covenant states at period end","items":{"$ref":"#/components/schemas/Covenant"},"type":"array"},"facility":{"description":"Facility","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"},"id":{"description":"Report ID","example":"rpt_2026Q3_5D20","type":"string"},"object":{"description":"Object type","enum":["report"],"example":"report","type":"string"},"pdf_url":{"description":"Signed URL, valid 1 hour","example":"https://files.synpute.com/rpt_2026Q3_5D20.pdf","format":"uri","type":"string"},"performance":{"$ref":"#/components/schemas/PerformancePeriod"},"period":{"description":"Period","example":"2026-Q3","type":"string"}},"required":["covenants","facility","id","object","pdf_url","performance","period"],"type":"object"},"TransferProgram":{"description":"Pre-agreed terms for moving a cluster to a new buyer if a tenant fails","properties":{"budget_cap":{"description":"Most the transition can cost, paid from collections","properties":{"amount":{"description":"Amount in the currency's minor unit (cents)","example":120000000,"type":"integer"},"currency":{"description":"ISO 4217 currency","enum":["USD","EUR","GBP"],"example":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"eligible_buyers":{"description":"Vetted buyers on the standby list","example":6,"type":"integer"},"facility":{"description":"Facility","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"},"id":{"description":"Transfer program ID","example":"tp_2Lq9","type":"string"},"object":{"description":"Object type","enum":["transfer_program"],"example":"transfer_program","type":"string"},"status":{"description":"State","enum":["active","suspended","ended"],"example":"active","type":"string"},"triggers":{"description":"What lets the lender start a transfer","items":{"description":"Trigger","enum":["payment_default","buyer_insolvency","covenant_breach","operator_default"],"example":"payment_default","type":"string"},"type":"array"}},"required":["budget_cap","eligible_buyers","facility","id","object","status","triggers"],"type":"object"},"Transfer":{"description":"A lender-directed transition of a cluster to a new buyer, on the same IDs","properties":{"candidates":{"description":"Vetted buyers offered the capacity","items":{"description":"Candidate","properties":{"buyer":{"description":"Candidate buyer","example":"SYN-BY-0C71","format":"synpute-id:BY","type":"string"},"status":{"description":"Status","enum":["invited","diligence","accepted","declined"],"example":"accepted","type":"string"}},"required":["buyer","status"],"type":"object"},"type":"array"},"cluster":{"description":"Cluster being transferred","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"facility":{"description":"Facility","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"},"id":{"description":"Transfer ID","example":"trf_8Hc3","type":"string"},"new_contract":{"description":"Contract with the new buyer, once signed","example":"SYN-CT-9D10","format":"synpute-id:CT","type":["string","null"]},"object":{"description":"Object type","enum":["transfer"],"example":"transfer","type":"string"},"previous_contract":{"description":"Defaulted contract","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"},"stage":{"description":"Where it stands","enum":["notice","cure_period","step_in","marketing","re_leased","cancelled"],"example":"re_leased","type":"string"},"timeline":{"description":"Stage changes, oldest first","items":{"description":"Timeline entry","properties":{"at":{"description":"Date","example":"2027-03-21","format":"date","type":"string"},"stage":{"description":"Stage","enum":["notice","cure_period","step_in","marketing","re_leased","cancelled"],"example":"step_in","type":"string"}},"required":["at","stage"],"type":"object"},"type":"array"},"trigger":{"description":"Trigger used","enum":["payment_default","buyer_insolvency","covenant_breach","operator_default"],"example":"payment_default","type":"string"}},"required":["candidates","cluster","facility","id","new_contract","object","previous_contract","stage","timeline","trigger"],"type":"object"},"Grant":{"description":"Access to a record, given by its owner to another party","properties":{"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"expires_at":{"description":"When access ends; null = until revoked","example":null,"format":"date-time","type":["string","null"]},"grantee":{"description":"Who can read it","example":"SYN-LN-8C31","format":"synpute-id:LN|PL|BY","type":"string"},"id":{"description":"Grant ID","example":"grt_5Vk2","type":"string"},"object":{"description":"Object type","enum":["grant"],"example":"grant","type":"string"},"resource":{"description":"What is shared","example":"SYN-CL-7F3A","format":"synpute-id:CL|CT|FC|OP","type":"string"},"scopes":{"description":"What they can read","items":{"description":"Scope","enum":["registry:read","verify:read","monitor:read","credit_profile:read"],"example":"monitor:read","type":"string"},"type":"array"},"status":{"description":"State","enum":["active","revoked","expired"],"example":"active","type":"string"}},"required":["created","expires_at","grantee","id","object","resource","scopes","status"],"type":"object"},"Mark":{"description":"A reference price for GPU capacity, drawn from verified contracts","properties":{"as_of":{"description":"Observation date","example":"2027-03-31","format":"date","type":"string"},"gpu":{"description":"GPU model","enum":["H100","H200","B200","B300","GB200","A100"],"example":"H100","type":"string"},"inputs":{"description":"Verified contracts in the sample","example":0,"type":"integer"},"mark":{"description":"Reference price; null until published","example":0,"type":["number","null"]},"methodology":{"description":"Methodology version","example":"pr/v0.1","type":"string"},"object":{"description":"Object type","enum":["mark"],"example":"mark","type":"string"},"region":{"description":"Region","enum":["us","eu","apac"],"example":"us","type":"string"},"term":{"description":"Contract term bucket","enum":["spot","12m","36m","60m"],"example":"36m","type":"string"},"unit":{"description":"Unit","enum":["usd_per_gpu_hour"],"example":"usd_per_gpu_hour","type":"string"}},"required":["as_of","gpu","inputs","mark","methodology","object","region","term","unit"],"type":"object"},"LossMetric":{"description":"Credit outcomes for a cohort of registered financings","properties":{"cohort":{"description":"Financing vintage","example":"2026","type":"string"},"default_rate_pct":{"description":"Share of facilities that defaulted; null until published","example":0,"type":["number","null"]},"facilities":{"description":"Facilities in the cohort","example":0,"type":"integer"},"object":{"description":"Object type","enum":["loss_metric"],"example":"loss_metric","type":"string"},"recovery_rate_pct":{"description":"Recovered share of exposure at default","example":0,"type":["number","null"]},"time_to_re_lease_days":{"description":"Median days from default to a new contract","example":0,"type":["integer","null"]}},"required":["cohort","default_rate_pct","facilities","object","recovery_rate_pct","time_to_re_lease_days"],"type":"object"},"Event":{"description":"Something that happened to a record; delivered to webhooks and listed by /v1/events","properties":{"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"data":{"description":"The affected object, at the time of the event","properties":{},"required":[],"type":"object"},"id":{"description":"Event ID","example":"evt_1Gh7","type":"string"},"object":{"description":"Object type","enum":["event"],"example":"event","type":"string"},"resource":{"description":"Synpute ID or object ID it concerns","example":"SYN-CL-7F3A","type":"string"},"type":{"description":"Event type, e.g. alert.opened","example":"alert.opened","type":"string"}},"required":["created","data","id","object","resource","type"],"type":"object"},"WebhookEndpoint":{"description":"Where Synpute delivers events","properties":{"created":{"description":"When the record was created","example":"2026-10-02T14:30:00Z","format":"date-time","type":"string"},"events":{"description":"Event types sent here","items":{"description":"Event type","example":"alert.opened","type":"string"},"type":"array"},"id":{"description":"Endpoint ID","example":"we_3Ks1","type":"string"},"object":{"description":"Object type","enum":["webhook_endpoint"],"example":"webhook_endpoint","type":"string"},"secret":{"description":"Signing secret, shown once at creation","example":"whsec_…","type":"string"},"status":{"description":"State","enum":["enabled","disabled"],"example":"enabled","type":"string"},"url":{"description":"HTTPS URL","example":"https://example.com/hooks/synpute","format":"uri","type":"string"}},"required":["created","events","id","object","secret","status","url"],"type":"object"},"Error":{"description":"Every 4xx and 5xx has this shape","properties":{"error":{"description":"The error","properties":{"code":{"description":"Machine-readable code","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","rate_limited","internal"],"example":"not_found","type":"string"},"message":{"description":"What went wrong, for a human","example":"No cluster with ID SYN-CL-0000.","type":"string"},"param":{"description":"Offending parameter, if any","example":null,"type":["string","null"]},"request_id":{"description":"Quote this to support","example":"req_7Hk2","type":"string"}},"required":["code","message","param","request_id"],"type":"object"}},"required":["error"],"type":"object"}},"securitySchemes":{"apiKey":{"bearerFormat":"sk_live_… / sk_test_…","description":"Send your secret key as a bearer token. Keys are issued per environment and scoped: registry:write, registry:read, facilities:write, monitor:read, verify:write, verify:read, credit_profile:write, credit_profile:read, monitor:write, transfer:write, transfer:read, grants:write, grants:read, data:read, events:read, events:write.","scheme":"bearer","type":"http"}}},"info":{"contact":{"email":"api@synpute.com","name":"Synpute API"},"description":"Verified counterparties, registered compute assets and contracts, live performance, transfers and reference data, keyed to Synpute IDs. Draft for founding partners: shapes may change before v1.","title":"Synpute API","version":"0.1.0-draft"},"openapi":"3.1.0","paths":{"/v1/entities":{"post":{"description":"Register a legal entity so it can be verified, granted access or named in records. Synpute assigns the ID; the prefix follows the role.","operationId":"createEntity","requestBody":{"content":{"application/json":{"example":{"jurisdiction":"US-DE","legal_name":"Example Compute LLC","registration_number":"7741265","role":"operator"},"schema":{"description":"Entity to register","properties":{"jurisdiction":{"description":"Place of incorporation, ISO 3166-2","example":"US-DE","type":"string"},"legal_name":{"description":"Registered legal name","example":"Example Compute LLC","type":"string"},"registration_number":{"description":"Company registry number","example":"7741265","type":"string"},"role":{"description":"Role","enum":["operator","buyer","lender","platform"],"example":"operator","type":"string"}},"required":["jurisdiction","legal_name","registration_number","role"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"beneficial_owners":[{"name":"A. Rivera","share_pct":40,"verified":true}],"created":"2026-10-02T14:30:00Z","id":"SYN-OP-21C9","jurisdiction":"US-DE","legal_name":"Example Compute LLC","object":"entity","registration_number":"7741265","role":"operator","verification":{"checked_at":"2026-10-02T16:00:00Z","checks":[{"status":"verified","type":"kyb"}],"status":"verified"}},"schema":{"$ref":"#/components/schemas/Entity"}}},"description":"The new entity"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"409":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflicts with the record's state"}},"security":[{"apiKey":["registry:write"]}],"summary":"Create an entity","tags":["Entities"],"x-status":"preview"},"get":{"description":"Entities you've registered or been granted access to.","operationId":"listEntities","parameters":[{"description":"Filter by role","example":"buyer","in":"query","name":"role","schema":{"description":"Role","enum":["operator","buyer","lender","platform"],"example":"operator","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"beneficial_owners":[{"name":"A. Rivera","share_pct":40,"verified":true}],"created":"2026-10-02T14:30:00Z","id":"SYN-OP-21C9","jurisdiction":"US-DE","legal_name":"Example Compute LLC","object":"entity","registration_number":"7741265","role":"operator","verification":{"checked_at":"2026-10-02T16:00:00Z","checks":[{"status":"verified","type":"kyb"}],"status":"verified"}}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Entities","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Entity"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of entities"}},"security":[{"apiKey":["registry:read"]}],"summary":"List entities","tags":["Entities"],"x-status":"preview"}},"/v1/entities/{entity_id}":{"get":{"description":"An operator, buyer, lender or platform: legal identity, declared owners and the latest status of each check.","operationId":"getEntity","parameters":[{"description":"Entity ID","example":"SYN-OP-21C9","in":"path","name":"entity_id","required":true,"schema":{"description":"Entity ID","example":"SYN-OP-21C9","format":"synpute-id:OP|BY|LN|PL","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"beneficial_owners":[{"name":"A. Rivera","share_pct":40,"verified":true}],"created":"2026-10-02T14:30:00Z","id":"SYN-OP-21C9","jurisdiction":"US-DE","legal_name":"Example Compute LLC","object":"entity","registration_number":"7741265","role":"operator","verification":{"checked_at":"2026-10-02T16:00:00Z","checks":[{"status":"verified","type":"kyb"}],"status":"verified"}},"schema":{"$ref":"#/components/schemas/Entity"}}},"description":"The entity"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["registry:read"]}],"summary":"Retrieve an entity","tags":["Entities"],"x-status":"preview"}},"/v1/sites":{"post":{"description":"Register a site with its lease and power contract, so clusters can be placed in it and both can be verified.","operationId":"createSite","requestBody":{"content":{"application/json":{"example":{"address":{"city":"Ashburn","country":"US","line1":"21571 Beaumeade Circle","postal_code":"20147","region":"VA"},"lease":{"expires_on":"2036-06-30","landlord":"Beaumeade Data Partners LP"},"operator":"SYN-OP-21C9","power":{"contract_ends_on":"2036-06-30","contracted_mw":24,"utility":"Dominion Energy"}},"schema":{"description":"Site to register","properties":{"address":{"$ref":"#/components/schemas/Address"},"lease":{"description":"Lease","properties":{"expires_on":{"description":"Lease end date","example":"2036-06-30","format":"date","type":"string"},"landlord":{"description":"Landlord legal name","example":"Beaumeade Data Partners LP","type":"string"}},"required":["expires_on","landlord"],"type":"object"},"operator":{"description":"Operator occupying the site","example":"SYN-OP-21C9","format":"synpute-id:OP","type":"string"},"power":{"description":"Power","properties":{"contract_ends_on":{"description":"Power contract end date","example":"2036-06-30","format":"date","type":"string"},"contracted_mw":{"description":"Contracted capacity, MW","example":24,"type":"number"},"utility":{"description":"Utility or supplier","example":"Dominion Energy","type":"string"}},"required":["contract_ends_on","contracted_mw","utility"],"type":"object"}},"required":["address","lease","operator","power"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"address":{"city":"Ashburn","country":"US","line1":"21571 Beaumeade Circle","postal_code":"20147","region":"VA"},"created":"2026-10-02T14:30:00Z","id":"SYN-ST-0B12","lease":{"expires_on":"2036-06-30","landlord":"Beaumeade Data Partners LP","verified":true},"object":"site","operator":"SYN-OP-21C9","power":{"contract_ends_on":"2036-06-30","contracted_mw":24,"utility":"Dominion Energy"},"tier":"III"},"schema":{"$ref":"#/components/schemas/Site"}}},"description":"The new site"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"}},"security":[{"apiKey":["registry:write"]}],"summary":"Create a site","tags":["Sites"],"x-status":"preview"}},"/v1/sites/{site_id}":{"get":{"description":"A site: location, lease, contracted power and certification.","operationId":"getSite","parameters":[{"description":"Site ID","example":"SYN-ST-0B12","in":"path","name":"site_id","required":true,"schema":{"description":"Site ID","example":"SYN-ST-0B12","format":"synpute-id:ST","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"address":{"city":"Ashburn","country":"US","line1":"21571 Beaumeade Circle","postal_code":"20147","region":"VA"},"created":"2026-10-02T14:30:00Z","id":"SYN-ST-0B12","lease":{"expires_on":"2036-06-30","landlord":"Beaumeade Data Partners LP","verified":true},"object":"site","operator":"SYN-OP-21C9","power":{"contract_ends_on":"2036-06-30","contracted_mw":24,"utility":"Dominion Energy"},"tier":"III"},"schema":{"$ref":"#/components/schemas/Site"}}},"description":"The site"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["registry:read"]}],"summary":"Retrieve a site","tags":["Sites"],"x-status":"preview"}},"/v1/clusters":{"post":{"description":"Register a cluster in the Synpute Standard format. Upload units in bulk afterwards; serial attestation starts once a verification runs.","operationId":"createCluster","requestBody":{"content":{"application/json":{"example":{"hardware":{"gpu":"B200","interconnect":"infiniband","node_count":128,"unit_count":1024},"operator":"SYN-OP-21C9","owner":"SYN-OP-21C9","site":"SYN-ST-0B12"},"schema":{"description":"Cluster to register","properties":{"hardware":{"description":"Hardware","properties":{"gpu":{"description":"GPU model","enum":["H100","H200","B200","B300","GB200","A100"],"example":"B200","type":"string"},"interconnect":{"description":"Fabric","enum":["infiniband","roce","ethernet"],"example":"infiniband","type":"string"},"node_count":{"description":"Servers","example":128,"type":"integer"},"unit_count":{"description":"GPUs","example":1024,"type":"integer"}},"required":["gpu","interconnect","node_count","unit_count"],"type":"object"},"operator":{"description":"Operator","example":"SYN-OP-21C9","format":"synpute-id:OP","type":"string"},"owner":{"description":"Legal owner of the hardware","example":"SYN-OP-21C9","format":"synpute-id:OP","type":"string"},"site":{"description":"Site","example":"SYN-ST-0B12","format":"synpute-id:ST","type":"string"}},"required":["hardware","operator","owner","site"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"created":"2026-10-02T14:30:00Z","hardware":{"gpu":"B200","interconnect":"infiniband","node_count":128,"unit_count":1024},"id":"SYN-CL-7F3A","liens":{"filings":0,"searched_at":"2026-10-03"},"object":"cluster","operator":"SYN-OP-21C9","owner":"SYN-OP-21C9","serials":{"attested":1024,"total":1024},"site":"SYN-ST-0B12","standard":"synpute/v0.1","status":"verified"},"schema":{"$ref":"#/components/schemas/Cluster"}}},"description":"The new cluster"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["registry:write"]}],"summary":"Register a cluster","tags":["Clusters"],"x-status":"preview"},"get":{"description":"Clusters you've registered or been granted.","operationId":"listClusters","parameters":[{"description":"Filter by operator ID","example":"SYN-OP-21C9","in":"query","name":"operator","schema":{"description":"Operator ID","type":"string"}},{"description":"Filter by lifecycle","example":"verified","in":"query","name":"status","schema":{"description":"Status","enum":["registered","verifying","verified","in_transfer","retired"],"example":"registered","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"created":"2026-10-02T14:30:00Z","hardware":{"gpu":"B200","interconnect":"infiniband","node_count":128,"unit_count":1024},"id":"SYN-CL-7F3A","liens":{"filings":0,"searched_at":"2026-10-03"},"object":"cluster","operator":"SYN-OP-21C9","owner":"SYN-OP-21C9","serials":{"attested":1024,"total":1024},"site":"SYN-ST-0B12","standard":"synpute/v0.1","status":"verified"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Clusters","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Cluster"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of clusters"}},"security":[{"apiKey":["registry:read"]}],"summary":"List clusters","tags":["Clusters"],"x-status":"preview"}},"/v1/clusters/{cluster_id}":{"get":{"description":"A registered cluster: hardware, serial attestation, site, owner and lien search status.","operationId":"getCluster","parameters":[{"description":"Cluster ID","example":"SYN-CL-7F3A","in":"path","name":"cluster_id","required":true,"schema":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"created":"2026-10-02T14:30:00Z","hardware":{"gpu":"B200","interconnect":"infiniband","node_count":128,"unit_count":1024},"id":"SYN-CL-7F3A","liens":{"filings":0,"searched_at":"2026-10-03"},"object":"cluster","operator":"SYN-OP-21C9","owner":"SYN-OP-21C9","serials":{"attested":1024,"total":1024},"site":"SYN-ST-0B12","standard":"synpute/v0.1","status":"verified"},"schema":{"$ref":"#/components/schemas/Cluster"}}},"description":"The cluster"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["registry:read"]}],"summary":"Retrieve a cluster","tags":["Clusters"],"x-status":"preview"}},"/v1/clusters/{cluster_id}/units":{"post":{"description":"Add GPUs to a cluster by serial, in bulk. Serials are matched against invoices and on-site inventory when the cluster is verified.","operationId":"createUnits","parameters":[{"description":"Cluster ID","example":"SYN-CL-7F3A","in":"path","name":"cluster_id","required":true,"schema":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"units":[{"model":"B200","node":"node-017","serial":"1652124007841"}]},"schema":{"description":"Units to add","properties":{"units":{"description":"Up to 5,000 per call","items":{"description":"Unit","properties":{"model":{"description":"GPU model","enum":["H100","H200","B200","B300","GB200","A100"],"example":"B200","type":"string"},"node":{"description":"Host node","example":"node-017","type":"string"},"serial":{"description":"Manufacturer serial","example":"1652124007841","type":"string"}},"required":["model","node","serial"],"type":"object"},"type":"array"}},"required":["units"],"type":"object"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"accepted":1024,"duplicates":0},"schema":{"description":"Receipt","properties":{"accepted":{"description":"Units added","example":1024,"type":"integer"},"duplicates":{"description":"Serials already registered elsewhere","example":0,"type":"integer"}},"required":["accepted","duplicates"],"type":"object"}}},"description":"Accepted"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"},"409":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflicts with the record's state"}},"security":[{"apiKey":["registry:write"]}],"summary":"Add units","tags":["Clusters"],"x-status":"preview"},"get":{"description":"Every GPU in a cluster, by serial, with its attestation status.","operationId":"listUnits","parameters":[{"description":"Cluster ID","example":"SYN-CL-7F3A","in":"path","name":"cluster_id","required":true,"schema":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"}},{"description":"Filter by attestation","example":"unmatched","in":"query","name":"status","schema":{"description":"Status","enum":["attested","unmatched","missing","retired"],"example":"attested","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"cluster":"SYN-CL-7F3A","model":"B200","node":"node-017","object":"unit","serial":"1652124007841","status":"attested"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Units","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Unit"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of units"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["registry:read"]}],"summary":"List units","tags":["Clusters"],"x-status":"preview"}},"/v1/contracts":{"post":{"description":"Register a capacity contract between an operator's cluster and a buyer, including the step-in terms a lender relies on.","operationId":"createContract","requestBody":{"content":{"application/json":{"example":{"buyer":"SYN-BY-0A9E","cluster":"SYN-CL-7F3A","rate":{"amount":2.1,"currency":"USD","unit":"gpu_hour"},"reserved_units":512,"starts_on":"2026-10-01","step_in":{"assignable":true,"cure_period_days":30},"term_months":36},"schema":{"description":"Contract to register","properties":{"buyer":{"description":"Buyer","example":"SYN-BY-0A9E","format":"synpute-id:BY","type":"string"},"cluster":{"description":"Cluster","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"rate":{"description":"Price","properties":{"amount":{"description":"Rate per unit","example":2.1,"type":"number"},"currency":{"description":"Currency","enum":["USD","EUR","GBP"],"example":"USD","type":"string"},"unit":{"description":"Billing unit","enum":["gpu_hour","gpu_month","node_month"],"example":"gpu_hour","type":"string"}},"required":["amount","currency","unit"],"type":"object"},"reserved_units":{"description":"GPUs reserved","example":512,"type":"integer"},"starts_on":{"description":"Start date","example":"2026-10-01","format":"date","type":"string"},"step_in":{"description":"Step-in terms","properties":{"assignable":{"description":"Assignable to a replacement buyer","example":true,"type":"boolean"},"cure_period_days":{"description":"Cure period, days","example":30,"type":"integer"}},"required":["assignable","cure_period_days"],"type":"object"},"term_months":{"description":"Term","example":36,"type":"integer"}},"required":["buyer","cluster","rate","reserved_units","starts_on","step_in","term_months"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"buyer":"SYN-BY-0A9E","cluster":"SYN-CL-7F3A","created":"2026-10-02T14:30:00Z","ends_on":"2029-09-30","id":"SYN-CT-4B71","object":"contract","payment":{"frequency":"monthly","net_days":30,"prepaid_months":3},"rate":{"amount":2.1,"currency":"USD","unit":"gpu_hour"},"reserved_units":512,"starts_on":"2026-10-01","status":"active","step_in":{"assignable":true,"cure_period_days":30,"lender_directed":true},"term_months":36},"schema":{"$ref":"#/components/schemas/Contract"}}},"description":"The new contract"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"409":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflicts with the record's state"}},"security":[{"apiKey":["registry:write"]}],"summary":"Register a contract","tags":["Contracts"],"x-status":"preview"},"get":{"description":"Contracts you're party to or have been granted.","operationId":"listContracts","parameters":[{"description":"Filter by cluster","example":"SYN-CL-7F3A","in":"query","name":"cluster","schema":{"description":"Cluster ID","type":"string"}},{"description":"Filter by buyer","example":"SYN-BY-0A9E","in":"query","name":"buyer","schema":{"description":"Buyer ID","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"buyer":"SYN-BY-0A9E","cluster":"SYN-CL-7F3A","created":"2026-10-02T14:30:00Z","ends_on":"2029-09-30","id":"SYN-CT-4B71","object":"contract","payment":{"frequency":"monthly","net_days":30,"prepaid_months":3},"rate":{"amount":2.1,"currency":"USD","unit":"gpu_hour"},"reserved_units":512,"starts_on":"2026-10-01","status":"active","step_in":{"assignable":true,"cure_period_days":30,"lender_directed":true},"term_months":36}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Contracts","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Contract"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of contracts"}},"security":[{"apiKey":["registry:read"]}],"summary":"List contracts","tags":["Contracts"],"x-status":"preview"}},"/v1/contracts/{contract_id}":{"get":{"description":"A capacity contract: parties, term, rate, payment terms and step-in rights. Visible to its parties and to anyone they've granted.","operationId":"getContract","parameters":[{"description":"Contract ID","example":"SYN-CT-4B71","in":"path","name":"contract_id","required":true,"schema":{"description":"Contract ID","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"buyer":"SYN-BY-0A9E","cluster":"SYN-CL-7F3A","created":"2026-10-02T14:30:00Z","ends_on":"2029-09-30","id":"SYN-CT-4B71","object":"contract","payment":{"frequency":"monthly","net_days":30,"prepaid_months":3},"rate":{"amount":2.1,"currency":"USD","unit":"gpu_hour"},"reserved_units":512,"starts_on":"2026-10-01","status":"active","step_in":{"assignable":true,"cure_period_days":30,"lender_directed":true},"term_months":36},"schema":{"$ref":"#/components/schemas/Contract"}}},"description":"The contract"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["registry:read"]}],"summary":"Retrieve a contract","tags":["Contracts"],"x-status":"preview"}},"/v1/facilities":{"post":{"description":"Record a financing so Synpute can monitor it: the lender, the borrower, the clusters pledged and the contracts behind it.","operationId":"createFacility","requestBody":{"content":{"application/json":{"example":{"borrower":"SYN-OP-21C9","collateral":["SYN-CL-7F3A"],"contracts":["SYN-CT-4B71"],"matures_on":"2031-10-01","principal":{"amount":25000000000,"currency":"USD"}},"schema":{"description":"Facility to record","properties":{"borrower":{"description":"Borrowing operator","example":"SYN-OP-21C9","format":"synpute-id:OP","type":"string"},"collateral":{"description":"Clusters pledged","items":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"type":"array"},"contracts":{"description":"Supporting contracts","items":{"description":"Contract ID","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"},"type":"array"},"matures_on":{"description":"Maturity","example":"2031-10-01","format":"date","type":"string"},"principal":{"description":"Committed principal","properties":{"amount":{"description":"Amount in the currency's minor unit (cents)","example":25000000000,"type":"integer"},"currency":{"description":"ISO 4217 currency","enum":["USD","EUR","GBP"],"example":"USD","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["borrower","collateral","contracts","matures_on","principal"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"borrower":"SYN-OP-21C9","collateral":["SYN-CL-7F3A"],"contracts":["SYN-CT-4B71"],"created":"2026-10-02T14:30:00Z","id":"SYN-FC-5D20","lender":"SYN-LN-8C31","matures_on":"2031-10-01","object":"facility","principal":{"amount":25000000000,"currency":"USD"},"status":"active","transfer_program":"tp_2Lq9"},"schema":{"$ref":"#/components/schemas/Facility"}}},"description":"The new facility"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"}},"security":[{"apiKey":["facilities:write"]}],"summary":"Create a facility","tags":["Facilities"],"x-status":"preview"}},"/v1/facilities/{facility_id}":{"get":{"description":"A lender's financing and what secures it.","operationId":"getFacility","parameters":[{"description":"Facility ID","example":"SYN-FC-5D20","in":"path","name":"facility_id","required":true,"schema":{"description":"Facility ID","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"borrower":"SYN-OP-21C9","collateral":["SYN-CL-7F3A"],"contracts":["SYN-CT-4B71"],"created":"2026-10-02T14:30:00Z","id":"SYN-FC-5D20","lender":"SYN-LN-8C31","matures_on":"2031-10-01","object":"facility","principal":{"amount":25000000000,"currency":"USD"},"status":"active","transfer_program":"tp_2Lq9"},"schema":{"$ref":"#/components/schemas/Facility"}}},"description":"The facility"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["monitor:read"]}],"summary":"Retrieve a facility","tags":["Facilities"],"x-status":"preview"}},"/v1/verifications":{"post":{"description":"Run checks on an entity, site or cluster. Runs asynchronously; listen for verification.completed or poll. A check already run within its validity window is reused, not repeated.","operationId":"createVerification","requestBody":{"content":{"application/json":{"example":{"checks":["kyb"],"subject":"SYN-OP-21C9"},"schema":{"description":"What to verify","properties":{"checks":{"description":"Checks to run","items":{"description":"Check","enum":["kyb","beneficial_owners","sanctions","serials","ownership","ucc_liens","site_lease","power_contract"],"example":"kyb","type":"string"},"type":"array"},"subject":{"description":"Entity, site or cluster","example":"SYN-OP-21C9","format":"synpute-id:OP|BY|ST|CL","type":"string"}},"required":["checks","subject"],"type":"object"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"checks":[{"completed_at":"2026-10-02T15:58:00Z","evidence":[{"kind":"registry_filing","reference":"DE SOS #7741265"}],"notes":null,"status":"verified","type":"kyb"}],"completed_at":"2026-10-02T16:00:00Z","created":"2026-10-02T14:30:00Z","id":"ver_9QmT2","object":"verification","requested_by":"SYN-LN-8C31","status":"completed","subject":"SYN-OP-21C9"},"schema":{"$ref":"#/components/schemas/Verification"}}},"description":"Accepted; checks are running"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["verify:write"]}],"summary":"Start a verification","tags":["Verifications"],"x-status":"preview"},"get":{"description":"Verifications you requested or that cover records you can see.","operationId":"listVerifications","parameters":[{"description":"Filter by subject ID","example":"SYN-OP-21C9","in":"query","name":"subject","schema":{"description":"Synpute ID","type":"string"}},{"description":"Filter by status","example":"completed","in":"query","name":"status","schema":{"description":"Status","enum":["pending","in_review","completed","failed"],"example":"pending","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"checks":[{"completed_at":"2026-10-02T15:58:00Z","evidence":[{"kind":"registry_filing","reference":"DE SOS #7741265"}],"notes":null,"status":"verified","type":"kyb"}],"completed_at":"2026-10-02T16:00:00Z","created":"2026-10-02T14:30:00Z","id":"ver_9QmT2","object":"verification","requested_by":"SYN-LN-8C31","status":"completed","subject":"SYN-OP-21C9"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Verifications","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Verification"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of verifications"}},"security":[{"apiKey":["verify:read"]}],"summary":"List verifications","tags":["Verifications"],"x-status":"preview"}},"/v1/verifications/{verification_id}":{"get":{"description":"A verification with each check's result and the evidence it rests on.","operationId":"getVerification","parameters":[{"description":"Verification ID","example":"ver_9QmT2","in":"path","name":"verification_id","required":true,"schema":{"description":"Verification ID","example":"ver_9QmT2","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"checks":[{"completed_at":"2026-10-02T15:58:00Z","evidence":[{"kind":"registry_filing","reference":"DE SOS #7741265"}],"notes":null,"status":"verified","type":"kyb"}],"completed_at":"2026-10-02T16:00:00Z","created":"2026-10-02T14:30:00Z","id":"ver_9QmT2","object":"verification","requested_by":"SYN-LN-8C31","status":"completed","subject":"SYN-OP-21C9"},"schema":{"$ref":"#/components/schemas/Verification"}}},"description":"The verification"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["verify:read"]}],"summary":"Retrieve a verification","tags":["Verifications"],"x-status":"preview"}},"/v1/clusters/{cluster_id}/liens":{"get":{"description":"UCC financing statements found against a cluster's units in the latest search.","operationId":"listLiens","parameters":[{"description":"Cluster ID","example":"SYN-CL-7F3A","in":"path","name":"cluster_id","required":true,"schema":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"collateral_description":"All GPU servers at 21571 Beaumeade Circle","filed_on":"2025-03-11","filing_number":"VA-2025-0311-0042","jurisdiction":"US-VA","lapses_on":"2030-03-11","object":"lien","secured_party":"Prior Lender NA","status":"active"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Liens","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Lien"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"Liens"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["verify:read"]}],"summary":"List liens","tags":["Verifications"],"x-status":"preview"}},"/v1/credit-profiles":{"post":{"description":"Commission a Credit Profile on a contract: its buyer, the asset behind it and the contract's terms. Delivered in two to four weeks; listen for credit_profile.ready.","operationId":"createCreditProfile","requestBody":{"content":{"application/json":{"example":{"contract":"SYN-CT-4B71","share_with":["SYN-LN-8C31"]},"schema":{"description":"What to profile","properties":{"contract":{"description":"Contract to profile","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"},"share_with":{"description":"Lenders to grant on delivery","items":{"description":"Lender ID","example":"SYN-LN-8C31","format":"synpute-id:LN","type":"string"},"type":"array"}},"required":["contract","share_with"],"type":"object"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"asset":{"cluster":"SYN-CL-7F3A","hardware_generation":"Blackwell","re_lease_depth":"deep"},"buyer":{"entity":"SYN-BY-0A9E","public_rating":null,"revenue_share_pct":41},"contract":{"contract":"SYN-CT-4B71","months_short_of_maturity":12,"step_in_rights":true},"created":"2026-10-02T14:30:00Z","id":"cp_6Nw1","indicators":[{"detail":"Contract ends 12 months before loan maturity","key":"term_mismatch","section":"contract","status":"flagged"}],"methodology":"cp/v0.1","object":"credit_profile","status":"ready"},"schema":{"$ref":"#/components/schemas/CreditProfile"}}},"description":"Requested"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"},"409":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflicts with the record's state"}},"security":[{"apiKey":["credit_profile:write"]}],"summary":"Request a Credit Profile","tags":["Credit Profiles"],"x-status":"planned"}},"/v1/credit-profiles/{credit_profile_id}":{"get":{"description":"A Credit Profile: buyer, asset and contract sections and the risk indicators found. Indicators are flagged or clear with a reason; Synpute does not grade or rate.","operationId":"getCreditProfile","parameters":[{"description":"Credit Profile ID","example":"cp_6Nw1","in":"path","name":"credit_profile_id","required":true,"schema":{"description":"Credit Profile ID","example":"cp_6Nw1","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"asset":{"cluster":"SYN-CL-7F3A","hardware_generation":"Blackwell","re_lease_depth":"deep"},"buyer":{"entity":"SYN-BY-0A9E","public_rating":null,"revenue_share_pct":41},"contract":{"contract":"SYN-CT-4B71","months_short_of_maturity":12,"step_in_rights":true},"created":"2026-10-02T14:30:00Z","id":"cp_6Nw1","indicators":[{"detail":"Contract ends 12 months before loan maturity","key":"term_mismatch","section":"contract","status":"flagged"}],"methodology":"cp/v0.1","object":"credit_profile","status":"ready"},"schema":{"$ref":"#/components/schemas/CreditProfile"}}},"description":"The Credit Profile"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["credit_profile:read"]}],"summary":"Retrieve a Credit Profile","tags":["Credit Profiles"],"x-status":"planned"}},"/v1/clusters/{cluster_id}/telemetry":{"post":{"description":"Push telemetry for a cluster. Send batches of up to 1,000 five-minute intervals; late samples are accepted for 7 days.","operationId":"createTelemetry","parameters":[{"description":"Cluster ID","example":"SYN-CL-7F3A","in":"path","name":"cluster_id","required":true,"schema":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"samples":[{"available_units":1021,"interval_end":"2026-11-20T15:05:00Z","interval_start":"2026-11-20T15:00:00Z","utilized_units":893}]},"schema":{"description":"Samples","properties":{"samples":{"description":"Telemetry intervals","items":{"$ref":"#/components/schemas/TelemetrySample"},"type":"array"}},"required":["samples"],"type":"object"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"accepted":288,"rejected":0},"schema":{"description":"Receipt","properties":{"accepted":{"description":"Samples accepted","example":288,"type":"integer"},"rejected":{"description":"Samples rejected","example":0,"type":"integer"}},"required":["accepted","rejected"],"type":"object"}}},"description":"Accepted"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["monitor:write"]}],"summary":"Send telemetry","tags":["Monitoring"],"x-status":"preview"}},"/v1/clusters/{cluster_id}/performance":{"get":{"description":"Uptime, utilization and payment history for a cluster, by period.","operationId":"listPerformance","parameters":[{"description":"Cluster ID","example":"SYN-CL-7F3A","in":"path","name":"cluster_id","required":true,"schema":{"description":"Cluster ID","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"}},{"description":"Granularity","example":"quarter","in":"query","name":"period","schema":{"description":"Period","enum":["week","month","quarter"],"example":"quarter","type":"string"}},{"description":"Earliest period, ISO date","example":"2026-01-01","in":"query","name":"from","schema":{"description":"Date","format":"date","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"cluster":"SYN-CL-7F3A","data":[{"payments":{"due":3,"late":0,"received_on_time":3},"period":"2026-Q3","uptime_pct":99.94,"utilization_pct":87.2}],"object":"list"},"schema":{"description":"Performance","properties":{"cluster":{"description":"Cluster","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"data":{"description":"Periods, newest first","items":{"$ref":"#/components/schemas/PerformancePeriod"},"type":"array"},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["cluster","data","object"],"type":"object"}}},"description":"Performance by period"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["monitor:read"]}],"summary":"List performance","tags":["Monitoring"],"x-status":"preview"}},"/v1/contracts/{contract_id}/payments":{"post":{"description":"Record a rent payment under a contract. Operators send payments; lenders can confirm them from a bank feed.","operationId":"createPayment","parameters":[{"description":"Contract ID","example":"SYN-CT-4B71","in":"path","name":"contract_id","required":true,"schema":{"description":"Contract ID","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"amount":{"amount":387000000,"currency":"USD"},"due_on":"2026-10-31","paid_on":"2026-10-29"},"schema":{"description":"Payment","properties":{"amount":{"description":"Amount paid","properties":{"amount":{"description":"Amount in the currency's minor unit (cents)","example":387000000,"type":"integer"},"currency":{"description":"ISO 4217 currency","enum":["USD","EUR","GBP"],"example":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"due_on":{"description":"Due date","example":"2026-10-31","format":"date","type":"string"},"paid_on":{"description":"Date received","example":"2026-10-29","format":"date","type":"string"}},"required":["amount","due_on","paid_on"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"amount":{"amount":387000000,"currency":"USD"},"contract":"SYN-CT-4B71","due_on":"2026-10-31","id":"pay_4Rt8","object":"payment","paid_on":"2026-10-29","source":"bank_feed","status":"paid"},"schema":{"$ref":"#/components/schemas/Payment"}}},"description":"The payment"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["monitor:write"]}],"summary":"Record a payment","tags":["Monitoring"],"x-status":"preview"},"get":{"description":"Payments under a contract, with status against the due date.","operationId":"listPayments","parameters":[{"description":"Contract ID","example":"SYN-CT-4B71","in":"path","name":"contract_id","required":true,"schema":{"description":"Contract ID","example":"SYN-CT-4B71","format":"synpute-id:CT","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"amount":{"amount":387000000,"currency":"USD"},"contract":"SYN-CT-4B71","due_on":"2026-10-31","id":"pay_4Rt8","object":"payment","paid_on":"2026-10-29","source":"bank_feed","status":"paid"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Payments","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Payment"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of payments"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["monitor:read"]}],"summary":"List payments","tags":["Monitoring"],"x-status":"preview"}},"/v1/facilities/{facility_id}/covenants":{"post":{"description":"Add a monitored covenant to a facility. A breach opens an alert and fires covenant.breached.","operationId":"createCovenant","parameters":[{"description":"Facility ID","example":"SYN-FC-5D20","in":"path","name":"facility_id","required":true,"schema":{"description":"Facility ID","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"metric":"uptime_pct","threshold":{"operator":"lt","value":99.5,"window":"month"}},"schema":{"description":"Covenant","properties":{"metric":{"description":"Metric","enum":["uptime_pct","utilization_pct","payment_days_late","contract_coverage_months"],"example":"uptime_pct","type":"string"},"threshold":{"description":"Breach rule","properties":{"operator":{"description":"Comparison","enum":["lt","lte","gt","gte"],"example":"lt","type":"string"},"value":{"description":"Threshold","example":99.5,"type":"number"},"window":{"description":"Window","enum":["week","month","quarter"],"example":"month","type":"string"}},"required":["operator","value","window"],"type":"object"}},"required":["metric","threshold"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"facility":"SYN-FC-5D20","id":"cov_1Bx5","metric":"uptime_pct","object":"covenant","status":"in_compliance","threshold":{"operator":"lt","value":99.5,"window":"month"}},"schema":{"$ref":"#/components/schemas/Covenant"}}},"description":"The covenant"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["facilities:write"]}],"summary":"Create a covenant","tags":["Monitoring"],"x-status":"preview"}},"/v1/alerts":{"get":{"description":"Alerts across your facilities: covenant breaches, late payments, telemetry gaps and new liens.","operationId":"listAlerts","parameters":[{"description":"Filter by facility","example":"SYN-FC-5D20","in":"query","name":"facility","schema":{"description":"Facility ID","type":"string"}},{"description":"Filter by state","example":"open","in":"query","name":"status","schema":{"description":"Status","enum":["open","acknowledged","resolved"],"example":"open","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"cluster":"SYN-CL-7F3A","covenant":"cov_1Bx5","facility":"SYN-FC-5D20","id":"alr_3Pz8","object":"alert","opened_at":"2026-08-14T09:00:00Z","resolved_at":"2026-08-20T11:00:00Z","severity":"warning","status":"resolved","type":"payment_late"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Alerts","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Alert"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of alerts"}},"security":[{"apiKey":["monitor:read"]}],"summary":"List alerts","tags":["Monitoring"],"x-status":"preview"}},"/v1/alerts/{alert_id}/acknowledge":{"post":{"description":"Mark an alert as seen. It resolves on its own when the condition clears.","operationId":"acknowledgeAlert","parameters":[{"description":"Alert ID","example":"alr_3Pz8","in":"path","name":"alert_id","required":true,"schema":{"description":"Alert ID","example":"alr_3Pz8","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"cluster":"SYN-CL-7F3A","covenant":"cov_1Bx5","facility":"SYN-FC-5D20","id":"alr_3Pz8","object":"alert","opened_at":"2026-08-14T09:00:00Z","resolved_at":"2026-08-20T11:00:00Z","severity":"warning","status":"resolved","type":"payment_late"},"schema":{"$ref":"#/components/schemas/Alert"}}},"description":"The alert"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"},"409":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflicts with the record's state"}},"security":[{"apiKey":["monitor:write"]}],"summary":"Acknowledge an alert","tags":["Monitoring"],"x-status":"planned"}},"/v1/facilities/{facility_id}/reports":{"get":{"description":"Periodic monitoring reports for a facility, each with a signed PDF link.","operationId":"listReports","parameters":[{"description":"Facility ID","example":"SYN-FC-5D20","in":"path","name":"facility_id","required":true,"schema":{"description":"Facility ID","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"covenants":[{"facility":"SYN-FC-5D20","id":"cov_1Bx5","metric":"uptime_pct","object":"covenant","status":"in_compliance","threshold":{"operator":"lt","value":99.5,"window":"month"}}],"facility":"SYN-FC-5D20","id":"rpt_2026Q3_5D20","object":"report","pdf_url":"https://files.synpute.com/rpt_2026Q3_5D20.pdf","performance":{"payments":{"due":3,"late":0,"received_on_time":3},"period":"2026-Q3","uptime_pct":99.94,"utilization_pct":87.2},"period":"2026-Q3"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Reports","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Report"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of reports"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["monitor:read"]}],"summary":"List reports","tags":["Monitoring"],"x-status":"preview"}},"/v1/facilities/{facility_id}/transfer-program":{"post":{"description":"Put a transfer program in place on a facility: the triggers, the transition budget cap and the standby list of vetted buyers.","operationId":"createTransferProgram","parameters":[{"description":"Facility ID","example":"SYN-FC-5D20","in":"path","name":"facility_id","required":true,"schema":{"description":"Facility ID","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"budget_cap":{"amount":120000000,"currency":"USD"},"triggers":["payment_default"]},"schema":{"description":"Program terms","properties":{"budget_cap":{"description":"Transition budget cap","properties":{"amount":{"description":"Amount in the currency's minor unit (cents)","example":120000000,"type":"integer"},"currency":{"description":"ISO 4217 currency","enum":["USD","EUR","GBP"],"example":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"triggers":{"description":"Triggers","items":{"description":"Trigger","enum":["payment_default","buyer_insolvency","covenant_breach","operator_default"],"example":"payment_default","type":"string"},"type":"array"}},"required":["budget_cap","triggers"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"budget_cap":{"amount":120000000,"currency":"USD"},"eligible_buyers":6,"facility":"SYN-FC-5D20","id":"tp_2Lq9","object":"transfer_program","status":"active","triggers":["payment_default"]},"schema":{"$ref":"#/components/schemas/TransferProgram"}}},"description":"The program"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"},"409":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflicts with the record's state"}},"security":[{"apiKey":["transfer:write"]}],"summary":"Create a transfer program","tags":["Transfers"],"x-status":"planned"}},"/v1/transfers":{"post":{"description":"Start a transfer after a trigger. Only the facility's lender can call this; Synpute runs the transition within the program's terms.","operationId":"createTransfer","requestBody":{"content":{"application/json":{"example":{"cluster":"SYN-CL-7F3A","facility":"SYN-FC-5D20","trigger":"payment_default"},"schema":{"description":"Transfer","properties":{"cluster":{"description":"Cluster","example":"SYN-CL-7F3A","format":"synpute-id:CL","type":"string"},"facility":{"description":"Facility","example":"SYN-FC-5D20","format":"synpute-id:FC","type":"string"},"trigger":{"description":"Trigger","enum":["payment_default","buyer_insolvency","covenant_breach","operator_default"],"example":"payment_default","type":"string"}},"required":["cluster","facility","trigger"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"candidates":[{"buyer":"SYN-BY-0C71","status":"accepted"}],"cluster":"SYN-CL-7F3A","facility":"SYN-FC-5D20","id":"trf_8Hc3","new_contract":"SYN-CT-9D10","object":"transfer","previous_contract":"SYN-CT-4B71","stage":"re_leased","timeline":[{"at":"2027-03-21","stage":"step_in"}],"trigger":"payment_default"},"schema":{"$ref":"#/components/schemas/Transfer"}}},"description":"The transfer"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"409":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflicts with the record's state"}},"security":[{"apiKey":["transfer:write"]}],"summary":"Start a transfer","tags":["Transfers"],"x-status":"planned"}},"/v1/transfers/{transfer_id}":{"get":{"description":"A transfer's stage, timeline and candidate buyers. The cluster keeps its Synpute ID throughout; the new contract links back to the old one.","operationId":"getTransfer","parameters":[{"description":"Transfer ID","example":"trf_8Hc3","in":"path","name":"transfer_id","required":true,"schema":{"description":"Transfer ID","example":"trf_8Hc3","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"candidates":[{"buyer":"SYN-BY-0C71","status":"accepted"}],"cluster":"SYN-CL-7F3A","facility":"SYN-FC-5D20","id":"trf_8Hc3","new_contract":"SYN-CT-9D10","object":"transfer","previous_contract":"SYN-CT-4B71","stage":"re_leased","timeline":[{"at":"2027-03-21","stage":"step_in"}],"trigger":"payment_default"},"schema":{"$ref":"#/components/schemas/Transfer"}}},"description":"The transfer"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["transfer:read"]}],"summary":"Retrieve a transfer","tags":["Transfers"],"x-status":"planned"}},"/v1/grants":{"post":{"description":"Share a record with another party. Only the record's owner can grant; every read under a grant is logged on the record.","operationId":"createGrant","requestBody":{"content":{"application/json":{"example":{"expires_at":null,"grantee":"SYN-LN-8C31","resource":"SYN-CL-7F3A","scopes":["monitor:read"]},"schema":{"description":"Grant","properties":{"expires_at":{"description":"When access ends; omit for until revoked","example":null,"format":"date-time","type":["string","null"]},"grantee":{"description":"Who to share with","example":"SYN-LN-8C31","format":"synpute-id:LN|PL|BY","type":"string"},"resource":{"description":"What to share","example":"SYN-CL-7F3A","format":"synpute-id:CL|CT|FC|OP","type":"string"},"scopes":{"description":"What they can read","items":{"description":"Scope","enum":["registry:read","verify:read","monitor:read","credit_profile:read"],"example":"monitor:read","type":"string"},"type":"array"}},"required":["expires_at","grantee","resource","scopes"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"created":"2026-10-02T14:30:00Z","expires_at":null,"grantee":"SYN-LN-8C31","id":"grt_5Vk2","object":"grant","resource":"SYN-CL-7F3A","scopes":["monitor:read"],"status":"active"},"schema":{"$ref":"#/components/schemas/Grant"}}},"description":"The grant"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["grants:write"]}],"summary":"Create a grant","tags":["Grants"],"x-status":"preview"},"get":{"description":"Grants you've given or received.","operationId":"listGrants","parameters":[{"description":"Given or received","example":"given","in":"query","name":"direction","schema":{"description":"Direction","enum":["given","received"],"example":"given","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"created":"2026-10-02T14:30:00Z","expires_at":null,"grantee":"SYN-LN-8C31","id":"grt_5Vk2","object":"grant","resource":"SYN-CL-7F3A","scopes":["monitor:read"],"status":"active"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Grants","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Grant"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of grants"}},"security":[{"apiKey":["grants:read"]}],"summary":"List grants","tags":["Grants"],"x-status":"preview"}},"/v1/grants/{grant_id}":{"delete":{"description":"End a grant immediately.","operationId":"revokeGrant","parameters":[{"description":"Grant ID","example":"grt_5Vk2","in":"path","name":"grant_id","required":true,"schema":{"description":"Grant ID","example":"grt_5Vk2","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"created":"2026-10-02T14:30:00Z","expires_at":null,"grantee":"SYN-LN-8C31","id":"grt_5Vk2","object":"grant","resource":"SYN-CL-7F3A","scopes":["monitor:read"],"status":"active"},"schema":{"$ref":"#/components/schemas/Grant"}}},"description":"The revoked grant"},"403":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not shared with you"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["grants:write"]}],"summary":"Revoke a grant","tags":["Grants"],"x-status":"preview"}},"/v1/price-reference/marks":{"get":{"description":"Reference marks for GPU capacity by model, term and region, drawn from verified contracts under a published methodology. Not yet published: values return null until they are.","operationId":"listMarks","parameters":[{"description":"GPU model","example":"H100","in":"query","name":"gpu","required":true,"schema":{"description":"GPU","enum":["H100","H200","B200","B300","GB200","A100"],"example":"H100","type":"string"}},{"description":"Contract term bucket","example":"36m","in":"query","name":"term","schema":{"description":"Term","enum":["spot","12m","36m","60m"],"example":"36m","type":"string"}},{"description":"Region","example":"us","in":"query","name":"region","schema":{"description":"Region","enum":["us","eu","apac"],"example":"us","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"as_of":"2027-03-31","gpu":"H100","inputs":0,"mark":0,"methodology":"pr/v0.1","object":"mark","region":"us","term":"36m","unit":"usd_per_gpu_hour"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Marks","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Mark"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"Marks"}},"security":[{"apiKey":["data:read"]}],"summary":"List reference marks","tags":["Price Reference"],"x-status":"planned"}},"/v1/loss-index/metrics":{"get":{"description":"Default, recovery and time-to-re-lease by financing vintage. Publishes once the registry holds enough history; values return null until then.","operationId":"listLossMetrics","parameters":[{"description":"Financing vintage","example":"2026","in":"query","name":"cohort","schema":{"description":"Vintage","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"cohort":"2026","default_rate_pct":0,"facilities":0,"object":"loss_metric","recovery_rate_pct":0,"time_to_re_lease_days":0}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Loss metrics","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/LossMetric"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"Metrics"}},"security":[{"apiKey":["data:read"]}],"summary":"List loss metrics","tags":["Loss Index"],"x-status":"planned"}},"/v1/ids/{synpute_id}":{"get":{"description":"Look up any Synpute ID: what it is and whether you can read it, without knowing its type in advance.","operationId":"resolveId","parameters":[{"description":"Any Synpute ID","example":"SYN-CL-7F3A","in":"path","name":"synpute_id","required":true,"schema":{"description":"Any Synpute ID","example":"SYN-CL-7F3A","format":"synpute-id:*","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"accessible":true,"id":"SYN-CL-7F3A","object":"cluster","url":"/v1/clusters/SYN-CL-7F3A"},"schema":{"description":"Resolution","properties":{"accessible":{"description":"You can read the full record","example":true,"type":"boolean"},"id":{"description":"The ID","example":"SYN-CL-7F3A","format":"synpute-id:*","type":"string"},"object":{"description":"Record type","enum":["entity","site","cluster","contract","facility"],"example":"cluster","type":"string"},"url":{"description":"Where to read it","example":"/v1/clusters/SYN-CL-7F3A","format":"uri-reference","type":"string"}},"required":["accessible","id","object","url"],"type":"object"}}},"description":"What the ID refers to"},"404":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"security":[{"apiKey":["registry:read"]}],"summary":"Resolve an ID","tags":["Events"],"x-status":"preview"}},"/v1/events":{"get":{"description":"Events on records you can see, newest first. The same events webhooks deliver; use it to backfill or reconcile.","operationId":"listEvents","parameters":[{"description":"Filter by event type","example":"alert.opened","in":"query","name":"type","schema":{"description":"Event type","type":"string"}},{"description":"Filter by Synpute ID","example":"SYN-CL-7F3A","in":"query","name":"resource","schema":{"description":"Synpute ID","type":"string"}},{"description":"Results per page, 1 to 100","example":20,"in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Cursor from the previous page's next_cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"created":"2026-10-02T14:30:00Z","data":{},"id":"evt_1Gh7","object":"event","resource":"SYN-CL-7F3A","type":"alert.opened"}],"has_more":false,"next_cursor":null,"object":"list"},"schema":{"description":"Events","properties":{"data":{"description":"Results, newest first","items":{"$ref":"#/components/schemas/Event"},"type":"array"},"has_more":{"description":"More results after this page","example":false,"type":"boolean"},"next_cursor":{"description":"Pass as `cursor` for the next page","example":null,"type":["string","null"]},"object":{"description":"Object type","enum":["list"],"example":"list","type":"string"}},"required":["data","has_more","next_cursor","object"],"type":"object"}}},"description":"A page of events"}},"security":[{"apiKey":["events:read"]}],"summary":"List events","tags":["Events"],"x-status":"preview"}},"/v1/webhook-endpoints":{"post":{"description":"Register an HTTPS endpoint for events. The signing secret is returned once; verify each delivery's Synpute-Signature header with it.","operationId":"createWebhookEndpoint","requestBody":{"content":{"application/json":{"example":{"events":["alert.opened"],"url":"https://example.com/hooks/synpute"},"schema":{"description":"Endpoint","properties":{"events":{"description":"Event types to send","items":{"description":"Event type","example":"alert.opened","type":"string"},"type":"array"},"url":{"description":"HTTPS URL","example":"https://example.com/hooks/synpute","format":"uri","type":"string"}},"required":["events","url"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"created":"2026-10-02T14:30:00Z","events":["alert.opened"],"id":"we_3Ks1","object":"webhook_endpoint","secret":"whsec_…","status":"enabled","url":"https://example.com/hooks/synpute"},"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}},"description":"The endpoint"},"400":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"No cluster with ID SYN-CL-0000.","param":null,"request_id":"req_7Hk2"}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"}},"security":[{"apiKey":["events:write"]}],"summary":"Create a webhook endpoint","tags":["Events"],"x-status":"preview"}}},"servers":[{"description":"Live","url":"https://api.synpute.com"},{"description":"Test: sample data, no real counterparties","url":"https://api.synpute.com/test"}],"tags":[{"description":"Operators, buyers, lenders and platforms.","name":"Entities"},{"description":"Where clusters run: lease and power.","name":"Sites"},{"description":"GPU clusters and their units, in the Synpute Standard.","name":"Clusters"},{"description":"Capacity sold to buyers, with step-in terms.","name":"Contracts"},{"description":"Loans secured by clusters and contracts.","name":"Facilities"},{"description":"Check counterparties and assets once; reuse the result.","name":"Verifications"},{"description":"Diligence on buyer, asset and contract, with risk indicators.","name":"Credit Profiles"},{"description":"Telemetry, payments, covenants, alerts and reports.","name":"Monitoring"},{"description":"Programs and lender-directed transitions.","name":"Transfers"},{"description":"Who can read what.","name":"Grants"},{"description":"Reference marks from verified contracts.","name":"Price Reference"},{"description":"Credit outcomes across the registry.","name":"Loss Index"},{"description":"IDs, events and webhooks.","name":"Events"}],"webhooks":{"verification.completed":{"post":{"description":"A verification finished; fetch it for per-check evidence.","operationId":"verificationCompleted","requestBody":{"content":{"application/json":{"example":{"created":"2026-11-21T10:12:00Z","data":{"checks":[{"completed_at":"2026-10-02T15:58:00Z","evidence":[{"kind":"registry_filing","reference":"DE SOS #7741265"}],"notes":null,"status":"verified","type":"kyb"}],"completed_at":"2026-10-02T16:00:00Z","created":"2026-10-02T14:30:00Z","id":"ver_9QmT2","object":"verification","requested_by":"SYN-LN-8C31","status":"completed","subject":"SYN-OP-21C9"},"id":"evt_1Gh7","object":"event","type":"verification.completed"},"schema":{"description":"Verification completed","properties":{"created":{"description":"When it happened","example":"2026-11-21T10:12:00Z","format":"date-time","type":"string"},"data":{"$ref":"#/components/schemas/Verification","description":"The object, at the time of the event"},"id":{"description":"Event ID","example":"evt_1Gh7","type":"string"},"object":{"description":"Object type","enum":["event"],"example":"event","type":"string"},"type":{"description":"Event type","enum":["verification.completed"],"example":"verification.completed","type":"string"}},"required":["created","data","id","object","type"],"type":"object"}}}},"responses":{"200":{"description":"Acknowledge with any 2xx"}},"summary":"Verification completed","tags":["Events"],"x-status":"preview"}},"credit_profile.ready":{"post":{"description":"A Credit Profile was delivered and shared with the requested lenders.","operationId":"creditProfileReady","requestBody":{"content":{"application/json":{"example":{"created":"2026-11-21T10:12:00Z","data":{"asset":{"cluster":"SYN-CL-7F3A","hardware_generation":"Blackwell","re_lease_depth":"deep"},"buyer":{"entity":"SYN-BY-0A9E","public_rating":null,"revenue_share_pct":41},"contract":{"contract":"SYN-CT-4B71","months_short_of_maturity":12,"step_in_rights":true},"created":"2026-10-02T14:30:00Z","id":"cp_6Nw1","indicators":[{"detail":"Contract ends 12 months before loan maturity","key":"term_mismatch","section":"contract","status":"flagged"}],"methodology":"cp/v0.1","object":"credit_profile","status":"ready"},"id":"evt_1Gh7","object":"event","type":"credit_profile.ready"},"schema":{"description":"Credit Profile ready","properties":{"created":{"description":"When it happened","example":"2026-11-21T10:12:00Z","format":"date-time","type":"string"},"data":{"$ref":"#/components/schemas/CreditProfile","description":"The object, at the time of the event"},"id":{"description":"Event ID","example":"evt_1Gh7","type":"string"},"object":{"description":"Object type","enum":["event"],"example":"event","type":"string"},"type":{"description":"Event type","enum":["credit_profile.ready"],"example":"credit_profile.ready","type":"string"}},"required":["created","data","id","object","type"],"type":"object"}}}},"responses":{"200":{"description":"Acknowledge with any 2xx"}},"summary":"Credit Profile ready","tags":["Events"],"x-status":"planned"}},"payment.late":{"post":{"description":"A contract payment passed its due date unpaid.","operationId":"paymentLate","requestBody":{"content":{"application/json":{"example":{"created":"2026-11-21T10:12:00Z","data":{"amount":{"amount":387000000,"currency":"USD"},"contract":"SYN-CT-4B71","due_on":"2026-10-31","id":"pay_4Rt8","object":"payment","paid_on":"2026-10-29","source":"bank_feed","status":"paid"},"id":"evt_1Gh7","object":"event","type":"payment.late"},"schema":{"description":"Payment late","properties":{"created":{"description":"When it happened","example":"2026-11-21T10:12:00Z","format":"date-time","type":"string"},"data":{"$ref":"#/components/schemas/Payment","description":"The object, at the time of the event"},"id":{"description":"Event ID","example":"evt_1Gh7","type":"string"},"object":{"description":"Object type","enum":["event"],"example":"event","type":"string"},"type":{"description":"Event type","enum":["payment.late"],"example":"payment.late","type":"string"}},"required":["created","data","id","object","type"],"type":"object"}}}},"responses":{"200":{"description":"Acknowledge with any 2xx"}},"summary":"Payment late","tags":["Events"],"x-status":"preview"}},"alert.opened":{"post":{"description":"A monitored condition was detected.","operationId":"alertOpened","requestBody":{"content":{"application/json":{"example":{"created":"2026-11-21T10:12:00Z","data":{"cluster":"SYN-CL-7F3A","covenant":"cov_1Bx5","facility":"SYN-FC-5D20","id":"alr_3Pz8","object":"alert","opened_at":"2026-08-14T09:00:00Z","resolved_at":"2026-08-20T11:00:00Z","severity":"warning","status":"resolved","type":"payment_late"},"id":"evt_1Gh7","object":"event","type":"alert.opened"},"schema":{"description":"Alert opened","properties":{"created":{"description":"When it happened","example":"2026-11-21T10:12:00Z","format":"date-time","type":"string"},"data":{"$ref":"#/components/schemas/Alert","description":"The object, at the time of the event"},"id":{"description":"Event ID","example":"evt_1Gh7","type":"string"},"object":{"description":"Object type","enum":["event"],"example":"event","type":"string"},"type":{"description":"Event type","enum":["alert.opened"],"example":"alert.opened","type":"string"}},"required":["created","data","id","object","type"],"type":"object"}}}},"responses":{"200":{"description":"Acknowledge with any 2xx"}},"summary":"Alert opened","tags":["Events"],"x-status":"preview"}},"covenant.breached":{"post":{"description":"A facility covenant crossed its threshold.","operationId":"covenantBreached","requestBody":{"content":{"application/json":{"example":{"created":"2026-11-21T10:12:00Z","data":{"facility":"SYN-FC-5D20","id":"cov_1Bx5","metric":"uptime_pct","object":"covenant","status":"in_compliance","threshold":{"operator":"lt","value":99.5,"window":"month"}},"id":"evt_1Gh7","object":"event","type":"covenant.breached"},"schema":{"description":"Covenant breached","properties":{"created":{"description":"When it happened","example":"2026-11-21T10:12:00Z","format":"date-time","type":"string"},"data":{"$ref":"#/components/schemas/Covenant","description":"The object, at the time of the event"},"id":{"description":"Event ID","example":"evt_1Gh7","type":"string"},"object":{"description":"Object type","enum":["event"],"example":"event","type":"string"},"type":{"description":"Event type","enum":["covenant.breached"],"example":"covenant.breached","type":"string"}},"required":["created","data","id","object","type"],"type":"object"}}}},"responses":{"200":{"description":"Acknowledge with any 2xx"}},"summary":"Covenant breached","tags":["Events"],"x-status":"preview"}},"transfer.stage_changed":{"post":{"description":"A transfer moved to a new stage.","operationId":"transferStageChanged","requestBody":{"content":{"application/json":{"example":{"created":"2026-11-21T10:12:00Z","data":{"candidates":[{"buyer":"SYN-BY-0C71","status":"accepted"}],"cluster":"SYN-CL-7F3A","facility":"SYN-FC-5D20","id":"trf_8Hc3","new_contract":"SYN-CT-9D10","object":"transfer","previous_contract":"SYN-CT-4B71","stage":"re_leased","timeline":[{"at":"2027-03-21","stage":"step_in"}],"trigger":"payment_default"},"id":"evt_1Gh7","object":"event","type":"transfer.stage_changed"},"schema":{"description":"Transfer stage changed","properties":{"created":{"description":"When it happened","example":"2026-11-21T10:12:00Z","format":"date-time","type":"string"},"data":{"$ref":"#/components/schemas/Transfer","description":"The object, at the time of the event"},"id":{"description":"Event ID","example":"evt_1Gh7","type":"string"},"object":{"description":"Object type","enum":["event"],"example":"event","type":"string"},"type":{"description":"Event type","enum":["transfer.stage_changed"],"example":"transfer.stage_changed","type":"string"}},"required":["created","data","id","object","type"],"type":"object"}}}},"responses":{"200":{"description":"Acknowledge with any 2xx"}},"summary":"Transfer stage changed","tags":["Events"],"x-status":"planned"}},"grant.created":{"post":{"description":"A record was shared with you.","operationId":"grantCreated","requestBody":{"content":{"application/json":{"example":{"created":"2026-11-21T10:12:00Z","data":{"created":"2026-10-02T14:30:00Z","expires_at":null,"grantee":"SYN-LN-8C31","id":"grt_5Vk2","object":"grant","resource":"SYN-CL-7F3A","scopes":["monitor:read"],"status":"active"},"id":"evt_1Gh7","object":"event","type":"grant.created"},"schema":{"description":"Grant created","properties":{"created":{"description":"When it happened","example":"2026-11-21T10:12:00Z","format":"date-time","type":"string"},"data":{"$ref":"#/components/schemas/Grant","description":"The object, at the time of the event"},"id":{"description":"Event ID","example":"evt_1Gh7","type":"string"},"object":{"description":"Object type","enum":["event"],"example":"event","type":"string"},"type":{"description":"Event type","enum":["grant.created"],"example":"grant.created","type":"string"}},"required":["created","data","id","object","type"],"type":"object"}}}},"responses":{"200":{"description":"Acknowledge with any 2xx"}},"summary":"Grant created","tags":["Events"],"x-status":"preview"}}},"x-tagGroups":[{"name":"Registry","tags":["Entities","Sites","Clusters","Contracts","Facilities"]},{"name":"Products","tags":["Verifications","Credit Profiles","Monitoring","Transfers"]},{"name":"Data","tags":["Price Reference","Loss Index"]},{"name":"Platform","tags":["Grants","Events"]}]}