> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.defdex.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.defdex.io/_mcp/server.

# Entities

`GET /api/v1/entities/{id}` returns everything DefDex holds about one entity. Use an id from
[search](/search). It costs 1 credit.

```bash
curl 'https://app.defdex.io/api/v1/entities/org:anduril-industries' \
  --header "Authorization: Bearer $DEFDEX_API_KEY"
```

Use `include` to return only some sections, for example `?include=obligations,top_awards`.
`id`, `type`, `name` and `url` are always returned.

## Example document

Abbreviated. Fields and sections vary by entity type.

```json
{
  "data": {
    "id": "org:anduril-industries",
    "type": "company",
    "name": "Anduril Industries",
    "summary": "…",
    "url": "https://defdex.io/organizations/anduril-industries",
    "website": "https://www.anduril.com",
    "founded_year": 2017,
    "location": { "city": "Costa Mesa", "country": "US" },
    "identifiers": { "uei": ["…"], "cage": ["…"], "cik": [] },
    "obligations": {
      "label": "obligated",
      "total_usd": 0,
      "announced_ceiling_usd": 0,
      "by_fiscal_year": [{ "fiscal_year": 2024, "usd": 0 }],
      "top_agencies": { "total": 0, "items": [] }
    },
    "top_awards": {
      "total": 0,
      "items": [{ "id": "CONT_AWD_…", "title": "…", "obligated_usd": 0, "announced_ceiling_usd": 0 }]
    },
    "awards_list_url": "https://app.defdex.io/api/v1/awards?recipient=anduril-industries",
    "programs": { "total": 0, "items": [] },
    "subsidiaries": { "total": 0, "items": [] },
    "news": { "total": 0, "items": [] }
  },
  "build_id": "…"
}
```

The zeros are placeholders. Real documents carry real figures.

## Lists

Every list in a document is `{ "total": N, "items": [...] }` and holds at most 10 items
(25 for sources, budget lines and technology organizations). `total` is the full count. For the full
lists, use the filtered endpoints: `awards_list_url`, [`/awards`](/awards), [`/jobs`](/jobs) and
[`/search`](/search) with `parent` or `technology`.

## Sections by type

| Type                                  | Sections                                                                                                                                                                                                                                                                       |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `company`, `investor`, `research_lab` | profile, identifiers, parent and ultimate parent, `obligations`, `top_awards`, `subsidiaries`, `programs`, `technologies`, `systems`, `funding_rounds`, `portfolio` (investors), `people`, `suppliers`, `customers`, `facilities`, `trade_controls`, `jobs`, `news`, `sources` |
| `agency`, `office`                    | profile, identifiers, `ancestors`, `obligations` (top recipients and programs), `sub_organizations`, `top_awards`                                                                                                                                                              |
| `program`                             | profile, `codes`, `budget_lines`, `obligations`, `budget`, `contractors`, `participants`, `systems`, `milestones`, `top_awards`, `news`                                                                                                                                        |
| `technology`                          | profile, `domain`, `parent`, `children`, `organizations`, `systems`, `inputs`                                                                                                                                                                                                  |
| `system`                              | profile, `maker`, `program`, `operators`, `milestones`, `components`, `used_in`, `technologies`, `programs`, `budget`, `top_awards`                                                                                                                                            |

## Dollars

Every amount says what it is. `obligated_usd` is net federal obligations from USAspending and
can be negative or zero. `announced_ceiling_usd` is potential value, never spending. Budget
lines are labelled requested or enacted. Amounts are JSON numbers in US dollars. Do not add
figures that carry different labels.

Company totals roll up subsidiaries on exact UEIs and the parent reported on each action. See
[data quality](/data-quality).