Getting stock movements

API reference ProductAPI

Overview

To get the stock movements for a specific product, send the product_id in the request. The response will include all the recorded transactions for that specific product

Method access
GET https://api.getbyrd.com/v2/warehouse/transactions
Request Headers
Authorization: Bearer token-from >Authentication
Content-Type: application/json
User-Agent: your user-agent >How to call the APIs

Query params

FieldTypeDescription
product_id stringProduct id
The id of the product to get the transactions. You can get the id of all your products by listing them.

Pagination

By sending these parameters you can get the result in different pages:

FieldTypeDescription
per_page stringItems per page
Default is 250
page stringIt returns only that page
sort_by stringIt sorts the response by this field
sort_order stringIs sorts the response ascending or descending depending on this value
If accepts asc and desc

Successful response example

{
    "page": 0,
    "per_page": 250,
    "page_count": 1,
    "total_count": 2,
    "data": [
        {
            "userID": "user_id",
            "storage": {
                "id": "storage_id",
                "bsid": "BSID"
            },
            "description": null,
            "updatedAt": "2023-03-16T14:31:59.128638+00:00",
            "relatedStorage": null,
            "createdAt": "2023-03-16T14:31:59.128638+00:00",
            "stockModifier": -3,
            "id": "transaction_id",
            "newStock": 997,
            "reason": "fulfillment"
        },
        {
            "userID": "user_id",
            "storage": {
                "id": "storage_id",
                "bsid": "BSID"
            },
            "description": "delivery TST-1234",
            "updatedAt": "2023-03-08T16:14:25.578127+00:00",
            "relatedStorage": null,
            "createdAt": "2023-03-08T16:14:25.578119+00:00",
            "stockModifier": 1000,
            "id": "transaction_id",
            "newStock": 1000,
            "reason": "delivery"
        }
    ]
}