> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altss.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Federal contracting history

> Quarterly net obligations and total for prime federal contracts for the exact recipient.

Quarterly net obligations and total for prime federal contracts for the exact recipient.

**Operation ID:** `procurement.entity_contracting_history`. **Family:** [Government & Procurement](https://docs.altss.com/console/families/government-procurement.md).

[Read the live operation contract (JSON)](https://console.altss.com/v1/console/capabilities/procurement.entity_contracting_history) for the current input and output schemas, price, limits and required scopes.

**Status:** Available (`AVAILABLE`). **Supported interfaces:** REST, MCP.

**Commercial status:** Available. Receive the structured result and receipt in Console after the run settles.

**Execution interfaces:** UI, REST, MCP.

## When to use it

Compare quarterly federal prime contract obligations for an exact recipient. Negative values reflect net deobligations.

## Price and billing unit

Request a quote for one federal contracting history. Review its inputs, delivery plan, use terms and maximum charge before accepting. Retrying the same purchase uses the same idempotency key.

**Price:** \$1. **Billing unit:** per successful delivery.

**Charge condition:** The authorized execution delivers a validated result and settles once. Failed pre-settlement executions are not charged; reservation release must be confirmed. Retrieve the same run if charge state is uncertain.

**Execution budget:** Maximum \$1 per accepted execution.

Fund your Console wallet, review the quote and approve the charge before execution.

## Inputs

USAspending recipient ID and fiscal year

```json theme={null}
{
  "type": "object",
  "properties": {
    "recipientId": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-[CPR]$"
    },
    "fiscalYear": {
      "type": "integer",
      "minimum": 2008,
      "maximum": 2100
    }
  },
  "required": [
    "recipientId",
    "fiscalYear"
  ],
  "additionalProperties": false
}
```

## Result and output schema

Quarterly net obligations and total for prime federal contracts for the exact recipient.

```json theme={null}
{
  "$ref": "https://console.altss.com/openapi.json#/components/schemas/Result_procurement_entity_contracting_history"
}
```

## Examples

Illustrative request and result for this scope. The names, values and record references are examples. Actual delivery depends on the published availability and agreed scope.

### Example input

```json theme={null}
{
  "recipientId": "22d282c6-4508-7d30-97f1-7401ea73b12a-C",
  "fiscalYear": 2025
}
```

### Example structured output

```json theme={null}
{
  "kind": "FEDERAL_CONTRACTING_HISTORY",
  "quarters": [
    {
      "quarter": 1,
      "netContractObligationsUsd": 2981675774.11
    },
    {
      "quarter": 2,
      "netContractObligationsUsd": 510653679.53
    },
    {
      "quarter": 3,
      "netContractObligationsUsd": 489096619.08
    },
    {
      "quarter": 4,
      "netContractObligationsUsd": 392122530.62
    }
  ],
  "netContractObligationsUsd": 4373548603.34
}
```

## API example and execution

[Verified production contract](https://console.altss.com/openapi.json) · Base URL: `https://console.altss.com/v1/console`. Quote first. Obtain explicit approval of the price, plan and use terms before sending accept:true. Reuse the same purchase idempotency key on retries.

Required scope: `company.read`. Organization authority, funding checks and spending limits apply to paid execution.

Supply credentials in the documented authorization header. Replace a placeholder run ID with an actual authorized run ID.

```json theme={null}
{
  "method": "POST",
  "url": "https://console.altss.com/v1/console/quote",
  "body": {
    "toolId": "procurement.entity_contracting_history",
    "input": {
      "recipientId": "22d282c6-4508-7d30-97f1-7401ea73b12a-C",
      "fiscalYear": 2025
    }
  }
}
```

This example requests a quote. A paid run requires the unchanged returned quote, explicit acceptance and a stable idempotency key.

## MCP and A2A

**Supported interfaces:** REST, MCP. Current MCP tools: `altss_quote`, `altss_run`, `altss_get_run`. Inspect tools/list and inputSchema before use. Paid A2A execution is unavailable. The separate anonymous A2A reader serves public information.

[REST guide](https://docs.altss.com/console/rest.md) · [MCP guide](https://docs.altss.com/console/mcp.md) · [A2A scope](https://docs.altss.com/console/a2a.md) · [Authentication and credentials](https://docs.altss.com/console/authentication.md)

## Sources, evidence and freshness

* Public records and official sources
* Altss intelligence and source collections

Retain source attribution, observation and event dates, evidence and explicit unknowns where supplied. A record update is not independent verification.

Historical source collection dates describe when the material was observed. Coverage and freshness depend on each returned source. Preserve its observation date and use restrictions with the result.

## Limits and permitted use

* Includes: Retrieve quarterly prime contract obligations for one exact recipient and fiscal year. Negative obligations include deobligations.; USAspending source and observation date. Excludes: Personal contact information; Subaward-level transactions. Requires scope company.read. Source: public registry.
* A timeout does not establish the final charge. Retrieve the existing run before retrying.

Use is limited by the accepted quote or agreed delivery scope, source restrictions and privacy controls. Storage, attribution, retention, redistribution and training permissions do not expand through normalization.

## Next step

[Try Console](https://console.altss.com/signup?src=buyer-intent\&cta=capability\&capability=procurement.entity_contracting_history) · [Open Console workspace](https://console.altss.com/console/playground/new?capability=procurement.entity_contracting_history) · [View the capability on Altss](https://altss.com/console/capabilities/procurement.entity_contracting_history) · [Wallet and billing](https://docs.altss.com/console/billing.md)

[Back to Government & Procurement](https://docs.altss.com/console/families/government-procurement.md) · [All capabilities](https://docs.altss.com/console/capabilities.md) · [Price schedule](https://docs.altss.com/console/prices.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.