List materials

GET

/api/v1/materials

curl --request GET \
  --url 'https://api.stocksmith.io/api/v1/materials?state=active' \
  --header 'Authorization: Bearer <token>'

• Production

Authorizations

• bearer_auth

Parameters

Query Parameters

page

integer

Page number (default: 1)

per_page

integer

Results per page (default: 25, max: 100)

state

string

Allowed values: active archived all

Filter by state. Defaults to ‘active’. ‘all’ returns active + archived.

name

string

Partial name filter (case-insensitive substring match)

sku

string

Exact SKU/code filter (case-insensitive)

category_name

string

Partial category name filter (case-insensitive substring match)

Responses

200

Paginated list of materials

Media type application/json

object

materials

required

Array<object>

object

id

required

integer

name

required

string

sku

string

nullable

unit_measure

Unit of measure name, e.g. ‘grams’

string

nullable

category

string

nullable

stock_on_hand

required

Decimal string

string

committed_stock

required

Decimal string (always ‘0’ for materials)

string

available_stock

required

Decimal string

string

reorder_level

required

Decimal string

string

on_order

required

Decimal string, stock units (not purchase units)

string

state

required

string

Allowed values: active archived

unit_cost

Omitted for view-only users.

object

amount

Decimal string, e.g. ‘8.75’

string

currency_code

ISO 4217 code, e.g. ‘USD’

string

created_at

required

string format: date-time

updated_at

required

string format: date-time

meta

required

object

current_page

required

integer

total_pages

required

integer

total_count

required

integer

per_page

required

integer

Example

{
  "materials": [
    {
      "state": "active"
    }
  ]
}

401

Missing or invalid Bearer token

Media type application/json

object

error

required

Error message

string

Example ^generated

{
  "error": "example"
}