# SAM.gov Entity Exclusions Scraper (`automation-lab/sam-gov-entity-exclusions-scraper`) Actor

Extract public SAM.gov exclusion records for vendor screening, debarment monitoring, and procurement compliance workflows.

- **URL**: https://apify.com/automation-lab/sam-gov-entity-exclusions-scraper.md
- **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## SAM.gov Entity Exclusions Scraper

### What does SAM.gov Entity Exclusions Scraper do?

SAM.gov Entity Exclusions Scraper extracts public exclusion records from SAM.gov and turns them into structured rows. Use it to screen vendors, subcontractors, grant recipients, or business partners for active and historical exclusion records. The actor reads the public SAM.gov search API and saves normalized fields such as entity name, UEI, CAGE code, program, type, excluding agency, status, dates, address, and source URLs.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Who is it for?

Procurement teams can check suppliers before award. Government contractors can screen subcontractors before bid submission. Compliance teams can monitor excluded parties. Vendor-risk teams can enrich onboarding workflows. Data providers can add SAM.gov exclusion status to business datasets.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Why use it?

The SAM.gov website is useful for manual searches, but repeatable screening requires structured output. This actor gives you API-ready JSON, CSV, Excel, or dataset exports that can be scheduled, monitored, and integrated with risk systems.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### What data can you extract?

Each dataset item represents one SAM.gov exclusion record. Fields include identifiers, exclusion status, exclusion program, exclusion type, excluding agency, activation date, termination date, address, SAM source URL, API URL, scrape timestamp, and optional raw metadata.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### How much does it cost to scrape SAM.gov exclusions?

The actor uses pay-per-event pricing. There is a small start fee and a per-record charge for each exclusion record saved. Exact live prices are shown on the Apify Store before you run the actor.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### How to scrape SAM.gov exclusions

Enter a keyword, UEI, CAGE code, or entity name, choose active, inactive, or all records, set the maximum number of records, and run the actor. Results appear in the default dataset.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Input options

Use query for entity search. Use activeStatus for active, inactive, or all records. Optional arrays let you keep only selected agencies, programs, types, countries, or US states. maxItems controls cost and output size.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Output fields

Important output fields are entityName, uei, cageCode, samNumber, isActive, exclusionProgram, exclusionType, excludingAgency, activationDate, terminationDate, address fields, samSearchUrl, sourceApiUrl, scrapedAt, and optional raw.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Example input

```json
{
  "query": "DYNAMIC MINDS",
  "activeStatus": "active",
  "maxItems": 100,
  "pageSize": 100
}
````

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Example output

```json
{
  "entityName": "DYNAMIC MINDS FAMILY SERVICES",
  "uei": "MGS1EPM43F23",
  "isActive": true,
  "exclusionProgram": "Reciprocal",
  "excludingAgency": "OPM",
  "addressState": "NV"
}
```

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Tips for reliable results

Start with active exclusions and a small maxItems value. Use a keyword or identifier when you need a targeted entity check. Use includeRaw only when your audit workflow needs the original SAM.gov metadata.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Integrations

Schedule the actor daily to monitor active exclusions. Export datasets to Google Sheets, S3, webhooks, or your vendor master database. Trigger it from procurement onboarding when a new supplier is created.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### API usage with Node.js

```js
import { ApifyClient } from "apify-client";
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor("automation-lab/sam-gov-entity-exclusions-scraper").call({ query: "DYNAMIC MINDS", activeStatus: "active", maxItems: 100 });
console.log(run.defaultDatasetId);
```

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### API usage with Python

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("automation-lab/sam-gov-entity-exclusions-scraper").call(run_input={"query":"DYNAMIC MINDS","activeStatus":"active","maxItems":100})
print(run["defaultDatasetId"])
```

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### API usage with cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/automation-lab~sam-gov-entity-exclusions-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"DYNAMIC MINDS","activeStatus":"active","maxItems":100}'
```

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### MCP integration

Use this actor from Claude Code or Claude Desktop through the Apify MCP server.

Add it in Claude Code:

```bash
claude mcp add apify-sam-exclusions https://mcp.apify.com/?tools=automation-lab/sam-gov-entity-exclusions-scraper
```

Claude Desktop JSON config:

```json
{
  "mcpServers": {
    "apify-sam-exclusions": {
      "url": "https://mcp.apify.com/?tools=automation-lab/sam-gov-entity-exclusions-scraper"
    }
  }
}
```

Example prompts:

- “Check this vendor against active SAM.gov exclusions and summarize the risk evidence.”

- “Run a SAM.gov exclusions scraper search for this UEI and return the agency, dates, and source URL.”

- “Create a vendor-risk watchlist export for active USA exclusions.”

- ✅ Structured SAM.gov exclusion records

- ✅ Active, inactive, or all-status workflows

- ✅ Compliance-friendly identifiers and source URLs

### Legality and responsible use

SAM.gov exclusion records are public government data. You are responsible for using results lawfully, respecting internal compliance policies, and verifying critical decisions against official SAM.gov records when needed.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Related scrapers

Related Automation Lab actors include `https://apify.com/automation-lab/samgov-government-contracts-scraper`, `https://apify.com/automation-lab/ofac-sanctions-list-export-scraper`, and other procurement or sanctions data actors.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### FAQ

Can I scrape inactive exclusions? Yes, set activeStatus to inactive or all. Can I filter by agency? Yes, use agencies such as OPM; filtering is applied to returned records. Why are some fields empty? SAM.gov records vary and not every entity has a CAGE code, termination date, or full address.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Troubleshooting

If you receive fewer records than expected, remove optional filters or increase maxItems. If a targeted entity is missing, try searching by UEI, CAGE code, or a shorter name keyword.

- ✅ Structured SAM.gov exclusion records
- ✅ Active, inactive, or all-status workflows
- ✅ Compliance-friendly identifiers and source URLs

### Field reference

- `recordId` — exported when available from SAM.gov or derived by the actor.
- `entityName` — exported when available from SAM.gov or derived by the actor.
- `uei` — exported when available from SAM.gov or derived by the actor.
- `cageCode` — exported when available from SAM.gov or derived by the actor.
- `samNumber` — exported when available from SAM.gov or derived by the actor.
- `isActive` — exported when available from SAM.gov or derived by the actor.
- `exclusionProgram` — exported when available from SAM.gov or derived by the actor.
- `exclusionType` — exported when available from SAM.gov or derived by the actor.
- `typeCode` — exported when available from SAM.gov or derived by the actor.
- `excludingAgency` — exported when available from SAM.gov or derived by the actor.
- `excludingAgencyDescription` — exported when available from SAM.gov or derived by the actor.
- `classification` — exported when available from SAM.gov or derived by the actor.
- `activationDate` — exported when available from SAM.gov or derived by the actor.
- `terminationDate` — exported when available from SAM.gov or derived by the actor.
- `addressStreet` — exported when available from SAM.gov or derived by the actor.
- `addressCity` — exported when available from SAM.gov or derived by the actor.
- `addressState` — exported when available from SAM.gov or derived by the actor.
- `addressZip` — exported when available from SAM.gov or derived by the actor.
- `addressCountry` — exported when available from SAM.gov or derived by the actor.
- `samSearchUrl` — exported when available from SAM.gov or derived by the actor.
- `sourceApiUrl` — exported when available from SAM.gov or derived by the actor.
- `scrapedAt` — exported when available from SAM.gov or derived by the actor.
- `raw` — exported when available from SAM.gov or derived by the actor.

### Workflow ideas

- Workflow 1: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 2: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 3: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 4: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 5: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 6: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 7: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 8: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 9: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 10: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 11: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 12: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 13: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 14: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 15: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 16: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 17: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 18: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 19: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 20: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 21: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 22: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 23: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 24: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 25: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 26: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 27: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 28: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 29: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 30: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 31: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 32: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 33: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 34: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 35: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 36: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 37: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 38: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 39: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.
- Workflow 40: run targeted SAM.gov exclusion screening, export the dataset, and attach the source URL to your compliance record.

# Actor input Schema

## `query` (type: `string`):

Optional SAM.gov search keyword, UEI, CAGE code, or entity name.

## `activeStatus` (type: `string`):

Choose active exclusions, inactive exclusions, or all records. Active is the default compliance-screening workflow.

## `agencies` (type: `array`):

Optional agency names or abbreviations to keep, for example OPM or Department of Justice. Filtering is applied to returned SAM.gov records.

## `exclusionPrograms` (type: `array`):

Optional exact exclusion program values to keep, for example Reciprocal.

## `exclusionTypes` (type: `array`):

Optional exclusion type keywords to keep, for example Prohibition or Restriction.

## `countries` (type: `array`):

Optional country codes to keep, for example USA or CAN.

## `states` (type: `array`):

Optional state abbreviations to keep, for example NV or CA.

## `maxItems` (type: `integer`):

Maximum number of dataset records to save.

## `pageSize` (type: `integer`):

SAM.gov API page size. Keep 100 for efficient production runs.

## `includeRaw` (type: `boolean`):

Attach the original API record for audit/debug workflows. This increases dataset size.

## Actor input object example

```json
{
  "query": "DYNAMIC MINDS",
  "activeStatus": "active",
  "agencies": [],
  "exclusionPrograms": [],
  "exclusionTypes": [],
  "countries": [],
  "states": [],
  "maxItems": 20,
  "pageSize": 100,
  "includeRaw": false
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "DYNAMIC MINDS",
    "activeStatus": "active",
    "agencies": [],
    "exclusionPrograms": [],
    "exclusionTypes": [],
    "countries": [],
    "states": [],
    "maxItems": 20,
    "pageSize": 100,
    "includeRaw": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("automation-lab/sam-gov-entity-exclusions-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "DYNAMIC MINDS",
    "activeStatus": "active",
    "agencies": [],
    "exclusionPrograms": [],
    "exclusionTypes": [],
    "countries": [],
    "states": [],
    "maxItems": 20,
    "pageSize": 100,
    "includeRaw": False,
}

# Run the Actor and wait for it to finish
run = client.actor("automation-lab/sam-gov-entity-exclusions-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "DYNAMIC MINDS",
  "activeStatus": "active",
  "agencies": [],
  "exclusionPrograms": [],
  "exclusionTypes": [],
  "countries": [],
  "states": [],
  "maxItems": 20,
  "pageSize": 100,
  "includeRaw": false
}' |
apify call automation-lab/sam-gov-entity-exclusions-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=automation-lab/sam-gov-entity-exclusions-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "SAM.gov Entity Exclusions Scraper",
        "description": "Extract public SAM.gov exclusion records for vendor screening, debarment monitoring, and procurement compliance workflows.",
        "version": "0.1",
        "x-build-id": "2ruc2o1bgfSU5eyxh"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/automation-lab~sam-gov-entity-exclusions-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-automation-lab-sam-gov-entity-exclusions-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/automation-lab~sam-gov-entity-exclusions-scraper/runs": {
            "post": {
                "operationId": "runs-sync-automation-lab-sam-gov-entity-exclusions-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/automation-lab~sam-gov-entity-exclusions-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-automation-lab-sam-gov-entity-exclusions-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "title": "Keyword or entity name",
                        "type": "string",
                        "description": "Optional SAM.gov search keyword, UEI, CAGE code, or entity name."
                    },
                    "activeStatus": {
                        "title": "Exclusion status",
                        "enum": [
                            "active",
                            "inactive",
                            "all"
                        ],
                        "type": "string",
                        "description": "Choose active exclusions, inactive exclusions, or all records. Active is the default compliance-screening workflow.",
                        "default": "active"
                    },
                    "agencies": {
                        "title": "Excluding agencies",
                        "type": "array",
                        "description": "Optional agency names or abbreviations to keep, for example OPM or Department of Justice. Filtering is applied to returned SAM.gov records.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "exclusionPrograms": {
                        "title": "Exclusion programs",
                        "type": "array",
                        "description": "Optional exact exclusion program values to keep, for example Reciprocal.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "exclusionTypes": {
                        "title": "Exclusion types",
                        "type": "array",
                        "description": "Optional exclusion type keywords to keep, for example Prohibition or Restriction.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "countries": {
                        "title": "Countries",
                        "type": "array",
                        "description": "Optional country codes to keep, for example USA or CAN.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "states": {
                        "title": "US states",
                        "type": "array",
                        "description": "Optional state abbreviations to keep, for example NV or CA.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxItems": {
                        "title": "Maximum exclusion records",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of dataset records to save.",
                        "default": 20
                    },
                    "pageSize": {
                        "title": "Page size",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "SAM.gov API page size. Keep 100 for efficient production runs.",
                        "default": 100
                    },
                    "includeRaw": {
                        "title": "Include raw SAM.gov metadata",
                        "type": "boolean",
                        "description": "Attach the original API record for audit/debug workflows. This increases dataset size.",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```