List all products for merchant

GET

https://integrators.prod.api.tabsplatform.com/v3/products

GET

/v3/products

$ curl https://integrators.prod.api.tabsplatform.com/v3/products \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json"

1 {
2   "payload": {
3     "data": [
4       {
5         "id": "a3f47b9e-8c2d-4f1a-9b7e-2d5f3c6a7b8e",
6         "manufacturerId": "b7d9f1a2-3c4e-5f6a-7b8c-9d0e1f2a3b4c",
7         "name": "Enterprise License",
8         "displayName": "Enterprise License",
9         "status": "ACTIVE",
10         "createdAt": "2023-01-01T00:00:00.000Z",
11         "updatedAt": "2023-06-15T12:30:00.000Z",
12         "description": "Full access license for enterprise users with advanced features.",
13         "integrationItemId": "INT-987654321",
14         "integrationItemName": "Enterprise License Item",
15         "erpClassId": "ERP-12345",
16         "erpClassName": "Software Licenses"
17       }
18     ],
19     "limit": 50,
20     "totalItems": 125,
21     "currentPage": 1
22   },
23   "success": true,
24   "message": "Products retrieved successfully.",
25   "error": {
26     "code": 0,
27     "message": "",
28     "details": {}
29   }
30 }

Authentication

Authorizationstring

API Key authentication via header

Query parameters

pagedoubleOptionalDefaults to 1

Page Number

limitdoubleOptionalDefaults to 50

Number of items to return

filterstringOptional

Format: field:rule:value — comma-separated for multiple filters.

Fields: name (string): eq, neq, like, nlike, in, nin, isnull, isnotnull status (string): eq

Example: filter=name:eq:value

Response

List all products

payloadobject

Response payload, will be empty when success is false

successboolean

Boolean with true=success, false=failure

messagestring

Plain-text description of the result

errorobject

json element with any error messages or warnings

Errors

404

Not Found Error

500

Internal Server Error