---
title: "Get deals associated with a specific company"
description: "GET /companies/{company_id}/deals — Returns deals across the contacts that belong to this company, with the same paging, sorting and filters as GET /deals. This covers the company's own contacts, not contacts merely linked to it."
canonical_url: https://developer.onepagecrm.com/api/reference/companies/get-companies-company_id-deals/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/companies/get-companies-company_id-deals/
---

`GET /companies/{company_id}/deals`

Returns deals across the contacts that belong to this company, with the same paging, sorting and filters as GET /deals. This covers the company's own contacts, not contacts merely linked to it.

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}/deals" \
  -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 |
| --- | --- | --- |
| `name` | string | Search deals by name |
| `search` | string | Search deals by deal name, contact name or company name |
| `status` | string | Return deals of a particular status (i.e. `pending`, `won`, `lost`, or `closed`) |
| `stage` | integer | Return deals (of status `pending`) with specified deal stage |
| `owner_id` | string | Return deals owned by a specific user |
| `date_filter` | string | Signals which date field to be used for only returning resources, added or edited, in a specified date range (only to be used with `since` and/or `until`, not with `modified_since` or `unmodified_since`) |
| `since` | string | Specifies the start of the date range to filter resources, which have been added or edited (use with `date_filter` - date must be in format `YYYY-MM-DD` or UNIX timestamp) |
| `until` | string | Specifies the end of the date range to filter resources, which have been added or edited (use with `date_filter` - date must be in format `YYYY-MM-DD` or UNIX timestamp) |
| `modified_since` | string | Return only resources that were modified since specified time (cannot be used with `date_filter` - date must be in format `YYYY-MM-DD` or UNIX timestamp) |
| `unmodified_since` | string | Return only resources that were unmodified since specified time (cannot be used with `date_filter` - date must be in format `YYYY-MM-DD` or UNIX timestamp) |
| `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": {
    "deals": [
      {
        "deal": {
          "id": "5aaa9b059007ba08c9ebaf58",
          "contact_id": "5aaa9b059007ba08c9ebaf58",
          "owner_id": "5aba31e99007ba0f570c12f7",
          "pipeline_id": "5cfa87a4849d7873db082f98",
          "sales_pipeline_id": "5cfa87a4849d7873db082f98",
          "name": "Solar panels",
          "text": "Fingers crossed!",
          "stage": 50,
          "status": "pending",
          "expected_close_date": "2018-04-15",
          "close_date": "2018-04-15",
          "date": "2018-04-15",
          "amount": 99.99,
          "months": 1,
          "cost": 0,
          "margin": 99.99,
          "total_amount": 99.99,
          "total_cost": 0,
          "commission_base": "amount",
          "commission_type": "none",
          "commission": 0,
          "commission_percentage": 0,
          "reason_lost_id": "5aaa9b059007ba08c9ebaf58",
          "deal_fields": [
            {}
          ],
          "has_deal_items": true,
          "deal_items": [
            {}
          ],
          "author": "Jane D.",
          "has_related_notes": true,
          "attachments": [
            {}
          ],
          "contact_info": {
            "contact_name": "Joe Bloggs",
            "company": "Big Company Inc."
          },
          "owner": {
            "id": "5aba31e99007ba0f570c12f7",
            "name": "Joe Bloggs",
            "email": "joe.bloggs@example.com"
          },
          "previous_pipeline_stages": {
            "5da7b67a849d78737812437c": 40
          },
          "created_at": "2018-03-15T16:10:45Z",
          "modified_at": "2018-03-15T16:10:45Z",
          "linked_contacts": [
            {
              "id": "68b5edd78b3ee61b685c8692",
              "contact_name": "Sajed Almorsy",
              "company": "OnePageCRM",
              "photo_url": ""
            }
          ]
        }
      }
    ],
    "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/)