---
title: "US federal contract actions by listed parent"
method: GET
path: "/api/markets/federal-contracts"
tags: ["Companies"]
---

# US federal contract actions by listed parent

`GET /api/markets/federal-contracts`

## Request

- Base URL: `https://xoomar.com`
- URL: `https://xoomar.com/api/markets/federal-contracts`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Docs: https://xoomar.com/markets/api/federal-contracts

## Query parameters

- `ticker` string
- `days` integer
- `by` 'ticker'
- `listed` '1'

## Response `200`

OK

- object
  - `data` object[]
    - `actionDate` string: Date the action was signed
    - `awardId` string: Contract or order number (PIID)
    - `mod` string, nullable: Modification number; 0 or null is the original award
    - `actionType` string, nullable: FPDS action type code
    - `amountUsd` number: Dollars obligated by this action; negative for de-obligations
    - `recipientName` string: Recipient legal name as registered
    - `ticker` string, nullable: Ticker of the recipient's listed parent; null when private or not matched
    - `awardingAgency` string, nullable: Awarding department and bureau
    - `awardingSubAgency` string, nullable: Awarding department and bureau
    - `awardType` string, nullable: Definitive contract, delivery order, BPA call, purchase order
    - `naicsCode` string, nullable: Industry code of the work
    - `description` string, nullable: Agency's description of the action, up to 1,000 characters
    - `generatedId` string, nullable: USAspending award id; https://www.usaspending.gov/award/{generatedId}
    - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `updatedAt` string, date-time: When the response was built; a few dated feeds give the date of their newest row instead
  - `source` 'xoomar.com'
  - `docs` string
  - `license` string: Data terms
  - `attribution` string
  - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `meta` object: Who publishes the data and how to credit it
    - `source` string: The publisher or publishers of the data, comma-separated
    - `sourceAttribution` string: The credit line to show wherever the data is displayed
    - `notice` string: Requests without a key only: the free key, app registration and the credit

## Other responses

- `404`: Unknown slug, ticker or country
- `429`: Rate limit: 10 requests a minute without a key, 30 with a free key

---

[API](https://skmtc.dev/xoomar/apis/xoomar-market-data-api.md) · [All operations](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/revisions/07b78401eaaa?raw)