{"contractVersion":"parcelops.connector.v1","name":"sam-gov","displayName":"SAM.gov Entities & Exclusions","description":"Public federal entity registrations, UEIs, CAGE codes, registration status, and active exclusions from SAM.gov. Searches preserve source identifiers and distinguish missing results from affirmative standing. A free SAM.gov API key is required.","tags":["entity-registration","uei","cage","debarment","exclusions","federal","compliance"],"authentication":{"type":"api_key","required":true},"provenance":{"sourceName":"SAM.gov Entity Management and Exclusions","sourceUrl":"https://sam.gov/entity-information","apiBaseUrl":"https://api.sam.gov/entity-information/v4","documentationUrl":"https://open.gsa.gov/api/entity-api/"},"freshness":{"status":"declared","value":{"mode":"live"}},"coverage":{"geographic":{"status":"declared","value":["United States"]},"temporal":{"status":"not_declared"}},"methods":{"total":4,"items":[{"name":"searchEntities","description":"Search public SAM registrations by legal name, UEI, or CAGE code.","notes":"At least one identity field is required.","inputSchema":{"type":"object","properties":{"legalBusinessName":{"type":"string","maxLength":200},"uei":{"type":"string","minLength":12,"maxLength":12},"cageCode":{"type":"string","minLength":5,"maxLength":5},"registrationStatus":{"type":"string","enum":["A","E"]},"state":{"type":"string","minLength":2,"maxLength":2},"page":{"type":"integer","minimum":0,"maximum":999}},"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live"},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Public API-key limits vary by account role.","A missing record does not prove that an entity does not exist.","Legacy D&B-supplied fields carry GSA-published attribution and permissible-use limits."]},{"name":"getEntity","description":"Retrieve an exact public SAM entity record by UEI.","requiredParams":["uei"],"inputSchema":{"type":"object","properties":{"uei":{"type":"string","minLength":12,"maxLength":12}},"required":["uei"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live"},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Public API-key limits vary by account role.","A missing record does not prove that an entity does not exist.","Legacy D&B-supplied fields carry GSA-published attribution and permissible-use limits."]},{"name":"searchExclusions","description":"Screen active SAM exclusions by name, UEI, or CAGE code.","notes":"Name hits are potential matches until identifiers agree.","inputSchema":{"type":"object","properties":{"exclusionName":{"type":"string","maxLength":200},"uei":{"type":"string","minLength":12,"maxLength":12},"cageCode":{"type":"string","minLength":5,"maxLength":5},"classification":{"type":"string","enum":["Individual","Firm","Vessel","Special Entity Designation"]},"state":{"type":"string","minLength":2,"maxLength":2},"country":{"type":"string","minLength":3,"maxLength":3},"page":{"type":"integer","minimum":0,"maximum":999},"limit":{"type":"integer","minimum":1,"maximum":10}},"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live"},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Public API-key limits vary by account role.","A missing record does not prove that an entity does not exist.","Legacy D&B-supplied fields carry GSA-published attribution and permissible-use limits."]},{"name":"getServiceInfo","description":"Describe SAM coverage, rate limits, methods, and caveats.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live"},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Public API-key limits vary by account role.","A missing record does not prove that an entity does not exist.","Legacy D&B-supplied fields carry GSA-published attribution and permissible-use limits."]}]},"caveats":["Public API-key limits vary by account role.","A missing record does not prove that an entity does not exist.","Legacy D&B-supplied fields carry GSA-published attribution and permissible-use limits."]}