Get all products

GET {{baseUrl}}/products?owner_id=<integer>&ids=<string>&filter_id=<integer>&cursor=<string>&limit=<integer>&sort_by=id&sort_direction=asc&custom_fields=<string>

Returns data about all products.

Request Params

KeyDatatypeRequiredDescription
owner_idstringIf supplied, only products owned by the given user will be returned
idsstringOptional comma separated string array of up to 100 entity ids to fetch. If filter_id is provided, this is ignored. If any of the requested entities do not exist or are not visible, they are not included in the response.
filter_idstringThe ID of the filter to use
cursorstringFor pagination, the marker (an opaque string value) representing the first item on the next page
limitstringFor pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed.
sort_bystringThe field to sort by. Supported fields: id, name, add_time, update_time.
sort_directionstringThe sorting direction. Supported values: asc, desc.
custom_fieldsstringComma separated string array of custom fields keys to include. If you are only interested in a particular set of custom fields, please use this parameter for a smaller response.<br/>A maximum of 15 keys is allowed.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;success&quot;:true,&quot;data&quot;:[{&quot;id&quot;:1,&quot;name&quot;:&quot;Mechanical Pencil&quot;,&quot;code&quot;:&quot;MPENCIL&quot;,&quot;description&quot;:&quot;Product description&quot;,&quot;unit&quot;:&quot;&quot;,&quot;tax&quot;:0,&quot;category&quot;:&quot;Retail&quot;,&quot;is_linkable&quot;:true,&quot;is_deleted&quot;:false,&quot;visible_to&quot;:3,&quot;owner_id&quot;:1234,&quot;add_time&quot;:&quot;2019-12-19T11:36:49Z&quot;,&quot;update_time&quot;:&quot;2019-12-19T11:36:49Z&quot;,&quot;billing_frequency&quot;:&quot;monthly&quot;,&quot;billing_frequency_cycles&quot;:4,&quot;prices&quot;:[{&quot;product_id&quot;:1,&quot;price&quot;:5,&quot;currency&quot;:&quot;EUR&quot;,&quot;cost&quot;:2,&quot;direct_cost&quot;:1,&quot;notes&quot;:&quot;this is a note&quot;}],&quot;custom_fields&quot;:{&quot;6d74315176adcc4c97108440449b93ba57d20704&quot;:16}}],&quot;additional_data&quot;:{&quot;next_cursor&quot;:&quot;eyJmaWVsZCI6ImlkIiwiZmllbGRWYWx1ZSI6Nywic29ydERpcmVjdGlvbiI6ImFzYyIsImlkIjo3fQ&quot;}}