Primes that paid a sub

Sub-side reverse lookup: "what primes have paid this UEI as a sub-vendor?" Indexed on subawardee_uei. Same row shape as /subawards/search plus a summary block with a top-10 paying-primes leaderboard.

Parameters

uei (path), 12-character UEI of the sub-vendor. Normalized.
sort_by / sort_order: same as /companies/{uei}/subawards.
date_from / date_to: YYYY-MM-DD. date_from window-clamped.
limit: Results per page. Default 100; maximum 100 on the free trial and 1,000 on paid plans. Over the maximum returns 402.
offset: ≥ 0 (default 0).
fields: Comma-separated projection.

Response

{
  "uei": "XX2WFHJEFB45",
  "summary": {
    "sub_name": "KAMPI COMPONENTS CO INC",
    "total_received": 6420000.00,
    "distinct_primes": 7,
    "top_primes": [
      {"prime_uei": "H11HD5VHGHN3", "prime_name": "LOCKHEED MARTIN CORPORATION",
       "subaward_count": 12, "total": 3200000.00}
    ],
    "first_subaward_date": "2021-08-12",
    "last_subaward_date": "2026-05-12"
  },
  "data": [ /* same 30-field rows */ ],
  "pagination": { "limit": 50, "offset": 0, "total": 31, "total_is_estimate": false, "has_next": false },
  "filters_applied": { "sort_by": "subaward_action_date", "sort_order": "desc", "date_from": "2024-10-01" },
  "window": { "plan_window_days": 1825, "earliest_searchable": "2024-10-01", "clamped": false }
}

For most SMBs, this is the better revenue picture than /companies/{uei}/awards, sub revenue is often the larger half of federal income, and prime-only data systematically undercounts it.

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://govconapi.com/api/v1/companies/XX2WFHJEFB45/prime-relationships?limit=50"

Errors (both reverse-lookup endpoints): 401 (auth), 422 (bad UEI / out-of-range param), 429 (rate limit). 404 is not returned on "no records", empty data with zero summary is.