API Reference
Knowledge Base

List all materials

get
https://api.katanamrp.com/v1/materials

Returns a list of materials you’ve previously created. The materials are returned in sorted order,
with the most recent materials appearing first.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
ids
array of integers

Filters materials by an array of IDs

ids
string

Filters materials by a name

string

Filters materials by a uom

integer

Filters materials by a default_supplier_id

boolean

Filters materials by a is_sellable

boolean

Filters materials by a batch_tracked

string

Filters materials by a purchase_uom

number

Filters materials by a purchase_uom_conversion_rate

extend
array of strings

Array of objects that need to be added to the response

extend
Allowed:
boolean

Soft-deleted data is excluded from result set by default. Set to true to include it.

boolean

Archived data is excluded from result set by default. Set to true to include it.

string

Used for pagination (default is 50)

string

Used for pagination (default is 1)

string

Minimum value for created_at range. Must be compatible with ISO 8601 format

string

Maximum value for created_at range. Must be compatible with ISO 8601 format

string

Minimum value for updated_at range. Must be compatible with ISO 8601 format

string

Maximum value for updated_at range. Must be compatible with ISO 8601 format

Headers
string
enum

Selects the representation of custom_fields on items, for both the request body and the response.

  • default — object keyed by custom field definition id (UUID).
  • legacy — the {field_name, field_value} array tied to custom fields collections.

Most accounts do not need this header: an account that has not moved to item custom fields always gets legacy, and an account that has moved and no longer uses collections always gets the object representation. The header matters only while both are available for the account, where legacy is the default and default opts into the object representation.

Requesting a representation the account does not have returns 422, as does sending a custom_fields body whose shape does not match the representation in force, mixing both shapes in one request, or combining custom_field_collection_id with the object representation — that field belongs to the legacy representation and is left out of responses entirely under the object one. Responses vary on this header.

Allowed:
Responses

Updated 5 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Choose an example:
application/json

Updated 5 months ago

Did this page help you?