Back to all endpoints

PE Portfolios

Reveal all portfolio companies owned by the same private equity firm.

POST /v1/pe_portfolios
20 credits per record returned (min 20 credits)

Request body

ParameterTypeRequiredDescription
urlstringRequiredThe company website URL to look up - Domain names are extracted automatically
credit_limitintegerOptionalOptional maximum credits to spend on this request

Response format

Successful responses return a 200 status code with the following structure:

1{
2  "status_code": 200,
3  "status": "Success",
4  "results": [
5    {
6      "input_url": "https://example.com",
7      "extracted_domain": "example.com",
8      "output_count": 2,
9      "credit_cost": 40,
10      "is_pe_owned": true,
11      "is_pe_firm": false,
12      "pe_owner": {
13        "pe_firm_name": "Example Capital Partners",
14        "pe_firm_website": "examplecapital.com"
15      },
16      "pe_portfolio": [
17        {
18          "portfolio_company_name": "Example",
19          "portfolio_company_website": "example.com",
20          "pe_firm_name": "Example Capital Partners",
21          "pe_firm_website": "examplecapital.com",
22          "parent_name": "Example Parent Company",
23          "parent_website": "exampleparent.com"
24        },
25        {
26          "portfolio_company_name": "Portfolio Company",
27          "portfolio_company_website": "portfoliocompany.com",
28          "pe_firm_name": "Example Capital Partners",
29          "pe_firm_website": "examplecapital.com",
30          "parent_name": null,
31          "parent_website": null
32        }
33      ]
34    }
35  ]
36}

Error responses

204 Error

Credit limit exceeded

400 Error

Invalid URL provided

402 Error

Insufficient credits

403 Error

Forbidden - Invalid or missing API key

Code examples

1curl -X POST https://api.magellandata.io/v1/pe_portfolios \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "url": "https://example.com",
6    "credit_limit": 1000
7  }'

Try it out

Note: The interactive playground may not work due to browser CORS restrictions. For testing, we recommend using the code examples above with tools like Postman, cURL, or your own application code.

Try it now

Don't have an API key? Sign up for free

Maximum credits to spend on this request