{"uid":"cap_k6ssvY7qItFbPGP9efQQS","slug":"forgemesh-federal-recipient-lookup-bf43e98a","name":"ForgeMesh Federal Recipient Lookup","description":"Look up any company in official US federal spending records: returns matching recipient entities with unique entity identifiers (UEI), corporate parent/child structure, and recent total federal award dollars per entity. Structured JSON for vendor vetting and market-sizing agents.","url":"https://x402.forgemesh.io/federal-recipient-lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","maximum":20,"minimum":1},"company":{"type":"string","description":"company name, min 3 chars (required)"}}},"responseSchema":{"type":"json","example":{"query":{"company":"Lockheed"},"matched":287,"returned":3,"recipients":[{"uei":"ZFN2JJXBLZT3","name":"LOCKHEED MARTIN CORPORATION","profile_url":"https://www.usaspending.gov/recipient/b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P/latest","recipient_id":"b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P","recipient_level":"P","total_recent_amount_usd":40100000000}],"attribution":"USAspending.gov (public domain)"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ImXIyeWIbc0W0uY_I-3Re","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up companies in US federal spending records, returning recipient entities with UEI identifiers, corporate hierarchy, and total recent federal award amounts.","exampleAgentPrompt":"Search the US federal spending database for 'Raytheon' and return up to 5 matching recipient entities, including their UEI codes and total recent federal award amounts.","exampleUseCases":[{"title":"Vendor vetting for procurement team","prompt":"Can you check if 'Booz Allen Hamilton' is registered as a federal contractor? I need their UEI and how much they've received in recent federal awards."},{"title":"Market sizing a government contractor","prompt":"Look up 'Northrop Grumman' in US federal spending records and tell me their total recent federal award dollars so I can estimate their government revenue."},{"title":"Finding parent-child corporate structure","prompt":"Search USAspending for 'SAIC' and show me up to 10 matching recipient entities — I need to see the corporate parent and child relationships and their individual UEIs."}],"resultDescription":"Returns a JSON object with the original query, total number of matched recipients in the database, number returned, and an array of recipient objects — each containing the company name, UEI, recipient ID, recipient level (parent/child/independent), a direct USAspending.gov profile URL, and total recent federal award dollars. Includes data attribution to USAspending.gov.","failureModes":["Company name under 3 characters returns a validation error","No matching recipients found returns an empty array with matched=0","Limit exceeds 20 returns an error","Ambiguous company names may return many loosely-matched results requiring manual filtering","Network or upstream USAspending.gov API unavailability causes request failure","Payment failure (402) if USDC balance insufficient"],"whenToPreferThis":"Choose this endpoint when you need to resolve a company name to its official federal identifier (UEI), verify federal contractor status, retrieve government award totals for vendor due diligence or market sizing, or navigate parent/child corporate structures within federal procurement records. Prefer this over general web search when you need structured, authoritative data directly from the official USAspending.gov dataset.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:48:45.511Z","isFirstParty":false,"canonicalSlug":"forgemesh-federal-recipient-lookup-bf43e98a"}