Back to all endpoints

Corporate Families

Discover all subsidiaries, divisions, and sister companies within a corporate family.

POST /v1/corporate_families
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": 1,
9      "credit_cost": 20,
10      "has_parent_company": true,
11      "is_parent_company": false,
12      "parent_details": {
13        "parent_company": "Example Parent Corp",
14        "parent_website": "exampleparent.com"
15      },
16      "corporate_family": [
17        {
18          "child_company_name": "Example Subsidiary Inc",
19          "child_company_website": "example.com",
20          "parent_company_name": "Example Parent Corp",
21          "parent_company_website": "exampleparent.com"
22        },
23        {
24          "child_company_name": "Other Subsidiary Inc",
25          "child_company_website": "othersub.com",
26          "parent_company_name": "Example Parent Corp",
27          "parent_company_website": "exampleparent.com"
28        }
29      ]
30    }
31  ]
32}

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/corporate_families \
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