---
title: "Get Stock Updates"
method: GET
path: "/v1/companies/{company_id}/projects/{project_id}/offers"
tags: ["stock_updates"]
---

# Get Stock Updates

`GET /v1/companies/{company_id}/projects/{project_id}/offers`

This endpoint retrieves all offers for a given project of your company, sorted from most recent
to oldest. Offers are the product updates that you posted.

These are found under "Orders" > "Product updates" in the Channable tool.
Optionally, you can pass query parameters to customize the query and response content.


**Example usage**

Suppose the following scenario for a given project of yours:
  - The project contains the offers `o1`, `o2`, `o3`, and `o4` (from oldest to most recent)
  - `o1` and `o4` are searchable by the term `t`
  - `o3` is searchable by the term `tE`


|  Request parameters                          | Response
| -------------                                | -----------
| _none_                                       | `{"offers": [o4, o3, o2, o1], "total": 4}`
| `?limit=2`                                   | `{"offers": [o4, o3], "total": 2}`
| `?offset=4`                                  | `{"offers": [], "total": 0}`
| `?offset=1`                                  | `{"offers": [o3, o2, o1], "total": 3}`
| `?offset=1&limit=1`                          | `{"offers": [o3], "total": 1}`
| `?offset=1&limit=2`                          | `{"offers": [o3, o2], "total": 2}`
| `?search=t`                                  | `{"offers": [o4, o1], "total": 2}`
| `?search=tE`                                 | `{"offers": [o3], "total": 1}`
| `?start_date=2018-01-01`                     | `{"offers": [o4, o3, o2], "total": 3}`
| `?start_date=2018-01-01&end_date=2018-02-28` | `{"offers": [o3, o2], "total": 2}`
| `?last_modified_after=2018-02-29`            | `{"offers": [o4], "total": 1}`

## Path parameters

- `company_id` integer, required
- `project_id` integer, required

## Query parameters

- `search` string, nullable — Any text based search query
- `start_date` union
  - string, date
  - string, date-time
- `end_date` union
  - string, date
  - string, date-time
- `last_modified_after` union
  - string, date
  - string, date-time
- `last_modified_before` union
  - string, date
  - string, date-time
- `limit` integer — Max number of results in a single page.
- `offset` integer — Filter results starting from this offset.

## Response `200`

Successful Response

- RecentOffers
  - `total` integer, required
  - `offers` EfferentOffer[], required
    - `id` integer, nullable
    - `project_id` integer, required
    - `client_id` string, required
    - `gtin` string, nullable
    - `stock` integer, nullable
    - `stock_tracking` boolean, required
    - `availability` boolean, nullable
    - `title` string, nullable
    - `price` string, nullable
    - `created` string, date-time, required
    - `modified` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/channable/apis/channable-order-connection-api.md) · [All operations](https://skmtc.net/channable/apis/channable-order-connection-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/channable/channable-order-connection-api/revisions/819df1427359/schema)