{"openapi":"3.1.0","info":{"title":"TaaS.solutions Procurement Evidence API","version":"1.2.0","description":"Tokenization provider discovery, deterministic research-candidate matching, provider retrieval, category-valid comparison, and stateless procurement-brief drafting. Public provider claims are indexed from disclosed sources; independently validate regulated permissions, jurisdictional coverage, technical fit, and contractual responsibility before procurement.","termsOfService":"https://taas.solutions/terms","contact":{"name":"TaaS.solutions","url":"https://taas.solutions/agents"},"license":{"name":"Public API terms","identifier":"LicenseRef-TaaS-Public-API"}},"servers":[{"url":"https://taas.solutions","description":"Current TaaS.solutions origin"}],"tags":[{"name":"Providers","description":"Source-linked provider discovery and comparison."},{"name":"Procurement","description":"Stateless requirements and RFI/RFP drafting with mandatory human review."}],"paths":{"/api/v1/providers":{"get":{"tags":["Providers"],"operationId":"searchProviders","summary":"Search normalized provider profiles","parameters":[{"name":"q","in":"query","required":false,"description":"Keyword across provider names, descriptions, layers, assets, and services.","schema":{"type":"string","maxLength":240},"example":"custody"},{"name":"asset","in":"query","required":false,"description":"Exact asset label.","schema":{"type":"string","maxLength":240},"example":"Debt"},{"name":"service","in":"query","required":false,"description":"Exact service label.","schema":{"type":"string","maxLength":240},"example":"Issuance"},{"name":"layer","in":"query","required":false,"description":"Exact accountable provider layer.","schema":{"type":"string","maxLength":240},"example":"Issuance & lifecycle"}],"responses":{"200":{"description":"A normalized provider search result.","headers":{"Cache-Control":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderSearchResult"}}}}}}},"/api/v1/providers/{id}":{"get":{"tags":["Providers"],"operationId":"getProviderProfile","summary":"Retrieve one source-indexed provider profile","parameters":[{"name":"id","in":"path","required":true,"description":"Stable provider ID returned by provider discovery or matching.","schema":{"type":"string","minLength":2,"maxLength":80},"example":"securitize"}],"responses":{"200":{"description":"One normalized provider evidence profile.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderProfileResult"}}}},"404":{"description":"No public profile exists for the supplied ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/match":{"get":{"tags":["Providers"],"operationId":"matchProviders","summary":"Generate deterministic provider research candidates","description":"Returns alphabetically ordered research candidates only when feasibility, jurisdiction, and investor-segment gates permit named-provider research. Results are not recommendations or eligibility findings.","parameters":[{"name":"asset","in":"query","required":true,"description":"Economic asset being considered for tokenization.","schema":{"type":"string","enum":["Funds","Private credit","Real estate","Equity","Debt","Stablecoins"]},"example":"Private credit"},{"name":"jurisdiction","in":"query","required":true,"description":"Primary issuer and first investor market.","schema":{"type":"string","enum":["United States","European Union","United Kingdom","Middle East","Asia-Pacific","Multiple / undecided"]},"example":"United States"},{"name":"investor","in":"query","required":true,"description":"First intended holder or investor segment.","schema":{"type":"string","enum":["Institutional","Accredited / professional","Retail","Internal / closed network","Undecided"]},"example":"Accredited / professional"},{"name":"stage","in":"query","required":true,"description":"Current maturity of the project.","schema":{"type":"string","enum":["Exploring feasibility","Structure defined","Selecting providers","Ready to issue"]},"example":"Selecting providers"}],"responses":{"200":{"description":"A deterministic match result, which may explicitly withhold candidates.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderMatchResult"}}}},"400":{"description":"One or more project parameters are missing or unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/compare":{"get":{"tags":["Providers"],"operationId":"compareProviders","summary":"Compare providers with a shared accountable layer","parameters":[{"name":"ids","in":"query","required":true,"description":"Two or three unique, comma-separated provider IDs.","schema":{"type":"string","minLength":3,"maxLength":240},"example":"securitize,tokeny"}],"responses":{"200":{"description":"A category-valid provider comparison.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderComparison"}}}},"400":{"description":"Fewer than two valid provider IDs were supplied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"The providers do not share an accountable layer and are not valid substitutes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/rfp-draft":{"post":{"tags":["Procurement"],"operationId":"draftProcurementBrief","summary":"Draft a normalized tokenization RFI/RFP packet","description":"A stateless, deterministic drafting operation. It stores no project data, contacts no provider, and does not make a legal, investment, eligibility, or provider-selection decision.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcurementBriefInput"}}}},"responses":{"200":{"description":"A common procurement packet, which may contain blocking requirements.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcurementBriefDraft"}}}},"400":{"description":"One or more project fields or provider IDs are unsupported or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"schemas":{"EvidenceItem":{"type":"object","required":["claim","sourceTitle","sourceType","url","origin","checkedAt","confidence"],"properties":{"claim":{"type":"string"},"sourceTitle":{"type":"string"},"sourceType":{"type":"string","enum":["official-product-page","official-documentation","official-case-study","official-company-disclosure"]},"url":{"type":"string","format":"uri"},"origin":{"type":"string","enum":["public-source","provider-submitted"]},"checkedAt":{"type":"string","format":"date"},"confidence":{"type":"string","enum":["documented","needs-validation"]}}},"Provider":{"type":"object","required":["id","name","summary","bestFor","assets","services","primaryLayer","layers","regions","delivery","source","evidenceStatus","reviewedAt","commercialRelationship","evidence"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"summary":{"type":"string"},"bestFor":{"type":"string"},"assets":{"type":"array","items":{"type":"string"}},"services":{"type":"array","items":{"type":"string"}},"primaryLayer":{"type":"string"},"layers":{"type":"array","items":{"type":"string"}},"regions":{"type":"string"},"delivery":{"type":"string"},"source":{"type":"string","format":"uri"},"evidenceStatus":{"type":"string"},"reviewedAt":{"type":"string","format":"date"},"commercialRelationship":{"type":"string","enum":["none-disclosed"]},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/EvidenceItem"}}}},"ProviderSearchResult":{"type":"object","required":["schema_version","object","count","data","policy"],"properties":{"schema_version":{"type":"string"},"object":{"const":"provider.search_result"},"filters":{"type":"object","additionalProperties":{"type":["string","null"]}},"count":{"type":"integer","minimum":0},"data":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}},"policy":{"type":"object","additionalProperties":{"type":"string"}}}},"ProviderProfileResult":{"type":"object","required":["schema_version","object","data","evidence_policy","human_review_required"],"properties":{"schema_version":{"type":"string"},"object":{"const":"provider.profile"},"data":{"$ref":"#/components/schemas/Provider"},"evidence_policy":{"type":"object","required":["status","independently_verified","meaning"],"properties":{"status":{"const":"source-indexed"},"independently_verified":{"const":false},"meaning":{"type":"string"}}},"human_review_required":{"const":true}}},"ProviderResearchCandidate":{"type":"object","required":["provider","match_signals","unresolved","evidence"],"properties":{"provider":{"$ref":"#/components/schemas/Provider"},"match_signals":{"type":"array","items":{"type":"string"}},"unresolved":{"type":"array","items":{"type":"string"}},"evidence":{"type":"object","required":["status","independently_verified","source_count","last_reviewed_at"],"properties":{"status":{"const":"source-indexed"},"independently_verified":{"const":false},"source_count":{"type":"integer","minimum":1},"last_reviewed_at":{"type":"string","format":"date"}}}}},"ProviderMatchResult":{"type":"object","required":["schema_version","object","status","input","orientation","withheld_reasons","candidates","comparison_set","policy"],"properties":{"schema_version":{"type":"string"},"object":{"const":"provider.match_result"},"status":{"type":"string","enum":["matching-withheld","research-candidates-available","no-indexed-candidates"]},"input":{"type":"object","required":["asset","jurisdiction","investor","stage"],"properties":{"asset":{"type":"string","enum":["Funds","Private credit","Real estate","Equity","Debt","Stablecoins"]},"jurisdiction":{"type":"string","enum":["United States","European Union","United Kingdom","Middle East","Asia-Pacific","Multiple / undecided"]},"investor":{"type":"string","enum":["Institutional","Accredited / professional","Retail","Internal / closed network","Undecided"]},"stage":{"type":"string","enum":["Exploring feasibility","Structure defined","Selecting providers","Ready to issue"]}}},"orientation":{"type":"object","required":["hard_gates","accountable_role_stack","evidence_to_collect","next_deliverable","next_step"],"properties":{"hard_gates":{"type":"array","minItems":3,"items":{"type":"string"}},"accountable_role_stack":{"type":"array","minItems":4,"items":{"type":"string"}},"evidence_to_collect":{"type":"array","minItems":4,"items":{"type":"string"}},"next_deliverable":{"type":"string"},"next_step":{"type":"string"}}},"withheld_reasons":{"type":"array","items":{"type":"string"}},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/ProviderResearchCandidate"}},"comparison_set":{"anyOf":[{"type":"null"},{"type":"object","required":["shared_layer","provider_ids"],"properties":{"shared_layer":{"type":"string"},"provider_ids":{"type":"array","minItems":2,"maxItems":3,"items":{"type":"string"}}}}]},"policy":{"type":"object","additionalProperties":{"type":["string","boolean"]}}}},"ProviderComparison":{"type":"object","required":["schema_version","object","compared_ids","shared_layers","dimensions","data","limitations"],"properties":{"schema_version":{"type":"string"},"object":{"const":"provider.comparison"},"compared_ids":{"type":"array","minItems":2,"maxItems":3,"items":{"type":"string"}},"shared_layers":{"type":"array","minItems":1,"items":{"type":"string"}},"dimensions":{"type":"array","items":{"type":"string"}},"data":{"type":"array","minItems":2,"maxItems":3,"items":{"$ref":"#/components/schemas/Provider"}},"limitations":{"type":"array","items":{"type":"string"}}}},"ProcurementBriefInput":{"type":"object","required":["asset","jurisdiction","investor","stage","objective","decision_owner","decision_timeline","budget_range","required_integrations","provider_ids"],"properties":{"asset":{"type":"string","enum":["Funds","Private credit","Real estate","Equity","Debt","Stablecoins"]},"jurisdiction":{"type":"string","enum":["United States","European Union","United Kingdom","Middle East","Asia-Pacific","Multiple / undecided"]},"investor":{"type":"string","enum":["Institutional","Accredited / professional","Retail","Internal / closed network","Undecided"]},"stage":{"type":"string","enum":["Exploring feasibility","Structure defined","Selecting providers","Ready to issue"]},"objective":{"type":"string","minLength":20,"maxLength":800},"decision_owner":{"type":"string","minLength":2,"maxLength":120},"decision_timeline":{"type":"string","enum":["Within 3 months","3–6 months","6–12 months","More than 12 months","Not set"]},"budget_range":{"type":"string","enum":["Under $50,000","$50,000–$150,000","$150,000–$500,000","Above $500,000","Not set"]},"required_integrations":{"type":"array","uniqueItems":true,"maxItems":9,"items":{"type":"string","enum":["Identity / KYC / KYB","Custody / wallet infrastructure","Banking / payments","Transfer agent / register","Fund administration","Investor portal / CRM","ERP / accounting","Blockchain / settlement network","Reporting / data warehouse"]}},"provider_ids":{"description":"Use an empty array for deterministic candidate research, or two to three public provider IDs that share an accountable layer and indexed asset claim.","oneOf":[{"type":"array","maxItems":0},{"type":"array","minItems":2,"maxItems":3,"uniqueItems":true,"items":{"type":"string","maxLength":80}}]}}},"ProcurementBriefDraft":{"type":"object","required":["schema_version","object","status","input","gates","accountable_role_stack","shortlist","response_template","evaluation","next_action","policy"],"properties":{"schema_version":{"type":"string"},"object":{"const":"procurement.brief_draft"},"status":{"type":"string","enum":["requirements-incomplete","ready-for-human-rfp-review"]},"input":{"$ref":"#/components/schemas/ProcurementBriefInput"},"gates":{"type":"object","required":["blocking","mandatory"],"properties":{"blocking":{"type":"array","items":{"type":"string"}},"mandatory":{"type":"array","minItems":3,"items":{"type":"string"}}}},"accountable_role_stack":{"type":"array","minItems":4,"items":{"type":"string"}},"shortlist":{"type":"object","required":["source","shared_layer","providers"],"properties":{"source":{"type":"string","enum":["buyer-selected","deterministic-research-set","single-indexed-candidate","withheld"]},"shared_layer":{"type":["string","null"]},"providers":{"type":"array","maxItems":3,"items":{"type":"object","required":["id","name","primary_layer","evidence_status","independently_verified","source_count","last_reviewed_at"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"primary_layer":{"type":"string"},"evidence_status":{"const":"source-indexed"},"independently_verified":{"const":false},"source_count":{"type":"integer","minimum":1},"last_reviewed_at":{"type":"string","format":"date"}}}}}},"response_template":{"type":"object","required":["mandatory_requirements","evidence_requests","integration_requirements","pricing_fields","implementation_fields"],"properties":{"mandatory_requirements":{"type":"array","items":{"type":"string"}},"evidence_requests":{"type":"array","items":{"type":"string"}},"integration_requirements":{"type":"array","items":{"type":"string"}},"pricing_fields":{"type":"array","items":{"type":"string"}},"implementation_fields":{"type":"array","items":{"type":"string"}}}},"evaluation":{"type":"object","required":["order","hard_gate_rule","weighted_criteria"],"properties":{"order":{"type":"array","items":{"type":"string"}},"hard_gate_rule":{"type":"string"},"weighted_criteria":{"type":"array","items":{"type":"object","required":["name","weight","instruction"],"properties":{"name":{"type":"string"},"weight":{"type":"integer"},"instruction":{"type":"string"}}}}}},"next_action":{"type":"string"},"policy":{"type":"object","required":["distribution","recommendation","evidence","compensation","human_review_required"],"properties":{"distribution":{"type":"string"},"recommendation":{"type":"string"},"evidence":{"type":"string"},"compensation":{"type":"string"},"human_review_required":{"const":true}}}}},"ApiError":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}},"externalDocs":{"description":"Evidence methodology and human-review boundaries","url":"https://taas.solutions/methodology"},"x-human-review-required":true,"x-ranking-policy":"No payment or commercial relationship affects ordering or inclusion."}