{"uid":"cap_nUYuYR1Lyzav8o6fc2cOa","slug":"forgemesh-federal-contractor-profile-lookup-b277c2a2","name":"ForgeMesh Federal Contractor Profile Lookup","description":"Federal contractor profile lookup: resolve a company name to its official US government recipient records — legal name, UEI identifier, parent/child level, recent federal award totals, and a canonical profile link. The first step before pulling a company's individual contract awards, and a quick way to size any firm's federal business in one call.","url":"https://x402.forgemesh.io/federal-contractor-profile","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_3aWWJi6T7cWEZTZnL9NUP","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":"Resolves a company name to its official US government recipient records including legal name, UEI, recipient level, recent federal award totals, and a USAspending.gov profile link.","exampleAgentPrompt":"Can you look up Booz Allen Hamilton's federal contractor profile and tell me their UEI, official legal name, what level they are (parent or child), and how much they've received in recent federal awards?","exampleUseCases":[{"title":"Pre-bid contractor due diligence","prompt":"Before we respond to this RFP, can you pull the federal contractor profile for Leidos — I need their UEI, their official legal name, and a ballpark of how much federal work they've done recently?"},{"title":"Competitive intelligence sizing","prompt":"How big is Raytheon's federal business? Look up their contractor profile and tell me their total recent award amount and give me their USAspending.gov link so I can dig deeper."},{"title":"Verify small business contractor status","prompt":"I need to verify SAIC's recipient level and get their UEI — can you search the federal contractor database and return up to 5 matching records for 'SAIC'?"}],"resultDescription":"A JSON object containing the search query echo, total matched records, number returned, and an array of recipient objects each with: UEI identifier, official legal name, recipient ID, recipient level (P for parent, C for child, R for recipient), total recent federal award amount in USD, and a direct USAspending.gov profile URL. Attribution to USAspending.gov is included.","failureModes":["Company name under 3 characters returns a validation error","No matching recipients found returns an empty recipients array","Ambiguous company name may return many unrelated results if limit not set carefully","Non-US companies or companies with no federal awards may return zero results","Rate limiting or payment failure returns a 402 error"],"whenToPreferThis":"Choose this endpoint when you need to resolve a company name to its official US government contractor identity, UEI, or federal award totals using public USAspending.gov data. It is the right first step before querying individual contract awards. Prefer this over general business lookup APIs when the specific need is federal contracting data, UEI verification, or sizing a firm's government revenue.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:58:26.576Z","isFirstParty":false}