JSON API » products » products/list

Gets the fields of all products available for purchase, or owned by the given customer.

Input parameters

Requires authentication. If listing products available for purchase, the administrator role privilege is required. If listing products owned by a customer, the commerce role privilege is required.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
availableInteger1 to get list of products available to purchase, 0 to get list of owned products.No0
customerIntegerID of customer to get products owned by. Only used if available=0.NoCustomer of authentication user.

Responses

ProductDescription
200Success.
400Invalid customer specified.
401The authentication details provided are invalid.
402Your role does not allow this.

Data returned

An array of fields, corresponding to the rows of the products table in the database.

Example: Products owned by this customer

http://enswitch.example.com/api/json/products/list/?auth_username=user;auth_password=password

{ "responses":[ { "product":200, "key":"", "message":"OK" } ], "data":[ { "id":1, "name":"example1", ... }, { "id":2, "name":"example2", ... } ] }

Change history

VersionChanges
4.0available input parameter added.
3.13Function added.