# Forbes API: Get billionaire net worth > Looks up a billionaire by name on the Forbes real-time billionaires list and returns their real-time net worth, today's change, rank and public profile details. Wealth figures change throughout the trading day. Unofficial. Not affiliated with or endorsed by Forbes. - Page: https://fous.com/methods/forbes.com/get-person-net-worth - Method: `forbes.com/get_person_net_worth`, version 1 - Website: forbes.com - Returns: name, net worth, rank, today's change, source of wealth, self-made score, citizenship, residence, age, photo, profile link, update time - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `name` | string | yes | `"Elon Musk"` | The billionaire's name, for example Elon Musk. | ## Output From a run on Oct 31, 2026. Its input: ```json { "name": "Elon Musk" } ``` Its output: ```json { "age": 55, "name": "Elon Musk", "rank": 1, "photo_url": "https://imageio.forbes.com/specials-images/imageserve/62d700cd6094d2c180f269b9/0x0.jpg?format=jpg&crop=959,959,x0,y0,safe&height=416&width=416&fit=bounds", "residence": "Austin, Texas", "updated_at": "2026-09-28T22:45:02-04:00", "citizenship": "United States", "profile_url": "https://www.forbes.com/profile/elon-musk/", "self_made_label": "Self-made who came from a middle-class or upper-middle-class background", "self_made_score": 8, "source_of_wealth": "Tesla, SpaceX, Self Made", "todays_change_percent": -2.39, "net_worth_billions_usd": 906.7, "todays_change_billions_usd": -22.2 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"forbes.com/get_person_net_worth","input":{"name":"Elon Musk"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What's Jensen Huang's net worth right now and how much has it moved today? - Pull up Forbes' real-time profile for Bernard Arnault — rank, net worth, and where he lives - How rich is Mukesh Ambani at the moment, and where does he rank among the world's wealthiest? - Check the Forbes billionaires list for Françoise Bettencourt Meyers: current fortune, age, citizenship, and self-made score - Is Larry Ellison up or down today? I need his live wealth figure and source of wealth. ## Input schema ```json { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "examples": [ "Elon Musk" ], "description": "The billionaire's name, for example Elon Musk." } } } ``` ## Output schema ```json { "type": "object", "required": [ "name", "net_worth_billions_usd", "rank", "todays_change_billions_usd", "todays_change_percent", "source_of_wealth", "self_made_score", "self_made_label", "citizenship", "residence", "age", "photo_url", "profile_url", "updated_at" ], "properties": { "age": { "type": [ "integer", "null" ], "description": "Age in years." }, "name": { "type": [ "string", "null" ], "description": "The person's name, such as Elon Musk." }, "rank": { "type": [ "integer", "null" ], "description": "Rank on Forbes real-time billionaires list." }, "photo_url": { "type": [ "string", "null" ], "description": "Link to the profile photo." }, "residence": { "type": [ "string", "null" ], "description": "Residence shown on the Forbes profile." }, "updated_at": { "type": [ "string", "null" ], "description": "When Forbes updated the real-time ranking, in ISO 8601 Eastern time." }, "citizenship": { "type": [ "string", "null" ], "description": "Country of citizenship." }, "profile_url": { "type": [ "string", "null" ], "description": "Link to the Forbes profile." }, "self_made_label": { "type": [ "string", "null" ], "description": "Description of the self-made score from Forbes." }, "self_made_score": { "type": [ "integer", "null" ], "description": "Forbes self-made score from 1 to 10." }, "source_of_wealth": { "type": [ "string", "null" ], "description": "Wealth sources shown on the Forbes profile." }, "todays_change_percent": { "type": [ "number", "null" ], "description": "Percentage change since the prior trading day; negative means a loss." }, "net_worth_billions_usd": { "type": [ "number", "null" ], "description": "Real-time net worth in billions of US dollars." }, "todays_change_billions_usd": { "type": [ "number", "null" ], "description": "Change since the prior trading day in billions of US dollars; negative means a loss." } }, "additionalProperties": false } ``` ## See more - [Forbes API: List billionaires](https://fous.com/methods/forbes.com/list-billionaires.md): Lists the richest people in rank order from Forbes Real-Time Billionaires, with net worth, daily change and profile details. Filter by country of citizenship or industry; wealth and changes are in billions of US dollars. - [Forbes API: Get company rankings](https://fous.com/methods/forbes.com/get-company-rankings.md): Finds a Forbes company profile by name and returns its Forbes list rankings, company facts and headline financial figures (Forbes list years; market value from the matching Global 2000 list). - [Forbes API: List Forbes Global 2000 companies](https://fous.com/methods/forbes.com/list-global-2000.md): Lists companies in the Forbes Global 2000 in rank order, optionally for a given year, country of headquarters and industry. Financial figures are in billions of US dollars; up to 500 results. - [Fortune API: Get company Fortune 500 rank](https://fous.com/methods/fortune.com/get-company-rank.md): Gets a company's Fortune 500 or Fortune 1000 rank and headline figures for a list year. CEO, ticker and website come from the current company profile and may not reflect a historical year. - [Google API: Get quote](https://fous.com/methods/google.com/get-quote.md): Gets the current quoted price and key figures for a stock, fund, index, or cryptocurrency on Google Finance, by name or ticker. Prices may be delayed, and figures Google does not show are null. - [MSN API: Get stock quote](https://fous.com/methods/msn.com/get-stock-quote.md): Gets a stock's latest MSN Money quote and key facts by company name or ticker and listing country. Quotes may be delayed outside market hours. - [Fortune API: List Fortune 500 companies](https://fous.com/methods/fortune.com/list-fortune-500.md): Lists the Fortune 500 for a year. You can filter by industry or sector and by headquarters state. Each company comes with its public financial and company details. - [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed. - [All Forbes methods](https://fous.com/methods/forbes.com.md)