{"openapi":"3.0.3","info":{"title":"Strata Public API","version":"1.0.0-draft","description":"Developer-first federal opportunities API with SAM + DIBBS, documents, history, and provenance."},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Customer-scoped Strata API key. `Authorization: Bearer <key>` is also accepted."}},"schemas":{}},"paths":{"/documents/search":{"get":{"operationId":"searchDocuments","summary":"Search opportunity document text","tags":["public","documents","opportunities"],"description":"Searches extracted opportunity attachment text and returns document-level evidence snippets. Private storage URIs are not exposed.","parameters":[{"schema":{"minLength":2,"maxLength":200,"type":"string"},"in":"query","name":"q","required":true,"description":"Keyword query. All terms must match the document chunk."},{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"anyOf":[{"type":"string","enum":["sam_current"]},{"type":"string","enum":["sam_archive"]},{"type":"string","enum":["dibbs"]}]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"record_id","required":false},{"schema":{"type":"string"},"in":"query","name":"thread_key","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["document","opportunity","match"],"properties":{"document":{"type":"object","required":["documentId","fileName","label","kind","sourceUrl","textHash"],"properties":{"documentId":{"type":"string"},"fileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"textHash":{"type":"string"}}},"opportunity":{"type":"object","required":["recordId","threadKey","noticeId","title","agencyName","postedAt","closeAt"],"properties":{"recordId":{"type":"string"},"threadKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"postedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"closeAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}}},"match":{"type":"object","required":["score","chunkId","chunkIndex","snippet","matchedTerms","charStart","charEnd"],"properties":{"score":{"type":"number"},"chunkId":{"type":"string"},"chunkIndex":{"type":"number"},"snippet":{"type":"string"},"matchedTerms":{"type":"array","items":{"type":"string"}},"charStart":{"type":"number"},"charEnd":{"type":"number"}}}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities":{"get":{"operationId":"listOpportunities","summary":"List opportunities","tags":["public","opportunities"],"description":"Returns canonical thread-level opportunity list items.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"anyOf":[{"type":"string","enum":["sam_current"]},{"type":"string","enum":["sam_archive"]},{"type":"string","enum":["dibbs"]}]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"minLength":2,"maxLength":200,"type":"string"},"in":"query","name":"document_query","required":false,"description":"Filters opportunities by extracted attachment text and includes compact documentMatches evidence."},{"schema":{"format":"date-time","type":"string"},"in":"query","name":"updated_since","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","threadKey","thread","summary","documents"],"properties":{"recordId":{"format":"uuid","type":"string"},"threadKey":{"type":"string"},"thread":{"type":"object","required":["latestNoticeId","latestNoticeRecordId","noticeCount"],"properties":{"latestNoticeId":{"type":"string"},"latestNoticeRecordId":{"format":"uuid","type":"string"},"noticeCount":{"type":"number"}}},"summary":{"type":"object","required":["sourceName","sourceFamily","noticeId","solicitationNumber","title","agencyName","postedAt","closeAt","opportunityStatus","category","pscCode","noticeType","active","archiveDate","setAsideLabel","buyerName","naicsCodes","officePathSegments","placeOfPerformance","descriptionPreview","relatedRecordCount"],"properties":{"sourceName":{"type":"string"},"sourceFamily":{"type":"string"},"noticeId":{"type":"string"},"solicitationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"agencyName":{"type":"string"},"postedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"closeAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"opportunityStatus":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"archiveDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyerName":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCodes":{"type":"array","items":{"type":"string"}},"officePathSegments":{"type":"array","items":{"type":"string"}},"placeOfPerformance":{"anyOf":[{"type":"string"},{"type":"null"}]},"descriptionPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"relatedRecordCount":{"type":"number"}}},"documents":{"type":"object","required":["hasPackagePage","hasPdf","hasExtractedText","hasTechnicalDocuments","attachmentCount"],"properties":{"hasPackagePage":{"type":"boolean"},"hasPdf":{"type":"boolean"},"hasExtractedText":{"type":"boolean"},"hasTechnicalDocuments":{"type":"boolean"},"attachmentCount":{"type":"number"}}},"documentMatches":{"type":"array","items":{"type":"object","required":["document","match"],"properties":{"document":{"type":"object","required":["documentId","fileName","label","kind","sourceUrl","textHash"],"properties":{"documentId":{"type":"string"},"fileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"textHash":{"type":"string"}}},"match":{"type":"object","required":["score","chunkId","chunkIndex","snippet","matchedTerms","charStart","charEnd"],"properties":{"score":{"type":"number"},"chunkId":{"type":"string"},"chunkIndex":{"type":"number"},"snippet":{"type":"string"},"matchedTerms":{"type":"array","items":{"type":"string"}},"charStart":{"type":"number"},"charEnd":{"type":"number"}}}}}}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities/analysis/rollups":{"get":{"operationId":"getOpportunityAnalysisRollups","summary":"Get opportunity analysis rollups","tags":["public","analysis"],"description":"Returns aggregate rollups for filtered opportunity threads.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"anyOf":[{"type":"string","enum":["sam_current"]},{"type":"string","enum":["sam_archive"]},{"type":"string","enum":["dibbs"]}]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"sourceFamily","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"category","required":false},{"schema":{"type":"string"},"in":"query","name":"setAside","required":false},{"schema":{"type":"string"},"in":"query","name":"contractType","required":false},{"schema":{"type":"string"},"in":"query","name":"deliveryRegion","required":false},{"schema":{"type":"string"},"in":"query","name":"naics","required":false},{"schema":{"type":"string"},"in":"query","name":"office","required":false},{"schema":{"type":"string"},"in":"query","name":"hasDescriptionText","required":false},{"schema":{"type":"string"},"in":"query","name":"hasAward","required":false},{"schema":{"type":"string"},"in":"query","name":"hasPdf","required":false},{"schema":{"type":"string"},"in":"query","name":"hasExtractedText","required":false},{"schema":{"type":"string"},"in":"query","name":"hasTechnicalDocuments","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["totalCount","dimensions","features","metrics"],"properties":{"totalCount":{"type":"number"},"dimensions":{"type":"object","required":["sourceFamily","opportunityStatus","category","setAsideLabel","contractTypeLabel","deliveryRegionText","naicsCodes","officePathSegments"],"properties":{"sourceFamily":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}},"opportunityStatus":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}},"category":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}},"setAsideLabel":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}},"contractTypeLabel":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}},"deliveryRegionText":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}},"naicsCodes":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}},"officePathSegments":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}}}},"features":{"type":"object","required":["withDescriptionTextCount","withAwardCount","withPackagePageCount","withPdfCount","withExtractedTextCount","withTechnicalDocumentsCount","withDocumentConflictCount","withBuyerContactCount","withDeliveryTermsCount","withDeliveryRegionCount"],"properties":{"withDescriptionTextCount":{"type":"number"},"withAwardCount":{"type":"number"},"withPackagePageCount":{"type":"number"},"withPdfCount":{"type":"number"},"withExtractedTextCount":{"type":"number"},"withTechnicalDocumentsCount":{"type":"number"},"withDocumentConflictCount":{"type":"number"},"withBuyerContactCount":{"type":"number"},"withDeliveryTermsCount":{"type":"number"},"withDeliveryRegionCount":{"type":"number"}}},"metrics":{"type":"object","required":["relatedRecordCountTotal","eventCountTotal","snapshotCountTotal","contactCountTotal","descriptionTextLengthTotal","resourceLinkCountTotal","packageItemCountTotal","lineItemCountTotal","clauseCountTotal","sectionCountTotal","extractedTextLengthTotal","quantityTotal","estimatedAnnualQuantityTotal","guaranteedMinimumQuantityTotal","amountFloorTotal","amountCeilingTotal","contractMaximumValueTotal","parserConfidenceAverage"],"properties":{"relatedRecordCountTotal":{"type":"number"},"eventCountTotal":{"type":"number"},"snapshotCountTotal":{"type":"number"},"contactCountTotal":{"type":"number"},"descriptionTextLengthTotal":{"type":"number"},"resourceLinkCountTotal":{"type":"number"},"packageItemCountTotal":{"type":"number"},"lineItemCountTotal":{"type":"number"},"clauseCountTotal":{"type":"number"},"sectionCountTotal":{"type":"number"},"extractedTextLengthTotal":{"type":"number"},"quantityTotal":{"type":"number"},"estimatedAnnualQuantityTotal":{"type":"number"},"guaranteedMinimumQuantityTotal":{"type":"number"},"amountFloorTotal":{"type":"number"},"amountCeilingTotal":{"type":"number"},"contractMaximumValueTotal":{"type":"number"},"parserConfidenceAverage":{"anyOf":[{"type":"number"},{"type":"null"}]}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities/analysis":{"get":{"operationId":"listOpportunityAnalysis","summary":"List opportunity analysis items","tags":["public","analysis"],"description":"Returns analysis items for filtered opportunity threads.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"anyOf":[{"type":"string","enum":["sam_current"]},{"type":"string","enum":["sam_archive"]},{"type":"string","enum":["dibbs"]}]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"sourceFamily","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"category","required":false},{"schema":{"type":"string"},"in":"query","name":"setAside","required":false},{"schema":{"type":"string"},"in":"query","name":"contractType","required":false},{"schema":{"type":"string"},"in":"query","name":"deliveryRegion","required":false},{"schema":{"type":"string"},"in":"query","name":"naics","required":false},{"schema":{"type":"string"},"in":"query","name":"office","required":false},{"schema":{"type":"string"},"in":"query","name":"hasDescriptionText","required":false},{"schema":{"type":"string"},"in":"query","name":"hasAward","required":false},{"schema":{"type":"string"},"in":"query","name":"hasPdf","required":false},{"schema":{"type":"string"},"in":"query","name":"hasExtractedText","required":false},{"schema":{"type":"string"},"in":"query","name":"hasTechnicalDocuments","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","threadKey","summary","analysis"],"properties":{"recordId":{"format":"uuid","type":"string"},"threadKey":{"type":"string"},"summary":{"type":"object","required":["sourceName","sourceFamily","noticeId","solicitationNumber","title","agencyName","postedAt","closeAt","opportunityStatus","category","pscCode","noticeType","active","archiveDate","amountFloor","amountCeiling","setAsideLabel","naicsCodes","officePathSegments","officeAddress","placeOfPerformance","descriptionText","primaryContact","secondaryContact","contacts","award"],"properties":{"sourceName":{"type":"string"},"sourceFamily":{"type":"string"},"noticeId":{"type":"string"},"solicitationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"agencyName":{"type":"string"},"postedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"closeAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"opportunityStatus":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"archiveDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"amountFloor":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountCeiling":{"anyOf":[{"type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCodes":{"type":"array","items":{"type":"string"}},"officePathSegments":{"type":"array","items":{"type":"string"}},"officeAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"placeOfPerformance":{"anyOf":[{"type":"string"},{"type":"null"}]},"descriptionText":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryContact":{"anyOf":[{"type":"object","required":["name","role","title","email","phone","fax"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"fax":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"secondaryContact":{"anyOf":[{"type":"object","required":["name","role","title","email","phone","fax"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"fax":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"contacts":{"type":"array","items":{"type":"object","required":["name","role","title","email","phone","fax"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"fax":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"award":{"anyOf":[{"type":"object","required":["date","number","amount","awardeeName","awardeeUei","awardeeCageCode","awardeeLocation"],"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"number":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardeeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardeeUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardeeCageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardeeLocation":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]}}},"analysis":{"type":"object","required":["dimensions","features"],"properties":{"dimensions":{"type":"object","required":["sourceName","sourceFamily","opportunityStatus","category","setAsideLabel","contractTypeLabel","deliveryRegionText","officePathSegments","naicsCodes"],"properties":{"sourceName":{"type":"string"},"sourceFamily":{"type":"string"},"opportunityStatus":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractTypeLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"deliveryRegionText":{"anyOf":[{"type":"string"},{"type":"null"}]},"officePathSegments":{"type":"array","items":{"type":"string"}},"naicsCodes":{"type":"array","items":{"type":"string"}}}},"features":{"type":"object","required":["relatedRecordCount","eventCount","snapshotCount","contactCount","hasDescriptionText","descriptionTextLength","hasAward","hasPackagePage","hasPdf","hasExtractedText","extractedTextLength","hasTechnicalDocuments","resourceLinkCount","packageItemCount","lineItemCount","clauseCount","sectionCount","parserConfidence","hasDocumentConflict","hasBuyerContact","hasDeliveryTerms","hasDeliveryRegion","quantity","estimatedAnnualQuantity","guaranteedMinimumQuantity","amountFloor","amountCeiling","contractMaximumValue"],"properties":{"relatedRecordCount":{"type":"number"},"eventCount":{"type":"number"},"snapshotCount":{"type":"number"},"contactCount":{"type":"number"},"hasDescriptionText":{"type":"boolean"},"descriptionTextLength":{"type":"number"},"hasAward":{"type":"boolean"},"hasPackagePage":{"type":"boolean"},"hasPdf":{"type":"boolean"},"hasExtractedText":{"type":"boolean"},"extractedTextLength":{"anyOf":[{"type":"number"},{"type":"null"}]},"hasTechnicalDocuments":{"type":"boolean"},"resourceLinkCount":{"type":"number"},"packageItemCount":{"type":"number"},"lineItemCount":{"type":"number"},"clauseCount":{"type":"number"},"sectionCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"parserConfidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"hasDocumentConflict":{"type":"boolean"},"hasBuyerContact":{"type":"boolean"},"hasDeliveryTerms":{"type":"boolean"},"hasDeliveryRegion":{"type":"boolean"},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedAnnualQuantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"guaranteedMinimumQuantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"amountFloor":{"anyOf":[{"type":"number"},{"type":"null"}]},"amountCeiling":{"anyOf":[{"type":"number"},{"type":"null"}]},"contractMaximumValue":{"anyOf":[{"type":"number"},{"type":"null"}]}}}}}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities/{recordId}/history":{"get":{"operationId":"getOpportunityHistory","summary":"Get opportunity history","tags":["public","opportunities"],"description":"Returns the history block for a canonical opportunity thread.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["updatedAt","relatedRecordCount","events","snapshots"],"properties":{"updatedAt":{"format":"date-time","type":"string"},"relatedRecordCount":{"type":"number"},"events":{"type":"array","items":{"type":"object","required":["eventId","recordId","eventClass","eventType","detectedAt","actionable","reasonSummary","noticeId","title"],"properties":{"eventId":{"format":"uuid","type":"string"},"recordId":{"format":"uuid","type":"string"},"eventClass":{"type":"string"},"eventType":{"type":"string"},"detectedAt":{"format":"date-time","type":"string"},"actionable":{"type":"boolean"},"reasonSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"snapshots":{"type":"array","items":{"type":"object","required":["snapshotId","captureId","observedAt","versionHash"],"properties":{"snapshotId":{"format":"uuid","type":"string"},"captureId":{"format":"uuid","type":"string"},"observedAt":{"format":"date-time","type":"string"},"versionHash":{"type":"string"}}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities/{recordId}/documents":{"get":{"operationId":"getOpportunityDocuments","summary":"Get opportunity documents","tags":["public","opportunities","documents"],"description":"Returns the documents block for a canonical opportunity thread.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["sourcePageUrl","packageViewUrl","packageAttachmentLabel","pdfUrl","pdfFileName","technicalDocumentsLabel","technicalDocumentsUrl","extractedTextStorageUri","extractedTextLength","extractedTextHash","attachments","resourceLinks","intelligence"],"properties":{"sourcePageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"packageViewUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"packageAttachmentLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"pdfUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"pdfFileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"technicalDocumentsLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"technicalDocumentsUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"extractedTextStorageUri":{"anyOf":[{"type":"string"},{"type":"null"}]},"extractedTextLength":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractedTextHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","required":["url","label","fileName","kind","source"],"properties":{"url":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"resourceLinks":{"type":"array","items":{"type":"string"}},"intelligence":{"type":"object","required":["parserName","parserConfidence","pageCount","buyerName","buyerEmail","buyerPhone","purchaseRequestNumber","quantity","returnByLabel","setAsideLabel","contractTypeLabel","contractMaximumValue","estimatedAnnualQuantity","guaranteedMinimumQuantity","nsn","deliveryRegionText","notFirmQuantity","setAsideConflict","sectionCount","packageItems","deliveryTerms","lineItems","clauses","sections","extractedTextPreview"],"properties":{"parserName":{"anyOf":[{"type":"string"},{"type":"null"}]},"parserConfidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"pageCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"buyerName":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyerEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyerPhone":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaseRequestNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"returnByLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractTypeLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractMaximumValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimatedAnnualQuantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"guaranteedMinimumQuantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"nsn":{"anyOf":[{"type":"string"},{"type":"null"}]},"deliveryRegionText":{"anyOf":[{"type":"string"},{"type":"null"}]},"notFirmQuantity":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"setAsideConflict":{"anyOf":[{"type":"string"},{"type":"null"}]},"sectionCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"packageItems":{"type":"array","items":{"type":"object","required":["lineNumber","title","purchaseRequestNumber","nsnOrPartNumber","quantity","technicalDocumentsLabel"],"properties":{"lineNumber":{"anyOf":[{"type":"number"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaseRequestNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"nsnOrPartNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"technicalDocumentsLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"deliveryTerms":{"anyOf":[{"type":"object","required":["deliverFob","inspectionPoint","acceptancePoint","specialMarkingCode"],"properties":{"deliverFob":{"anyOf":[{"type":"string"},{"type":"null"}]},"inspectionPoint":{"anyOf":[{"type":"string"},{"type":"null"}]},"acceptancePoint":{"anyOf":[{"type":"string"},{"type":"null"}]},"specialMarkingCode":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"lineItems":{"type":"array","items":{"type":"object","required":["clin","title","quantityVariance"],"properties":{"clin":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantityVariance":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"clauses":{"type":"array","items":{"type":"object","required":["reference","family","title"],"properties":{"reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"family":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"sections":{"type":"array","items":{"type":"object","required":["code","heading","title","preview","length"],"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}]},"heading":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview":{"anyOf":[{"type":"string"},{"type":"null"}]},"length":{"anyOf":[{"type":"number"},{"type":"null"}]}}}},"extractedTextPreview":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities/{recordId}/documents/search":{"get":{"operationId":"searchOpportunityDocuments","summary":"Search one opportunity's document text","tags":["public","opportunities","documents"],"description":"Searches extracted attachment text for one canonical opportunity and returns document-level evidence snippets. Private storage URIs are not exposed.","parameters":[{"schema":{"minLength":2,"maxLength":200,"type":"string"},"in":"query","name":"q","required":true,"description":"Keyword query. All terms must match the document chunk."},{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["document","opportunity","match"],"properties":{"document":{"type":"object","required":["documentId","fileName","label","kind","sourceUrl","textHash"],"properties":{"documentId":{"type":"string"},"fileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"textHash":{"type":"string"}}},"opportunity":{"type":"object","required":["recordId","threadKey","noticeId","title","agencyName","postedAt","closeAt"],"properties":{"recordId":{"type":"string"},"threadKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"postedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"closeAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}}},"match":{"type":"object","required":["score","chunkId","chunkIndex","snippet","matchedTerms","charStart","charEnd"],"properties":{"score":{"type":"number"},"chunkId":{"type":"string"},"chunkIndex":{"type":"number"},"snippet":{"type":"string"},"matchedTerms":{"type":"array","items":{"type":"string"}},"charStart":{"type":"number"},"charEnd":{"type":"number"}}}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities/{recordId}/documents/requirements":{"get":{"operationId":"listOpportunityDocumentRequirements","summary":"List extracted document requirements","tags":["public","opportunities","documents"],"description":"Returns first-pass deadline, evaluation, quantity, clause, certification, and delivery evidence extracted from one opportunity's searchable attachment text.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"anyOf":[{"type":"string","enum":["deadline"]},{"type":"string","enum":["evaluation"]},{"type":"string","enum":["quantity"]},{"type":"string","enum":["clause"]},{"type":"string","enum":["certification"]},{"type":"string","enum":["delivery"]}]},"in":"query","name":"kind","required":false},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["opportunityRecordId","kind","label","value","confidence","document","evidence"],"properties":{"opportunityRecordId":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["deadline"]},{"type":"string","enum":["evaluation"]},{"type":"string","enum":["quantity"]},{"type":"string","enum":["clause"]},{"type":"string","enum":["certification"]},{"type":"string","enum":["delivery"]}]},"label":{"type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"number"},"document":{"type":"object","required":["documentId","fileName","label","kind","sourceUrl","textHash"],"properties":{"documentId":{"type":"string"},"fileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"textHash":{"type":"string"}}},"evidence":{"type":"object","required":["chunkId","chunkIndex","snippet","matchedTerms","charStart","charEnd"],"properties":{"chunkId":{"type":"string"},"chunkIndex":{"type":"number"},"snippet":{"type":"string"},"matchedTerms":{"type":"array","items":{"type":"string"}},"charStart":{"type":"number"},"charEnd":{"type":"number"}}}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities/{recordId}/awards":{"get":{"operationId":"listOpportunityAwards","summary":"List likely awards for an opportunity","tags":["public","opportunities","awards"],"description":"Returns computed contract-award matches for an opportunity with confidence, rule, evidence, and award summary. Matches are generated from current lakehouse data.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"format":"uuid","type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["award","confidence","matchRule","matchReasons","evidence"],"properties":{"award":{"type":"object","required":["recordId","transactionKey","awardKey","sourceName","sourceRecordType","piid","parentPiid","modificationNumber","awardingAgencyName","awardingAgencyCode","vendorUei","vendorName","naicsCode","pscCode","obligatedAmount","totalContractValue","actionDate","actionType","fiscalYear","canonicalUrl"],"properties":{"recordId":{"description":"Opaque identifier for this award transaction. Carries partition hints for efficient detail lookup; treat as a bytestring, not a UUID.","type":"string"},"transactionKey":{"description":"USAspending contract_transaction_unique_key.","type":"string"},"awardKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceName":{"type":"string"},"sourceRecordType":{"anyOf":[{"type":"string","enum":["contract_award"]},{"type":"string","enum":["contract_idv"]}]},"piid":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"modificationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"obligatedAmount":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"actionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"actionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"type":"number"},"canonicalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"confidence":{"description":"Heuristic match confidence from 0 to 1. Exact identifier matches score highest.","type":"number"},"matchRule":{"description":"Machine-readable rule that produced the match, for example piid_equals_solicitation_number.","type":"string"},"matchReasons":{"type":"array","items":{"type":"string"}},"evidence":{"type":"object","required":["solicitationNumber","matchedField","fiscalYearStart","fiscalYearEnd"],"properties":{"solicitationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"matchedField":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYearStart":{"type":"number"},"fiscalYearEnd":{"type":"number"}}}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/opportunities/{recordId}":{"get":{"operationId":"getOpportunity","summary":"Get opportunity detail","tags":["public","opportunities"],"description":"Returns canonical thread-level opportunity detail.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["recordId","threadKey","thread","summary","documents","history","analysis"],"properties":{"recordId":{"format":"uuid","type":"string"},"threadKey":{"type":"string"},"thread":{"type":"object","required":["latestNoticeId","latestNoticeRecordId","noticeCount"],"properties":{"latestNoticeId":{"type":"string"},"latestNoticeRecordId":{"format":"uuid","type":"string"},"noticeCount":{"type":"number"}}},"summary":{"type":"object","required":["sourceName","sourceFamily","noticeId","solicitationNumber","title","agencyName","postedAt","closeAt","opportunityStatus","category","pscCode","noticeType","active","archiveDate","amountFloor","amountCeiling","setAsideLabel","naicsCodes","officePathSegments","officeAddress","placeOfPerformance","descriptionText","primaryContact","secondaryContact","contacts","award"],"properties":{"sourceName":{"type":"string"},"sourceFamily":{"type":"string"},"noticeId":{"type":"string"},"solicitationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"agencyName":{"type":"string"},"postedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"closeAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"opportunityStatus":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"archiveDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"amountFloor":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountCeiling":{"anyOf":[{"type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCodes":{"type":"array","items":{"type":"string"}},"officePathSegments":{"type":"array","items":{"type":"string"}},"officeAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"placeOfPerformance":{"anyOf":[{"type":"string"},{"type":"null"}]},"descriptionText":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryContact":{"anyOf":[{"type":"object","required":["name","role","title","email","phone","fax"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"fax":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"secondaryContact":{"anyOf":[{"type":"object","required":["name","role","title","email","phone","fax"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"fax":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"contacts":{"type":"array","items":{"type":"object","required":["name","role","title","email","phone","fax"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"fax":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"award":{"anyOf":[{"type":"object","required":["date","number","amount","awardeeName","awardeeUei","awardeeCageCode","awardeeLocation"],"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"number":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardeeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardeeUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardeeCageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardeeLocation":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]}}},"documents":{"type":"object","required":["sourcePageUrl","packageViewUrl","packageAttachmentLabel","pdfUrl","pdfFileName","technicalDocumentsLabel","technicalDocumentsUrl","extractedTextStorageUri","extractedTextLength","extractedTextHash","attachments","resourceLinks","intelligence"],"properties":{"sourcePageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"packageViewUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"packageAttachmentLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"pdfUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"pdfFileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"technicalDocumentsLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"technicalDocumentsUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"extractedTextStorageUri":{"anyOf":[{"type":"string"},{"type":"null"}]},"extractedTextLength":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractedTextHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","required":["url","label","fileName","kind","source"],"properties":{"url":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"fileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"resourceLinks":{"type":"array","items":{"type":"string"}},"intelligence":{"type":"object","required":["parserName","parserConfidence","pageCount","buyerName","buyerEmail","buyerPhone","purchaseRequestNumber","quantity","returnByLabel","setAsideLabel","contractTypeLabel","contractMaximumValue","estimatedAnnualQuantity","guaranteedMinimumQuantity","nsn","deliveryRegionText","notFirmQuantity","setAsideConflict","sectionCount","packageItems","deliveryTerms","lineItems","clauses","sections","extractedTextPreview"],"properties":{"parserName":{"anyOf":[{"type":"string"},{"type":"null"}]},"parserConfidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"pageCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"buyerName":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyerEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyerPhone":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaseRequestNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"returnByLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractTypeLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractMaximumValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimatedAnnualQuantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"guaranteedMinimumQuantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"nsn":{"anyOf":[{"type":"string"},{"type":"null"}]},"deliveryRegionText":{"anyOf":[{"type":"string"},{"type":"null"}]},"notFirmQuantity":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"setAsideConflict":{"anyOf":[{"type":"string"},{"type":"null"}]},"sectionCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"packageItems":{"type":"array","items":{"type":"object","required":["lineNumber","title","purchaseRequestNumber","nsnOrPartNumber","quantity","technicalDocumentsLabel"],"properties":{"lineNumber":{"anyOf":[{"type":"number"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaseRequestNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"nsnOrPartNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"technicalDocumentsLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"deliveryTerms":{"anyOf":[{"type":"object","required":["deliverFob","inspectionPoint","acceptancePoint","specialMarkingCode"],"properties":{"deliverFob":{"anyOf":[{"type":"string"},{"type":"null"}]},"inspectionPoint":{"anyOf":[{"type":"string"},{"type":"null"}]},"acceptancePoint":{"anyOf":[{"type":"string"},{"type":"null"}]},"specialMarkingCode":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"lineItems":{"type":"array","items":{"type":"object","required":["clin","title","quantityVariance"],"properties":{"clin":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantityVariance":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"clauses":{"type":"array","items":{"type":"object","required":["reference","family","title"],"properties":{"reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"family":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"sections":{"type":"array","items":{"type":"object","required":["code","heading","title","preview","length"],"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}]},"heading":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview":{"anyOf":[{"type":"string"},{"type":"null"}]},"length":{"anyOf":[{"type":"number"},{"type":"null"}]}}}},"extractedTextPreview":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"history":{"type":"object","required":["updatedAt","relatedRecordCount","events","snapshots"],"properties":{"updatedAt":{"format":"date-time","type":"string"},"relatedRecordCount":{"type":"number"},"events":{"type":"array","items":{"type":"object","required":["eventId","recordId","eventClass","eventType","detectedAt","actionable","reasonSummary","noticeId","title"],"properties":{"eventId":{"format":"uuid","type":"string"},"recordId":{"format":"uuid","type":"string"},"eventClass":{"type":"string"},"eventType":{"type":"string"},"detectedAt":{"format":"date-time","type":"string"},"actionable":{"type":"boolean"},"reasonSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"snapshots":{"type":"array","items":{"type":"object","required":["snapshotId","captureId","observedAt","versionHash"],"properties":{"snapshotId":{"format":"uuid","type":"string"},"captureId":{"format":"uuid","type":"string"},"observedAt":{"format":"date-time","type":"string"},"versionHash":{"type":"string"}}}}}},"analysis":{"type":"object","required":["dimensions","features"],"properties":{"dimensions":{"type":"object","required":["sourceName","sourceFamily","opportunityStatus","category","setAsideLabel","contractTypeLabel","deliveryRegionText","officePathSegments","naicsCodes"],"properties":{"sourceName":{"type":"string"},"sourceFamily":{"type":"string"},"opportunityStatus":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractTypeLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"deliveryRegionText":{"anyOf":[{"type":"string"},{"type":"null"}]},"officePathSegments":{"type":"array","items":{"type":"string"}},"naicsCodes":{"type":"array","items":{"type":"string"}}}},"features":{"type":"object","required":["relatedRecordCount","eventCount","snapshotCount","contactCount","hasDescriptionText","descriptionTextLength","hasAward","hasPackagePage","hasPdf","hasExtractedText","extractedTextLength","hasTechnicalDocuments","resourceLinkCount","packageItemCount","lineItemCount","clauseCount","sectionCount","parserConfidence","hasDocumentConflict","hasBuyerContact","hasDeliveryTerms","hasDeliveryRegion","quantity","estimatedAnnualQuantity","guaranteedMinimumQuantity","amountFloor","amountCeiling","contractMaximumValue"],"properties":{"relatedRecordCount":{"type":"number"},"eventCount":{"type":"number"},"snapshotCount":{"type":"number"},"contactCount":{"type":"number"},"hasDescriptionText":{"type":"boolean"},"descriptionTextLength":{"type":"number"},"hasAward":{"type":"boolean"},"hasPackagePage":{"type":"boolean"},"hasPdf":{"type":"boolean"},"hasExtractedText":{"type":"boolean"},"extractedTextLength":{"anyOf":[{"type":"number"},{"type":"null"}]},"hasTechnicalDocuments":{"type":"boolean"},"resourceLinkCount":{"type":"number"},"packageItemCount":{"type":"number"},"lineItemCount":{"type":"number"},"clauseCount":{"type":"number"},"sectionCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"parserConfidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"hasDocumentConflict":{"type":"boolean"},"hasBuyerContact":{"type":"boolean"},"hasDeliveryTerms":{"type":"boolean"},"hasDeliveryRegion":{"type":"boolean"},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedAnnualQuantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"guaranteedMinimumQuantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"amountFloor":{"anyOf":[{"type":"number"},{"type":"null"}]},"amountCeiling":{"anyOf":[{"type":"number"},{"type":"null"}]},"contractMaximumValue":{"anyOf":[{"type":"number"},{"type":"null"}]}}}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/awards":{"get":{"operationId":"listAwards","summary":"List federal contract awards and IDVs","tags":["public","awards"],"description":"Returns contract award actions filtered by vendor, agency, NAICS, PSC, PIID, row type, or action-date window. Defaults to award actions; pass record_type=idv or record_type=all to intentionally include IDV rows. Sorted by action_date DESC; cursor round-trip is stable.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"anyOf":[{"type":"string","enum":["award"]},{"type":"string","enum":["idv"]},{"type":"string","enum":["all"]}]},"in":"query","name":"record_type","required":false},{"schema":{"type":"string"},"in":"query","name":"vendor_uei","required":false},{"schema":{"type":"string"},"in":"query","name":"awarding_agency_code","required":false},{"schema":{"type":"string"},"in":"query","name":"naics_code","required":false},{"schema":{"type":"string"},"in":"query","name":"psc_code","required":false},{"schema":{"type":"string"},"in":"query","name":"piid","required":false},{"schema":{"type":"string"},"in":"query","name":"fiscal_year","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"action_date_from","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"action_date_to","required":false},{"schema":{"format":"date-time","type":"string"},"in":"query","name":"updated_since","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","transactionKey","awardKey","sourceName","sourceRecordType","piid","parentPiid","modificationNumber","awardingAgencyName","awardingAgencyCode","vendorUei","vendorName","naicsCode","pscCode","obligatedAmount","totalContractValue","actionDate","actionType","fiscalYear","canonicalUrl"],"properties":{"recordId":{"description":"Opaque identifier for this award transaction. Carries partition hints for efficient detail lookup; treat as a bytestring, not a UUID.","type":"string"},"transactionKey":{"description":"USAspending contract_transaction_unique_key.","type":"string"},"awardKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceName":{"type":"string"},"sourceRecordType":{"anyOf":[{"type":"string","enum":["contract_award"]},{"type":"string","enum":["contract_idv"]}]},"piid":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"modificationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"obligatedAmount":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"actionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"actionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"type":"number"},"canonicalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/awards/analysis/rollups":{"get":{"operationId":"listAwardRollups","summary":"Rollup awards by agency / NAICS / PSC / vendor","tags":["public","awards"],"description":"Returns grouped aggregates over contract_awards. Groups by awarding_agency_code, naics_code, psc_code, or vendor_uei; scope via fiscal_year and/or action_date window. No row-level output.","parameters":[{"schema":{"anyOf":[{"type":"string","enum":["awarding_agency_code"]},{"type":"string","enum":["naics_code"]},{"type":"string","enum":["psc_code"]},{"type":"string","enum":["vendor_uei"]}]},"in":"query","name":"group_by","required":true},{"schema":{"anyOf":[{"type":"string","enum":["total_obligated"]},{"type":"string","enum":["award_count"]}]},"in":"query","name":"sort_by","required":false},{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"fiscal_year","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"action_date_from","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"action_date_to","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["rollups","scope","groupBy"],"properties":{"rollups":{"type":"array","items":{"type":"object","required":["groupKey","groupLabel","awardCount","totalObligatedAmount","totalContractValue","distinctVendorCount"],"properties":{"groupKey":{"type":"string"},"groupLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardCount":{"type":"number"},"totalObligatedAmount":{"type":"string"},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"distinctVendorCount":{"anyOf":[{"type":"number"},{"type":"null"}]}}}},"scope":{"type":"object","required":["actionDateFrom","actionDateTo","fiscalYear"],"properties":{"actionDateFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"actionDateTo":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"groupBy":{"anyOf":[{"type":"string","enum":["awardingAgencyCode"]},{"type":"string","enum":["naicsCode"]},{"type":"string","enum":["pscCode"]},{"type":"string","enum":["vendorUei"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/awards/{recordId}/hierarchy":{"get":{"operationId":"getAwardHierarchy","summary":"Get award hierarchy","tags":["public","awards"],"description":"Returns related parent IDVs, child award actions, and same-award transactions for a contract award or IDV record.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["record","items","rollup"],"properties":{"record":{"type":"object","allOf":[{"type":"object","required":["recordId","transactionKey","awardKey","sourceName","sourceRecordType","piid","parentPiid","modificationNumber","awardingAgencyName","awardingAgencyCode","vendorUei","vendorName","naicsCode","pscCode","obligatedAmount","totalContractValue","actionDate","actionType","fiscalYear","canonicalUrl"],"properties":{"recordId":{"description":"Opaque identifier for this award transaction. Carries partition hints for efficient detail lookup; treat as a bytestring, not a UUID.","type":"string"},"transactionKey":{"description":"USAspending contract_transaction_unique_key.","type":"string"},"awardKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceName":{"type":"string"},"sourceRecordType":{"anyOf":[{"type":"string","enum":["contract_award"]},{"type":"string","enum":["contract_idv"]}]},"piid":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"modificationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"obligatedAmount":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"actionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"actionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"type":"number"},"canonicalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"object","required":["actionDateMonth","transactionNumber","parentAwardModificationNumber","baseAndAllOptionsValue","totalDollarsObligated","transactionDescription","periodOfPerformanceStartDate","periodOfPerformanceCurrentEndDate","naicsDescription","productOrServiceCodeDescription","extentCompeted","typeOfSetAside","typeOfContractPricing","recipientStateCode","recipientCountryCode","primaryPlaceOfPerformanceStateCode","primaryPlaceOfPerformanceCountryCode","lastModifiedDate","ingestedAt"],"properties":{"actionDateMonth":{"description":"YYYY-MM partition bucket the row landed in.","type":"string"},"transactionNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentAwardModificationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"baseAndAllOptionsValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalDollarsObligated":{"anyOf":[{"type":"string"},{"type":"null"}]},"transactionDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"periodOfPerformanceStartDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"periodOfPerformanceCurrentEndDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"productOrServiceCodeDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"extentCompeted":{"anyOf":[{"type":"string"},{"type":"null"}]},"typeOfSetAside":{"anyOf":[{"type":"string"},{"type":"null"}]},"typeOfContractPricing":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientStateCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryPlaceOfPerformanceStateCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryPlaceOfPerformanceCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastModifiedDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}]},"items":{"type":"array","items":{"type":"object","required":["relationship","award"],"properties":{"relationship":{"anyOf":[{"type":"string","enum":["parent_idv"]},{"type":"string","enum":["child_award"]},{"type":"string","enum":["same_award_transaction"]}]},"award":{"type":"object","required":["recordId","transactionKey","awardKey","sourceName","sourceRecordType","piid","parentPiid","modificationNumber","awardingAgencyName","awardingAgencyCode","vendorUei","vendorName","naicsCode","pscCode","obligatedAmount","totalContractValue","actionDate","actionType","fiscalYear","canonicalUrl"],"properties":{"recordId":{"description":"Opaque identifier for this award transaction. Carries partition hints for efficient detail lookup; treat as a bytestring, not a UUID.","type":"string"},"transactionKey":{"description":"USAspending contract_transaction_unique_key.","type":"string"},"awardKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceName":{"type":"string"},"sourceRecordType":{"anyOf":[{"type":"string","enum":["contract_award"]},{"type":"string","enum":["contract_idv"]}]},"piid":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"modificationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"obligatedAmount":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"actionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"actionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"type":"number"},"canonicalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"rollup":{"type":"object","required":["fiscalYearStart","fiscalYearEnd","childAwardCount","childObligatedAmount","childTotalContractValue"],"properties":{"fiscalYearStart":{"type":"number"},"fiscalYearEnd":{"type":"number"},"childAwardCount":{"type":"number"},"childObligatedAmount":{"type":"string"},"childTotalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/awards/{recordId}":{"get":{"operationId":"getAward","summary":"Get federal contract award or IDV detail","tags":["public","awards"],"description":"Returns a single contract award action or IDV by recordId. 400 if recordId is malformed; 404 if not found.","parameters":[{"schema":{"type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","allOf":[{"type":"object","required":["recordId","transactionKey","awardKey","sourceName","sourceRecordType","piid","parentPiid","modificationNumber","awardingAgencyName","awardingAgencyCode","vendorUei","vendorName","naicsCode","pscCode","obligatedAmount","totalContractValue","actionDate","actionType","fiscalYear","canonicalUrl"],"properties":{"recordId":{"description":"Opaque identifier for this award transaction. Carries partition hints for efficient detail lookup; treat as a bytestring, not a UUID.","type":"string"},"transactionKey":{"description":"USAspending contract_transaction_unique_key.","type":"string"},"awardKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceName":{"type":"string"},"sourceRecordType":{"anyOf":[{"type":"string","enum":["contract_award"]},{"type":"string","enum":["contract_idv"]}]},"piid":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"modificationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"obligatedAmount":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"actionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"actionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"type":"number"},"canonicalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"object","required":["actionDateMonth","transactionNumber","parentAwardModificationNumber","baseAndAllOptionsValue","totalDollarsObligated","transactionDescription","periodOfPerformanceStartDate","periodOfPerformanceCurrentEndDate","naicsDescription","productOrServiceCodeDescription","extentCompeted","typeOfSetAside","typeOfContractPricing","recipientStateCode","recipientCountryCode","primaryPlaceOfPerformanceStateCode","primaryPlaceOfPerformanceCountryCode","lastModifiedDate","ingestedAt"],"properties":{"actionDateMonth":{"description":"YYYY-MM partition bucket the row landed in.","type":"string"},"transactionNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentAwardModificationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"baseAndAllOptionsValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalDollarsObligated":{"anyOf":[{"type":"string"},{"type":"null"}]},"transactionDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"periodOfPerformanceStartDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"periodOfPerformanceCurrentEndDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"productOrServiceCodeDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"extentCompeted":{"anyOf":[{"type":"string"},{"type":"null"}]},"typeOfSetAside":{"anyOf":[{"type":"string"},{"type":"null"}]},"typeOfContractPricing":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientStateCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryPlaceOfPerformanceStateCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryPlaceOfPerformanceCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastModifiedDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/exclusions":{"get":{"operationId":"listExclusions","summary":"List SAM.gov exclusion records","tags":["public","exclusions"],"description":"Returns active SAM.gov exclusion records from the latest snapshot by default. Filter by UEI, CAGE, NPI, name search, or pin a historical snapshot_date.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"type":"string"},"in":"query","name":"uei","required":false},{"schema":{"type":"string"},"in":"query","name":"cage_code","required":false},{"schema":{"type":"string"},"in":"query","name":"npi","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"snapshot_date","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotDate","snapshotMonth","exclusionFingerprint","duplicateOrdinal","fileRowNumber","extractDate","uei","cageCode","npi","samNumber","classification","displayName","entityName","city","stateProvince","countryCode","postalCode","exclusionProgram","excludingAgencyCode","exclusionType","activeDate","terminationDate","terminationIndefinite","recordStatus","creationDate","ingestedAt"],"properties":{"recordId":{"description":"Opaque identifier for this exclusion row. Treat as a bytestring, not a UUID.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"type":"string"},"exclusionFingerprint":{"type":"string"},"duplicateOrdinal":{"anyOf":[{"type":"number"},{"type":"null"}]},"fileRowNumber":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"uei":{"anyOf":[{"type":"string"},{"type":"null"}]},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"npi":{"anyOf":[{"type":"string"},{"type":"null"}]},"samNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"classification":{"anyOf":[{"type":"string"},{"type":"null"}]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"entityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"stateProvince":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"exclusionProgram":{"anyOf":[{"type":"string"},{"type":"null"}]},"excludingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"exclusionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"terminationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"terminationIndefinite":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"recordStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"creationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/entities":{"get":{"operationId":"listEntities","summary":"List SAM.gov entity registrations","tags":["public","entities"],"description":"Returns SAM.gov entity registration rows from the latest monthly snapshot by default. Filter by UEI, CAGE, registration status, primary NAICS, free-text query, or pin a historical snapshot_month.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"type":"string"},"in":"query","name":"uei","required":false},{"schema":{"type":"string"},"in":"query","name":"cage_code","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"snapshot_month","required":false},{"schema":{"type":"string"},"in":"query","name":"registration_status","required":false},{"schema":{"type":"string"},"in":"query","name":"primary_naics_code","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotMonth","uei","cageCode","legalBusinessName","dbaName","registrationStatus","primaryNaicsCode","physicalAddressCity","physicalAddressState","physicalAddressCountryCode","registrationDate","registrationExpirationDate","registrationActivationDate","lastUpdateDate","extractDate","ingestedAt"],"properties":{"recordId":{"description":"Stable entity identifier for this registration row. v1 uses the UEI.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotMonth":{"type":"string"},"uei":{"type":"string"},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalBusinessName":{"anyOf":[{"type":"string"},{"type":"null"}]},"dbaName":{"anyOf":[{"type":"string"},{"type":"null"}]},"registrationStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryNaicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressState":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"registrationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"registrationExpirationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"registrationActivationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"lastUpdateDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/entities/{uei}":{"get":{"operationId":"getEntity","summary":"Get SAM.gov entity registration detail","tags":["public","entities"],"description":"Returns one SAM.gov entity registration by UEI from the latest monthly snapshot by default, or a pinned snapshot_month.","parameters":[{"schema":{"type":"string"},"in":"query","name":"snapshot_month","required":false},{"schema":{"type":"string"},"in":"path","name":"uei","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","allOf":[{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotMonth","uei","cageCode","legalBusinessName","dbaName","registrationStatus","primaryNaicsCode","physicalAddressCity","physicalAddressState","physicalAddressCountryCode","registrationDate","registrationExpirationDate","registrationActivationDate","lastUpdateDate","extractDate","ingestedAt"],"properties":{"recordId":{"description":"Stable entity identifier for this registration row. v1 uses the UEI.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotMonth":{"type":"string"},"uei":{"type":"string"},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalBusinessName":{"anyOf":[{"type":"string"},{"type":"null"}]},"dbaName":{"anyOf":[{"type":"string"},{"type":"null"}]},"registrationStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryNaicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressState":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"registrationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"registrationExpirationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"registrationActivationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"lastUpdateDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}},{"type":"object","required":["physicalAddressLine1","physicalAddressLine2","physicalAddressPostalCode","mailingAddressLine1","mailingAddressLine2","mailingAddressCity","mailingAddressState","mailingAddressPostalCode","mailingAddressCountryCode","naicsCodesJson","businessTypesCodesJson","socioeconomicCertificationsJson","incorporationState","incorporationCountryCode"],"properties":{"physicalAddressLine1":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressLine2":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressPostalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressLine1":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressLine2":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressState":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressPostalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCodesJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"businessTypesCodesJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"socioeconomicCertificationsJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"incorporationState":{"anyOf":[{"type":"string"},{"type":"null"}]},"incorporationCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]}}}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/entities/{uei}/profile":{"get":{"operationId":"getEntityProfile","summary":"Get connected entity profile","tags":["public","entities"],"description":"Returns one SAM.gov entity registration plus connected recent contract awards, agency/NAICS/PSC rollups, registration health, risk flags, exclusions, and responsibility/integrity records. Latest snapshots are used by default; snapshot_month pins registration state and snapshot_date pins exclusion/integrity state.","parameters":[{"schema":{"type":"string"},"in":"query","name":"snapshot_month","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"snapshot_date","required":false},{"schema":{"type":"string"},"example":"25","in":"query","name":"awards_limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"example":"25","in":"query","name":"exclusions_limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"example":"25","in":"query","name":"integrity_limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"example":"25","in":"query","name":"agency_rollups_limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"example":"25","in":"query","name":"code_rollups_limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"path","name":"uei","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["uei","entity","registration","risk","awards","exclusions","integrityRecords"],"properties":{"uei":{"type":"string"},"entity":{"type":"object","allOf":[{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotMonth","uei","cageCode","legalBusinessName","dbaName","registrationStatus","primaryNaicsCode","physicalAddressCity","physicalAddressState","physicalAddressCountryCode","registrationDate","registrationExpirationDate","registrationActivationDate","lastUpdateDate","extractDate","ingestedAt"],"properties":{"recordId":{"description":"Stable entity identifier for this registration row. v1 uses the UEI.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotMonth":{"type":"string"},"uei":{"type":"string"},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalBusinessName":{"anyOf":[{"type":"string"},{"type":"null"}]},"dbaName":{"anyOf":[{"type":"string"},{"type":"null"}]},"registrationStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryNaicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressState":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"registrationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"registrationExpirationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"registrationActivationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"lastUpdateDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}},{"type":"object","required":["physicalAddressLine1","physicalAddressLine2","physicalAddressPostalCode","mailingAddressLine1","mailingAddressLine2","mailingAddressCity","mailingAddressState","mailingAddressPostalCode","mailingAddressCountryCode","naicsCodesJson","businessTypesCodesJson","socioeconomicCertificationsJson","incorporationState","incorporationCountryCode"],"properties":{"physicalAddressLine1":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressLine2":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressPostalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressLine1":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressLine2":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressState":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressPostalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"mailingAddressCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCodesJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"businessTypesCodesJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"socioeconomicCertificationsJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"incorporationState":{"anyOf":[{"type":"string"},{"type":"null"}]},"incorporationCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]}}}]},"registration":{"type":"object","required":["status","isActive","expiresAt","daysUntilExpiration","expirationStatus","primaryNaicsCode","registeredNaicsCodes","businessTypeCodes","socioeconomicCertifications"],"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"expiresAt":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"daysUntilExpiration":{"anyOf":[{"type":"number"},{"type":"null"}]},"expirationStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["expires_soon"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["unknown"]}]},"primaryNaicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"registeredNaicsCodes":{"type":"array","items":{"type":"string"}},"businessTypeCodes":{"type":"array","items":{"type":"string"}},"socioeconomicCertifications":{"type":"array","items":{"type":"string"}}}},"risk":{"type":"object","required":["hasExclusions","hasActiveExclusions","exclusionCount","activeExclusionCount","hasIntegrityRecords","hasActiveIntegrityRecords","integrityRecordCount","activeIntegrityRecordCount","warningCount","warnings"],"properties":{"hasExclusions":{"type":"boolean"},"hasActiveExclusions":{"type":"boolean"},"exclusionCount":{"type":"number"},"activeExclusionCount":{"type":"number"},"hasIntegrityRecords":{"type":"boolean"},"hasActiveIntegrityRecords":{"type":"boolean"},"integrityRecordCount":{"type":"number"},"activeIntegrityRecordCount":{"type":"number"},"warningCount":{"type":"number"},"warnings":{"type":"array","items":{"type":"string"}}}},"awards":{"type":"object","required":["recent","nextCursor","agencyRollups","naicsRollups","pscRollups"],"properties":{"recent":{"type":"array","items":{"type":"object","required":["recordId","transactionKey","awardKey","sourceName","sourceRecordType","piid","parentPiid","modificationNumber","awardingAgencyName","awardingAgencyCode","vendorUei","vendorName","naicsCode","pscCode","obligatedAmount","totalContractValue","actionDate","actionType","fiscalYear","canonicalUrl"],"properties":{"recordId":{"description":"Opaque identifier for this award transaction. Carries partition hints for efficient detail lookup; treat as a bytestring, not a UUID.","type":"string"},"transactionKey":{"description":"USAspending contract_transaction_unique_key.","type":"string"},"awardKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceName":{"type":"string"},"sourceRecordType":{"anyOf":[{"type":"string","enum":["contract_award"]},{"type":"string","enum":["contract_idv"]}]},"piid":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"modificationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"vendorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"obligatedAmount":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"actionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"actionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"type":"number"},"canonicalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyRollups":{"type":"array","items":{"type":"object","required":["agencyCode","agencyName","awardCount","totalObligatedAmount","latestActionDate","federalAgencyMatchType","federalAgency"],"properties":{"agencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardCount":{"type":"number"},"totalObligatedAmount":{"type":"string"},"latestActionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"federalAgencyMatchType":{"anyOf":[{"type":"string"},{"type":"null"}]},"federalAgency":{"anyOf":[{"type":"object","required":["fhOrgId","fhOrgName","fhOrgType","status","agencyCode","cgacCodes"],"properties":{"fhOrgId":{"type":"string"},"fhOrgName":{"anyOf":[{"type":"string"},{"type":"null"}]},"fhOrgType":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"cgacCodes":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]}}}},"naicsRollups":{"type":"array","items":{"type":"object","required":["code","description","awardCount","totalObligatedAmount","totalContractValue","latestActionDate"],"properties":{"code":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardCount":{"type":"number"},"totalObligatedAmount":{"type":"string"},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestActionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}}}},"pscRollups":{"type":"array","items":{"type":"object","required":["code","description","awardCount","totalObligatedAmount","totalContractValue","latestActionDate"],"properties":{"code":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"awardCount":{"type":"number"},"totalObligatedAmount":{"type":"string"},"totalContractValue":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestActionDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]}}}}}},"exclusions":{"type":"object","required":["items","nextCursor"],"properties":{"items":{"type":"array","items":{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotDate","snapshotMonth","exclusionFingerprint","duplicateOrdinal","fileRowNumber","extractDate","uei","cageCode","npi","samNumber","classification","displayName","entityName","city","stateProvince","countryCode","postalCode","exclusionProgram","excludingAgencyCode","exclusionType","activeDate","terminationDate","terminationIndefinite","recordStatus","creationDate","ingestedAt"],"properties":{"recordId":{"description":"Opaque identifier for this exclusion row. Treat as a bytestring, not a UUID.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"type":"string"},"exclusionFingerprint":{"type":"string"},"duplicateOrdinal":{"anyOf":[{"type":"number"},{"type":"null"}]},"fileRowNumber":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"uei":{"anyOf":[{"type":"string"},{"type":"null"}]},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"npi":{"anyOf":[{"type":"string"},{"type":"null"}]},"samNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"classification":{"anyOf":[{"type":"string"},{"type":"null"}]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"entityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"stateProvince":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"exclusionProgram":{"anyOf":[{"type":"string"},{"type":"null"}]},"excludingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"exclusionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"terminationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"terminationIndefinite":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"recordStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"creationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"integrityRecords":{"type":"object","required":["items","nextCursor"],"properties":{"items":{"type":"array","items":{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","recordFamily","snapshotDate","snapshotMonth","fingerprint","duplicateOrdinal","extractDate","extractKind","accessTier","publicDisplayFlag","isRedacted","attachmentUrlPresent","uei","cageCode","legalBusinessName","recordDate","procurementId","federalAssistanceId","referenceIdvPiid","primaryNaicsCode","pscCode","title","agency","disposition","proceedingType","proceedingState","terminationType","terminationDate","statusActive","ingestedAt"],"properties":{"recordId":{"description":"Opaque identifier for this integrity row. Treat as a bytestring, not a UUID.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"recordFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]},"fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}]},"duplicateOrdinal":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"extractKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"accessTier":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicDisplayFlag":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isRedacted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"attachmentUrlPresent":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"uei":{"anyOf":[{"type":"string"},{"type":"null"}]},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalBusinessName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recordDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"procurementId":{"anyOf":[{"type":"string"},{"type":"null"}]},"federalAssistanceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceIdvPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryNaicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"agency":{"anyOf":[{"type":"string"},{"type":"null"}]},"disposition":{"anyOf":[{"type":"string"},{"type":"null"}]},"proceedingType":{"anyOf":[{"type":"string"},{"type":"null"}]},"proceedingState":{"anyOf":[{"type":"string"},{"type":"null"}]},"terminationType":{"anyOf":[{"type":"string"},{"type":"null"}]},"terminationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"statusActive":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/entities/{uei}/exclusions":{"get":{"operationId":"listEntityExclusions","summary":"List exclusion records for an entity UEI","tags":["public","entities","exclusions"],"description":"Returns SAM.gov exclusion records for one UEI from the latest snapshot by default, or a pinned historical snapshot_date.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"format":"date","type":"string"},"in":"query","name":"snapshot_date","required":false},{"schema":{"type":"string"},"in":"path","name":"uei","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotDate","snapshotMonth","exclusionFingerprint","duplicateOrdinal","fileRowNumber","extractDate","uei","cageCode","npi","samNumber","classification","displayName","entityName","city","stateProvince","countryCode","postalCode","exclusionProgram","excludingAgencyCode","exclusionType","activeDate","terminationDate","terminationIndefinite","recordStatus","creationDate","ingestedAt"],"properties":{"recordId":{"description":"Opaque identifier for this exclusion row. Treat as a bytestring, not a UUID.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"type":"string"},"exclusionFingerprint":{"type":"string"},"duplicateOrdinal":{"anyOf":[{"type":"number"},{"type":"null"}]},"fileRowNumber":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"uei":{"anyOf":[{"type":"string"},{"type":"null"}]},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"npi":{"anyOf":[{"type":"string"},{"type":"null"}]},"samNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"classification":{"anyOf":[{"type":"string"},{"type":"null"}]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"entityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"stateProvince":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"exclusionProgram":{"anyOf":[{"type":"string"},{"type":"null"}]},"excludingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"exclusionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"terminationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"terminationIndefinite":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"recordStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"creationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/agencies":{"get":{"operationId":"listAgencies","summary":"List SAM.gov Federal Hierarchy agencies","tags":["public","agencies"],"description":"Returns public SAM.gov Federal Hierarchy department/independent-agency and sub-tier organization rows from the latest snapshot by default. Filter by agency code, organization type, status, parent organization, free-text query, or pin a historical snapshot_date.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"agency_code","required":false},{"schema":{"type":"string"},"in":"query","name":"fh_org_type","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"parent_fh_org_id","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"snapshot_date","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotDate","snapshotMonth","fhOrgId","fhOrgName","fhOrgType","status","parentFhOrgId","agencyOrgName","agencyCode","cgacCodes","createdDate","lastUpdatedDate","ingestedAt"],"properties":{"recordId":{"description":"Stable Federal Hierarchy organization identifier. v1 uses fh_org_id.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"type":"string"},"fhOrgId":{"type":"string"},"fhOrgName":{"anyOf":[{"type":"string"},{"type":"null"}]},"fhOrgType":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentFhOrgId":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyOrgName":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"cgacCodes":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"lastUpdatedDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/agencies/{orgId}":{"get":{"operationId":"getAgency","summary":"Get SAM.gov Federal Hierarchy agency detail","tags":["public","agencies"],"description":"Returns one Federal Hierarchy organization by fhOrgId from the latest snapshot by default, or a pinned snapshot_date.","parameters":[{"schema":{"format":"date","type":"string"},"in":"query","name":"snapshot_date","required":false},{"schema":{"type":"string"},"in":"path","name":"orgId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","allOf":[{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotDate","snapshotMonth","fhOrgId","fhOrgName","fhOrgType","status","parentFhOrgId","agencyOrgName","agencyCode","cgacCodes","createdDate","lastUpdatedDate","ingestedAt"],"properties":{"recordId":{"description":"Stable Federal Hierarchy organization identifier. v1 uses fh_org_id.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"type":"string"},"fhOrgId":{"type":"string"},"fhOrgName":{"anyOf":[{"type":"string"},{"type":"null"}]},"fhOrgType":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentFhOrgId":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyOrgName":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"cgacCodes":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"lastUpdatedDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}},{"type":"object","required":["nameHistoryJson","parentHistoryJson","sourceRowJson"],"properties":{"nameHistoryJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentHistoryJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceRowJson":{"anyOf":[{"type":"string"},{"type":"null"}]}}}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/assistance-listings":{"get":{"operationId":"listAssistanceListings","summary":"List SAM.gov Assistance Listings","tags":["public","assistance-listings"],"description":"Returns SAM.gov Assistance Listings / CFDA federal program reference rows from the latest snapshot by default. Filter by listing id, organization codes, fiscal year, status, free-text query, or pin a historical snapshot_date. Rows include Federal Hierarchy enrichment when organization codes match.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"assistance_listing_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"fiscal_year","required":false},{"schema":{"type":"string"},"in":"query","name":"department_code","required":false},{"schema":{"type":"string"},"in":"query","name":"agency_code","required":false},{"schema":{"type":"string"},"in":"query","name":"office_code","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"snapshot_date","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotDate","snapshotMonth","assistanceListingId","programId","version","status","fiscalYear","publishedDate","title","popularLongName","popularShortName","department","departmentCode","agency","agencyCode","office","officeCode","programWebPage","objective","assistanceListingDescription","federalAgencyMatchType","federalAgency","ingestedAt"],"properties":{"recordId":{"description":"Stable SAM.gov Assistance Listing identifier. v1 uses assistance_listing_id.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"type":"string"},"assistanceListingId":{"type":"string"},"programId":{"anyOf":[{"type":"string"},{"type":"null"}]},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"anyOf":[{"type":"number"},{"type":"null"}]},"publishedDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"title":{"type":"string"},"popularLongName":{"anyOf":[{"type":"string"},{"type":"null"}]},"popularShortName":{"anyOf":[{"type":"string"},{"type":"null"}]},"department":{"anyOf":[{"type":"string"},{"type":"null"}]},"departmentCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"agency":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"office":{"anyOf":[{"type":"string"},{"type":"null"}]},"officeCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"programWebPage":{"anyOf":[{"type":"string"},{"type":"null"}]},"objective":{"anyOf":[{"type":"string"},{"type":"null"}]},"assistanceListingDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"federalAgencyMatchType":{"anyOf":[{"type":"string"},{"type":"null"}]},"federalAgency":{"anyOf":[{"type":"object","required":["fhOrgId","fhOrgName","fhOrgType","status","agencyCode","cgacCodes"],"properties":{"fhOrgId":{"type":"string"},"fhOrgName":{"anyOf":[{"type":"string"},{"type":"null"}]},"fhOrgType":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"cgacCodes":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/assistance-listings/{listingId}":{"get":{"operationId":"getAssistanceListing","summary":"Get SAM.gov Assistance Listing detail","tags":["public","assistance-listings"],"description":"Returns one SAM.gov Assistance Listing by assistanceListingId from the latest snapshot by default, or a pinned snapshot_date.","parameters":[{"schema":{"format":"date","type":"string"},"in":"query","name":"snapshot_date","required":false},{"schema":{"type":"string"},"in":"path","name":"listingId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","allOf":[{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotDate","snapshotMonth","assistanceListingId","programId","version","status","fiscalYear","publishedDate","title","popularLongName","popularShortName","department","departmentCode","agency","agencyCode","office","officeCode","programWebPage","objective","assistanceListingDescription","federalAgencyMatchType","federalAgency","ingestedAt"],"properties":{"recordId":{"description":"Stable SAM.gov Assistance Listing identifier. v1 uses assistance_listing_id.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"type":"string"},"assistanceListingId":{"type":"string"},"programId":{"anyOf":[{"type":"string"},{"type":"null"}]},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYear":{"anyOf":[{"type":"number"},{"type":"null"}]},"publishedDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"title":{"type":"string"},"popularLongName":{"anyOf":[{"type":"string"},{"type":"null"}]},"popularShortName":{"anyOf":[{"type":"string"},{"type":"null"}]},"department":{"anyOf":[{"type":"string"},{"type":"null"}]},"departmentCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"agency":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"office":{"anyOf":[{"type":"string"},{"type":"null"}]},"officeCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"programWebPage":{"anyOf":[{"type":"string"},{"type":"null"}]},"objective":{"anyOf":[{"type":"string"},{"type":"null"}]},"assistanceListingDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"federalAgencyMatchType":{"anyOf":[{"type":"string"},{"type":"null"}]},"federalAgency":{"anyOf":[{"type":"object","required":["fhOrgId","fhOrgName","fhOrgType","status","agencyCode","cgacCodes"],"properties":{"fhOrgId":{"type":"string"},"fhOrgName":{"anyOf":[{"type":"string"},{"type":"null"}]},"fhOrgType":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"cgacCodes":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}},{"type":"object","required":["relatedFederalAssistanceJson","overviewJson","authorizationsJson","financialInformationJson","criteriaJson","assistanceApplicationJson","complianceJson","contactsJson","sourceRowJson"],"properties":{"relatedFederalAssistanceJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"overviewJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorizationsJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"financialInformationJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"criteriaJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"assistanceApplicationJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"complianceJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"contactsJson":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceRowJson":{"anyOf":[{"type":"string"},{"type":"null"}]}}}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/exclusions/{recordId}":{"get":{"operationId":"getExclusion","summary":"Get SAM.gov exclusion detail","tags":["public","exclusions"],"description":"Returns a single SAM.gov exclusion row by recordId. 400 if recordId is malformed; 404 if not found.","parameters":[{"schema":{"type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","allOf":[{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","snapshotDate","snapshotMonth","exclusionFingerprint","duplicateOrdinal","fileRowNumber","extractDate","uei","cageCode","npi","samNumber","classification","displayName","entityName","city","stateProvince","countryCode","postalCode","exclusionProgram","excludingAgencyCode","exclusionType","activeDate","terminationDate","terminationIndefinite","recordStatus","creationDate","ingestedAt"],"properties":{"recordId":{"description":"Opaque identifier for this exclusion row. Treat as a bytestring, not a UUID.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"type":"string"},"exclusionFingerprint":{"type":"string"},"duplicateOrdinal":{"anyOf":[{"type":"number"},{"type":"null"}]},"fileRowNumber":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"uei":{"anyOf":[{"type":"string"},{"type":"null"}]},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"npi":{"anyOf":[{"type":"string"},{"type":"null"}]},"samNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"classification":{"anyOf":[{"type":"string"},{"type":"null"}]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"entityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"stateProvince":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"exclusionProgram":{"anyOf":[{"type":"string"},{"type":"null"}]},"excludingAgencyCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"exclusionType":{"anyOf":[{"type":"string"},{"type":"null"}]},"activeDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"terminationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"terminationIndefinite":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"recordStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"creationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}},{"type":"object","required":["prefix","firstName","middleName","lastName","suffix","addressLine1","addressLine2","addressLine3","addressLine4","openDataFlag","ctCode","additionalComments","crossReference"],"properties":{"prefix":{"anyOf":[{"type":"string"},{"type":"null"}]},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}]},"middleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}]},"suffix":{"anyOf":[{"type":"string"},{"type":"null"}]},"addressLine1":{"anyOf":[{"type":"string"},{"type":"null"}]},"addressLine2":{"anyOf":[{"type":"string"},{"type":"null"}]},"addressLine3":{"anyOf":[{"type":"string"},{"type":"null"}]},"addressLine4":{"anyOf":[{"type":"string"},{"type":"null"}]},"openDataFlag":{"anyOf":[{"type":"string"},{"type":"null"}]},"ctCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"additionalComments":{"anyOf":[{"type":"string"},{"type":"null"}]},"crossReference":{"anyOf":[{"type":"string"},{"type":"null"}]}}}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/integrity-records":{"get":{"operationId":"listIntegrityRecords","summary":"List SAM.gov responsibility and integrity records","tags":["public","integrity-records"],"description":"Returns public SAM.gov Responsibility/Qualification and FAPIIS records from the latest snapshot by default. Filter by UEI, CAGE, family, extract kind, active status, text query, or pin a historical snapshot_date.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."},{"schema":{"type":"string"},"in":"query","name":"uei","required":false},{"schema":{"type":"string"},"in":"query","name":"cage_code","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"record_family","required":false},{"schema":{"type":"string"},"in":"query","name":"extract_kind","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"snapshot_date","required":false},{"schema":{"type":"string"},"in":"query","name":"status_active","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","recordFamily","snapshotDate","snapshotMonth","fingerprint","duplicateOrdinal","extractDate","extractKind","accessTier","publicDisplayFlag","isRedacted","attachmentUrlPresent","uei","cageCode","legalBusinessName","recordDate","procurementId","federalAssistanceId","referenceIdvPiid","primaryNaicsCode","pscCode","title","agency","disposition","proceedingType","proceedingState","terminationType","terminationDate","statusActive","ingestedAt"],"properties":{"recordId":{"description":"Opaque identifier for this integrity row. Treat as a bytestring, not a UUID.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"recordFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]},"fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}]},"duplicateOrdinal":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"extractKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"accessTier":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicDisplayFlag":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isRedacted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"attachmentUrlPresent":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"uei":{"anyOf":[{"type":"string"},{"type":"null"}]},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalBusinessName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recordDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"procurementId":{"anyOf":[{"type":"string"},{"type":"null"}]},"federalAssistanceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceIdvPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryNaicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"agency":{"anyOf":[{"type":"string"},{"type":"null"}]},"disposition":{"anyOf":[{"type":"string"},{"type":"null"}]},"proceedingType":{"anyOf":[{"type":"string"},{"type":"null"}]},"proceedingState":{"anyOf":[{"type":"string"},{"type":"null"}]},"terminationType":{"anyOf":[{"type":"string"},{"type":"null"}]},"terminationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"statusActive":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/integrity-records/{recordId}":{"get":{"operationId":"getIntegrityRecord","summary":"Get SAM.gov responsibility and integrity record detail","tags":["public","integrity-records"],"description":"Returns a single public SAM.gov Responsibility/Qualification or FAPIIS record by recordId. 400 if recordId is malformed; 404 if not found.","parameters":[{"schema":{"type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","allOf":[{"type":"object","required":["recordId","sourceName","sourceRecordKey","sourceRecordType","recordFamily","snapshotDate","snapshotMonth","fingerprint","duplicateOrdinal","extractDate","extractKind","accessTier","publicDisplayFlag","isRedacted","attachmentUrlPresent","uei","cageCode","legalBusinessName","recordDate","procurementId","federalAssistanceId","referenceIdvPiid","primaryNaicsCode","pscCode","title","agency","disposition","proceedingType","proceedingState","terminationType","terminationDate","statusActive","ingestedAt"],"properties":{"recordId":{"description":"Opaque identifier for this integrity row. Treat as a bytestring, not a UUID.","type":"string"},"sourceName":{"type":"string"},"sourceRecordKey":{"type":"string"},"sourceRecordType":{"type":"string"},"recordFamily":{"anyOf":[{"type":"string"},{"type":"null"}]},"snapshotDate":{"format":"date","type":"string"},"snapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]},"fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}]},"duplicateOrdinal":{"anyOf":[{"type":"number"},{"type":"null"}]},"extractDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"extractKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"accessTier":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicDisplayFlag":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isRedacted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"attachmentUrlPresent":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"uei":{"anyOf":[{"type":"string"},{"type":"null"}]},"cageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalBusinessName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recordDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"procurementId":{"anyOf":[{"type":"string"},{"type":"null"}]},"federalAssistanceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"referenceIdvPiid":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryNaicsCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"agency":{"anyOf":[{"type":"string"},{"type":"null"}]},"disposition":{"anyOf":[{"type":"string"},{"type":"null"}]},"proceedingType":{"anyOf":[{"type":"string"},{"type":"null"}]},"proceedingState":{"anyOf":[{"type":"string"},{"type":"null"}]},"terminationType":{"anyOf":[{"type":"string"},{"type":"null"}]},"terminationDate":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"statusActive":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"ingestedAt":{"format":"date-time","type":"string"}}},{"type":"object","required":["description","additionalComments","restrictedAccessMessage","attachmentUrl","physicalAddressLine1","physicalAddressLine2","physicalAddressLine3","physicalAddressLine4","physicalAddressCity","physicalAddressStateProvince","physicalAddressCountryCode","physicalAddressPostalCode","corporateRelationshipCageCode","corporateRelationshipLegalName","subcontractorUei","subcontractorCageCode","subcontractorName","subcontractorDba","agencyId","officialName","officialPhone","officialEmail","instrumentType","pocName","pocCity","pocStateProvince","pocCountryCode"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"additionalComments":{"anyOf":[{"type":"string"},{"type":"null"}]},"restrictedAccessMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachmentUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressLine1":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressLine2":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressLine3":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressLine4":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressStateProvince":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"physicalAddressPostalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporateRelationshipCageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporateRelationshipLegalName":{"anyOf":[{"type":"string"},{"type":"null"}]},"subcontractorUei":{"anyOf":[{"type":"string"},{"type":"null"}]},"subcontractorCageCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"subcontractorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"subcontractorDba":{"anyOf":[{"type":"string"},{"type":"null"}]},"agencyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialName":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialPhone":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"instrumentType":{"anyOf":[{"type":"string"},{"type":"null"}]},"pocName":{"anyOf":[{"type":"string"},{"type":"null"}]},"pocCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"pocStateProvince":{"anyOf":[{"type":"string"},{"type":"null"}]},"pocCountryCode":{"anyOf":[{"type":"string"},{"type":"null"}]}}}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/notices":{"get":{"operationId":"listNotices","summary":"List notices","tags":["public","notices"],"description":"Returns source-record-level notice rows.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"anyOf":[{"type":"string","enum":["sam_current"]},{"type":"string","enum":["sam_archive"]},{"type":"string","enum":["dibbs"]}]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["recordId","sourceName","noticeId","solicitationNumber","title","agencyName","postedAt","closeAt","opportunityStatus","category","pscCode","noticeType","active","archiveDate","amountFloor","amountCeiling","canonicalUrl","updatedAt","buyerName","purchaseRequestNumber","quantity","returnByLabel","setAsideLabel","itemLabel","naicsCodes","officePathSegments","placeOfPerformance","descriptionPreview","hasPackagePage","hasPdf","hasExtractedText","hasTechnicalDocuments","attachmentCount"],"properties":{"recordId":{"format":"uuid","type":"string"},"sourceName":{"type":"string"},"noticeId":{"type":"string"},"solicitationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"agencyName":{"type":"string"},"postedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"closeAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"opportunityStatus":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"archiveDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"amountFloor":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountCeiling":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonicalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"format":"date-time","type":"string"},"buyerName":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaseRequestNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"returnByLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"itemLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCodes":{"type":"array","items":{"type":"string"}},"officePathSegments":{"type":"array","items":{"type":"string"}},"placeOfPerformance":{"anyOf":[{"type":"string"},{"type":"null"}]},"descriptionPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasPackagePage":{"type":"boolean"},"hasPdf":{"type":"boolean"},"hasExtractedText":{"type":"boolean"},"hasTechnicalDocuments":{"type":"boolean"},"attachmentCount":{"type":"number"}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/notices/{recordId}":{"get":{"operationId":"getNotice","summary":"Get notice detail","tags":["public","notices"],"description":"Returns source-record-level notice detail.","parameters":[{"schema":{"format":"uuid","type":"string"},"in":"path","name":"recordId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["recordId","sourceName","noticeId","solicitationNumber","title","agencyName","postedAt","closeAt","opportunityStatus","category","pscCode","noticeType","active","archiveDate","amountFloor","amountCeiling","canonicalUrl","updatedAt","buyerName","purchaseRequestNumber","quantity","returnByLabel","setAsideLabel","itemLabel","naicsCodes","officePathSegments","placeOfPerformance","descriptionPreview","hasPackagePage","hasPdf","hasExtractedText","hasTechnicalDocuments","attachmentCount","normalized","snapshots","rawCaptures","events"],"properties":{"recordId":{"format":"uuid","type":"string"},"sourceName":{"type":"string"},"noticeId":{"type":"string"},"solicitationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"agencyName":{"type":"string"},"postedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"closeAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"opportunityStatus":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"pscCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"archiveDate":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"amountFloor":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountCeiling":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonicalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"format":"date-time","type":"string"},"buyerName":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaseRequestNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"returnByLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"setAsideLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"itemLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"naicsCodes":{"type":"array","items":{"type":"string"}},"officePathSegments":{"type":"array","items":{"type":"string"}},"placeOfPerformance":{"anyOf":[{"type":"string"},{"type":"null"}]},"descriptionPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasPackagePage":{"type":"boolean"},"hasPdf":{"type":"boolean"},"hasExtractedText":{"type":"boolean"},"hasTechnicalDocuments":{"type":"boolean"},"attachmentCount":{"type":"number"},"normalized":{"type":"object","additionalProperties":{}},"snapshots":{"type":"array","items":{"type":"object","required":["snapshotId","captureId","observedAt","versionHash"],"properties":{"snapshotId":{"format":"uuid","type":"string"},"captureId":{"format":"uuid","type":"string"},"observedAt":{"format":"date-time","type":"string"},"versionHash":{"type":"string"}}}},"rawCaptures":{"type":"array","items":{"type":"object","required":["captureId","capturedAt","requestKey","sourceUrl","payloadFormat","storageUri"],"properties":{"captureId":{"format":"uuid","type":"string"},"capturedAt":{"format":"date-time","type":"string"},"requestKey":{"type":"string"},"sourceUrl":{"type":"string"},"payloadFormat":{"type":"string"},"storageUri":{"type":"string"}}}},"events":{"type":"array","items":{"type":"object","required":["eventId","recordId","eventClass","eventType","detectedAt","actionable","reasonSummary","noticeId","title"],"properties":{"eventId":{"format":"uuid","type":"string"},"recordId":{"format":"uuid","type":"string"},"eventClass":{"type":"string"},"eventType":{"type":"string"},"detectedAt":{"format":"date-time","type":"string"},"actionable":{"type":"boolean"},"reasonSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/changes":{"get":{"operationId":"listChanges","summary":"List changes","tags":["public","changes"],"description":"Returns a recent change feed for opportunities and documents.","parameters":[{"schema":{"type":"string"},"example":"25","in":"query","name":"limit","required":false,"description":"Maximum number of items to return."},{"schema":{"format":"date-time","type":"string"},"in":"query","name":"updatedSince","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by the previous page."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"type":"object","required":["eventId","recordId","noticeId","title","changeType","eventClass","changedAt","actionable","reasonSummary"],"properties":{"eventId":{"format":"uuid","type":"string"},"recordId":{"format":"uuid","type":"string"},"noticeId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeType":{"type":"string"},"eventClass":{"type":"string"},"changedAt":{"format":"date-time","type":"string"},"actionable":{"type":"boolean"},"reasonSummary":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"page":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}},"servers":[{"url":"https://api.strata.example.com/v1","description":"Production"},{"url":"https://sandbox-api.strata.example.com/v1","description":"Sandbox"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"public","description":"Public API surface"},{"name":"opportunities","description":"Canonical opportunity threads"},{"name":"notices","description":"Source-record level notices"},{"name":"changes","description":"Incremental change feed"},{"name":"analysis","description":"Opportunity analysis and rollups"},{"name":"documents","description":"Document metadata and extracted text"}]}