API Reference
Knowledge Base

List all products

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

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

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

Filters products by an array of IDs

ids
string

Filters products by a name

string

Filters products by a uom

boolean

Filters products by a is_sellable

boolean

Filters products by an is_producible

boolean

Filters products by an is_purchasable

boolean

Filters products by an is_auto_assembly

integer

Filters products by a default_supplier_id

boolean

Filters products by a batch_tracked

boolean

Filters products by a serial_tracked

boolean

Filters products by a operations_in_sequence

string

Filters products by a purchase_uom

number

Filters products 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?