Federal Spending Forensic API icon

Federal Spending Forensic API

Forensic federal spending intelligence - Uncover the $195B USASpending blind spot

Actions9

Forensic Audit

AI-generated

Summary

Execute forensic federal spending analysis with cross-referencing, return results enriched with run metadata, and control completion waiting behavior.

Inputs

  • agency — Filter results by federal agency. Select 'All Agencies' to include all agencies. Visible under operation: forensicAudit.
  • fiscalYear — Federal fiscal year (October 1 - September 30). Defaults to 2024. Valid range 2015-2026. Visible under operation: forensicAudit.
  • keywords — Search keywords (comma-separated). Example: 'cybersecurity, IT services'. Visible under operation: forensicAudit.
  • maxResults — Maximum number of results to return. Default 50. Range 1-500. Visible under operation: forensicAudit.
  • waitForCompletion — Whether to wait for the extraction to complete before returning results. Default true. When false, immediately returns a run ID for later status polling. Hidden under operation: getStatus.
  • advancedOptions — Advanced settings collection. Hidden under operations: getStatus, entityVerify. Visible under operation: forensicAudit.

Output shape

Array of items. Each item json contains the actor's result data fields plus three enriched properties: _operation (set to 'Forensic Audit'), _runId (the Apify actor run ID), and _datasetId (the dataset ID from the completed run).

If waitForCompletion is true, the node polls the actor run status every 5 seconds up to the configured timeout (default 300 seconds, adjustable via advancedOptions.timeout). On success (status SUCCEEDED), it fetches dataset items and returns each as a separate n8n item. On failure, it throws a NodeOperationError. If waitForCompletion is false, it immediately returns a single item with status 'RUNNING' and the run ID, allowing the workflow to use the 'Get Run Status' operation later.

Examples

Example 1: Run forensic audit for Department of Defense, fiscal year 2023, with forensic flags enabled, and wait for results.

agency: 'Department of Defense', fiscalYear: 2023, waitForCompletion: true, enableForensicFlags: true (default). The node starts the actor run, polls completion, and returns an array of items enriched with _operation, _runId, and _datasetId.

Example 2: Start a forensic audit run immediately without waiting, to be checked later.

waitForCompletion: false. The node returns a single item with success: true, status: 'RUNNING', runId, and datasetId. The workflow can subsequently use the 'Get Run Status' operation with the returned runId to check progress and fetch results.

Links

Discussion