Search stock items

POST /stock/search/{fromthisid}

OAuth2

Filtered by the posted fields. Returned in ID order

Path parameters

fromthisid integer Required

The ID that is previous to the one to start from e.g. if IDs are 1,2,3 fromthisid as 1 will return 2,3

application/json

Body

1 or more Search parameters

search array[object]
Hide search attributes Show search attributes object
- by string
  
  any of the field names that are output from item or list calls
- value string
  
  the search value for the term specified by the 'by'

Responses

200 application/json

List returned OK
Hide response attributes Show response attributes object
- id integer
  
  Minimum value is 1.
- stockcode string
- description string
- location_id integer
  
  If supplied, must link to a valid Location
- campaign_id integer
  
  If supplied, must link to a valid campaign that the logged in user can see
- current_stock integer
  
  Minimum value is 0.
- reorder_stock integer
  
  When to request a re-order
  
  Minimum value is 0.
- administrator_user_id integer
  
  CORE user id for the person who administers this stock item
- item_price number
  
  Minimum value is 0.
- cost_price number
  
  Minimum value is 0.
- event_id integer
  
  If supplied, must link to a valid event, and event_date
- event_date string
  
  If supplied, must link to a valid event along with event_id
- early_bird_end_date_local string
  
  If supplied, the last date a discount price is available
- early_bird_price number
  
  Minimum value is 0.
401 application/json

Authentication unauthorised
Hide response attribute Show response attribute object
- error string
403 application/json

Invalid permission
Hide response attribute Show response attribute object
- error string

POST /stock/search/{fromthisid}

curl \
 --request POST 'https://YOURSITE.infoodle.com/apiv2/stock/search/4' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"search":[{"by":"name","value":"Test Item"}]}'

Request examples

{
  "search": [
    {
      "by": "name",
      "value": "Test Item"
    }
  ]
}

Response examples (200)

[
  {
    "id": 123,
    "stockcode": "EVT#1",
    "description": "Event Tickets",
    "location_id": 45,
    "campaign_id": 421,
    "current_stock": 100,
    "reorder_stock": 5,
    "administrator_user_id": 542123,
    "item_price": 120.5,
    "cost_price": 100.5,
    "event_id": 54,
    "event_date": "2026-02-29",
    "early_bird_end_date_local": "2026-01-01",
    "early_bird_price": 70.5
  }
]

Response examples (401)

{
  "error": "Unauthorised"
}

Response examples (403)

{
  "error": "Invalid Permission"
}