OfficeGest
Stocks/Articles/{article}/Serial numbers

List article serial numbers

Returns all serial numbers assigned to this article. Only available for articles with serial number tracking enabled (use_serial_numbers flag). Shows serial number status, warehouse location, and other tracking information.

GET
/stocks/articles/{article}/serial-numbers
AuthorizationBearer <token>

In: header

Path Parameters

articlestring

Query Parameters

in_stock?boolean

Filter by stock availability

serial_number?stringDeprecated

Filter by serial number (supports operators: eq, like)

warehouse_id?stringDeprecated

Filter by warehouse ID (supports operators: eq, in)

created_at?stringDeprecated

Filter by creation timestamp (supports operators: gte, lte)

Formatdate-time
updated_at?stringDeprecated

Filter by update timestamp (supports operators: gte, lte)

Formatdate-time
filter[serial_number][operator]?string

Operators: eq, like. Example: filter[serial_number][eq]=value

filter[warehouse_id][operator]?string

Operators: eq, in. Example: filter[warehouse_id][eq]=value

filter[created_at][operator]?string

Operators: gte, lte. Example: filter[created_at][gte]=value

Formatdate-time
filter[updated_at][operator]?string

Operators: gte, lte. Example: filter[updated_at][gte]=value

Formatdate-time
filter?object

Advanced filter as JSON object with field => operator => value

Empty Object

page?integer

Page number. Default 1; a value below 1 counts as 1.

Default1
Range1 <= value
limit?integer

Items per page. Default 50, maximum 250; a larger value is truncated to 250.

Default50
Range1 <= value <= 250

Response Body

curl -X GET "https://og-tenant1.test:8003/api/v2/stocks/articles/string/serial-numbers?in_stock=true&serial_number=string&warehouse_id=string&created_at=2019-08-24T14%3A15%3A22Z&updated_at=2019-08-24T14%3A15%3A22Z&filter%5Bserial_number%5D%5Boperator%5D=string&filter%5Bwarehouse_id%5D%5Boperator%5D=string&filter%5Bcreated_at%5D%5Boperator%5D=2019-08-24T14%3A15%3A22Z&filter%5Bupdated_at%5D%5Boperator%5D=2019-08-24T14%3A15%3A22Z&page=1&limit=50"
{
  "data": [
    {
      "serial_number": "string",
      "in_stock": true,
      "warehouse_id": 0,
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "meta": {
    "per_page": 50,
    "current_page": 1,
    "has_more": true,
    "total": 120,
    "last_page": 3,
    "from": 1,
    "to": 50
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}