---
title: "Foreign Agents (FARA)"
method: GET
path: "/api/v2/gov/fara"
tags: ["Government"]
---

# Foreign Agents (FARA)

`GET /api/v2/gov/fara`

US foreign-influence graph — DOJ FARA registrations linking a US registrant (law/lobby/PR firm) to the foreign principal it represents, resolved to the entity spine. Filter by a resolved `entity` (matches EITHER side of the link), a fuzzy `registrant` or `foreign_principal` name, or a `country`; `adversary_only` restricts to adversary governments and `sanctioned_only` to the killer cross — US firms registered as agents for a **sanctioned** entity (the foreign principal is matched to our screening lists — OFAC SDN / BIS Entity / DoD 1260H / OFAC CMIC / UK — with the specific `fp_sanction_lists` + `fp_sanction_programs`). At least one filter is required. Plan-gated: requires `can_use_gov` (Markets plan and up); non-entitled plans receive 403 PLAN_REQUIRED. US Public Domain (DOJ NSD FARA eFile).

## Query parameters

- `entity` string
- `registrant` string
- `foreign_principal` string
- `country` string
- `adversary_only` boolean
- `sanctioned_only` boolean
- `active_only` boolean
- `limit` integer

## Response `200`

Success

- GovFaraResponse — US foreign-influence links (FARA) — US registrants ↔ foreign principals, resolved to the entity spine and crossed with our screening lists.
  - `query` object
    - `entity` string, nullable
    - `registrant` string, nullable
    - `foreign_principal` string, nullable
    - `country` string, nullable
    - `adversary_only` boolean
    - `sanctioned_only` boolean
    - `active_only` boolean
    - `limit` integer
  - `summary` object
    - `links` integer
    - `registrants` integer
    - `foreign_principals` integer
    - `countries` integer
    - `adversary_links` integer
    - `sanctioned_links` integer
    - `active_links` integer
  - `links` object[]
    - `registration_number` string
    - `registrant_name` string
    - `registrant_entity_id` string — Resolved spine id of the US registrant; empty when unresolved.
    - `foreign_principal` string
    - `foreign_principal_entity_id` string — Resolved spine id of the foreign principal; empty when unresolved.
    - `country` string
    - `country_adversary` integer — 1 if the country is in the adversary set.
    - `fp_sanctioned` integer — 1 if the foreign principal is on a sanctions/restricted list.
    - `fp_sanction_lists` string[] — Screening list source_keys matched (csl_ofac_sdn / csl_bis_entity / dod_1260h / …).
    - `fp_sanction_programs` string[] — Sanction programs (RUSSIA-EO14024 / CMIC-EO13959 / 1260H / …).
    - `fp_registration_date` string — Foreign-principal registration date; empty when unknown.
    - `fp_termination_date` string — Termination date; empty when still active.
    - `is_active` integer — 1 if the registration is still active.
    - `source_url` string — FARA registrant permalink.
  - `meta` object
    - `source` string
    - `attributions` object[]
      - `source` string
      - `source_url` string
      - `license` string
      - `note` string
    - `note` string, nullable
  - `cross_source` GovCrossSource — Cross-source fusion for the primary resolved entity — its footprint beyond this endpoint (foreign-agent status, SEC filer, facilities owned) + headline flags. Null when there is no cross-source signal.
    - `entity_id` string
    - `federal_awards` object, nullable
      - `awards` integer
      - `total_obligated` number
    - `foreign_agent` object, nullable — This entity AS a US registrant (foreign agent).
      - `registrations` integer
      - `foreign_principals` integer
      - `sanctioned_principals` integer — Foreign principals it represents that are on a sanctions list.
      - `countries` string[]
    - `foreign_principal_of` object, nullable — This entity AS a foreign principal — the US firms registered to represent it.
      - `us_registrants` integer
    - `sec_filer` boolean
    - `facilities_owned` integer
    - `flags` string[] — Headline cross-flags: federal_contractor_and_foreign_agent, foreign_agent_for_sanctioned_entity.

## Other responses

- `400` — Missing filter — need one of entity / registrant / foreign_principal / country / adversary_only / sanctioned_only.
- `401` — API key required. Include: Authorization: Bearer gdelt_sk_...
- `403` — The caller's plan does not carry the can_use_gov entitlement (Markets plan and up).
- `429` — Rate limit or quota exceeded.
- `500` — Failed to fetch FARA links.

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)