GET 5 min read

List Partner Companies

GET /api/v1/companies/{id}/partners

Retrieve all partner companies linked to your company

List Partner Companies

Retrieve all partner companies that are linked to a specific company. These are companies that have an approved network partnership with your company.

Path Parameters

Parameter Type Description
id integer The company ID

Example Request

curl -X GET "https://hydra.marketdragon.ph/api/v1/companies/1/partners" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Example Response

{
    "data": [
        {
            "id": 5,
            "name": "AutoParts Express",
            "slug": "autoparts-express",
            "email": "[email protected]",
            "phone": "+63 2 9876 5432",
            "address": "456 Industrial Ave",
            "city": "Quezon City",
            "state": "Metro Manila",
            "postal_code": "1100",
            "country": "PH",
            "timezone": "Asia/Manila",
            "currency": "PHP",
            "status": "active",
            "logo_url": "https://hydra.marketdragon.ph/storage/companies/5/logo.png",
            "created_at": "2024-01-10T10:00:00+00:00",
            "updated_at": "2024-01-10T10:00:00+00:00"
        },
        {
            "id": 8,
            "name": "Quick Lube Services",
            "slug": "quick-lube-services",
            "email": "[email protected]",
            "phone": "+63 2 5555 1234",
            "address": "789 Service Road",
            "city": "Makati",
            "state": "Metro Manila",
            "postal_code": "1200",
            "country": "PH",
            "timezone": "Asia/Manila",
            "currency": "PHP",
            "status": "active",
            "logo_url": null,
            "created_at": "2024-01-12T14:30:00+00:00",
            "updated_at": "2024-01-12T14:30:00+00:00"
        }
    ]
}

Empty Response

If the company has no partner companies:

{
    "data": []
}

Error Responses

403 Forbidden

{
    "message": "You do not have access to this company."
}

404 Not Found

{
    "message": "No query results for model [Company] 999"
}

Use Cases

Partner companies are useful for:

  • Referral networks - Refer service jobs to partner workshops
  • Parts suppliers - Order parts from linked suppliers
  • Service collaborations - Share workload with partner companies
Back to Companies
Was this helpful?