---
title: "Get contacts linked with a specific company"
description: "GET /companies/{company_id}/linked_contacts — Returns contacts from other companies that have been linked to this company's own contacts. Each entry carries linked_with, listing which of this company's contacts it is linked to."
canonical_url: https://developer.onepagecrm.com/api/reference/companies/get-companies-company_id-linked_contacts/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/companies/get-companies-company_id-linked_contacts/
---

`GET /companies/{company_id}/linked_contacts`

Returns contacts from other companies that have been linked to this company's own contacts. Each entry carries linked_with, listing which of this company's contacts it is linked to. Paging and sorting only — no filters.

Resource: [Companies](https://developer.onepagecrm.com/api/reference/companies/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl "https://app.onepagecrm.com/api/v3/companies/{company_id}/linked_contacts" \
  -u $user_id:$api_key
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `company_id` | string | Company ID |

## Query parameters

| Name | Type | Description |
| --- | --- | --- |
| `sort_by` | string | Specify field by which to order the results (use in conjunction with `order`) |
| `order` | string | Specify the order (ascending or descending) of the sort of the results (use in conjunction with `sort_by`) |
| `page` | integer | Page number. Starts from 1. Default is 1. |
| `per_page` | integer | Number of records to return. Maximum 100 allowed. Default is 10. |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "linked_contacts": [
      {
        "linked_contact": {
          "contact": {
            "id": "5aba31ea9007ba0f570c92d4",
            "title": "Mr",
            "first_name": "Joe",
            "last_name": "Bloggs",
            "job_title": "Engineer",
            "starred": true,
            "photo_url": "https://{foo.bar}/joe-bloggs.jpg",
            "company_id": "5aba31ea9007ba0f570c92d5",
            "company_name": "Morgan's Forensic Lab",
            "urls": [],
            "phones": [],
            "emails": [],
            "address_list": [],
            "status": "Prospect",
            "status_id": "5e31e030849d781e837b6ba1",
            "tags": [
              "Java",
              "Android",
              "iOS"
            ],
            "lead_source_id": "email_web",
            "lead_source": "Email or Web",
            "background": "I met Joe Bloggs at the annual Eco Conference in Florida. Her company currently provides solar panels (along with a lot of other stuff) to the State Government of California, Nevada, Oregon, Arizona and Utah for capital building projects. Her current supplier is crazy expensive! I've asked to be able to tender for their next order.",
            "owner_id": "5aba31e99007ba0f570c92a5",
            "custom_fields": [],
            "letter": "b",
            "pending_deal": true,
            "total_pendings": 999.99,
            "total_deals_count": 3,
            "company_size": 1,
            "sales_closed_for": [
              "5aba31e99007ba0f570c12f7"
            ],
            "closed_sales": [],
            "google_contacts_data": {},
            "created_at": "2018-05-16T11:52:09Z",
            "modified_at": "2018-05-16T11:52:09Z"
          },
          "next_actions": [
            {}
          ],
          "next_action": {
            "id": "5aeac8789007ba56ffca92b9",
            "assignee_id": "5aaa9b009007ba08c9ebaef7",
            "contact_id": "5aba31ea9007ba0f570c92d4",
            "text": "#1 Email Jane introducing our organization",
            "status": "date_time",
            "date": "2018-05-16",
            "exact_time": 1526472000,
            "position": 1,
            "done": false,
            "done_at": "2018-05-16",
            "created_at": "2018-05-16T11:52:09Z",
            "modified_at": "2018-05-16T12:52:09Z"
          },
          "queued_actions": [
            {}
          ],
          "next_action_conflicts": [],
          "company": {
            "id": "5aba31e99007ba0f570c92ac",
            "image": "data:image/png;base64,iVBORw...",
            "name": "Crockett & Tubbs Security",
            "description": "For all your security needs",
            "phone": "(912) 644-1771",
            "photo_url": "https://example.com/someimage.png",
            "url": "https://{foo.bar}",
            "address": {},
            "company_fields": [],
            "syncing_status": true,
            "synced_status_id": "5aaa9b039007ba08c9ebaf0a",
            "syncing_tags": true,
            "synced_tags": [
              "Java",
              "Android",
              "iOS"
            ],
            "contacts_count": 3,
            "won_deals_count": 5,
            "total_won_amount": 999.99,
            "pending_deals_count": 1,
            "total_pending_amount": 99.99,
            "contacts": [],
            "pending_deals": [],
            "created_at": "2018-05-16T11:52:09Z",
            "modified_at": "2018-05-16T11:52:09Z"
          },
          "linked_with": [
            "5aba31e99007ba0f570c92ab"
          ]
        }
      }
    ],
    "total_count": 1,
    "page": 1,
    "per_page": 10,
    "max_page": 1
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
- [Pagination](https://developer.onepagecrm.com/api/pagination/)
- [Sorting & time filters](https://developer.onepagecrm.com/api/sorting/)