Back to all endpoints

Parent Companies

Identify the corporate parent for any given company.

POST /v1/parent_companies
70 credits per request

Request body

ParameterTypeRequiredDescription
urlstringRequiredThe company website URL to look up - Domain names are extracted automatically

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://subsidiary.example.com",
7      "extracted_domain": "subsidiary.example.com",
8      "credit_cost": 70,
9      "has_parent_company": true,
10      "parent_details": {
11        "parent_company": "Example Parent Corp",
12        "parent_website": "example.com"
13      }
14    }
15  ]
16}

Error responses

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/parent_companies \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "url": "https://example.com"
6  }'

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