GETProducts

List Products

/api/v1/products

Retrieve a list of all active products belonging to the authenticated partner. Returns products ordered by ID (newest first) with pagination support.

Authentication Required

Include Bearer token in Authorization header: Authorization: Bearer YOUR_TOKEN

Query Parameters

Name	Type	Required	Description
`page`	`integer`	No	Page number for pagination (default: 1)
`limit`	`integer`	No	Items per page, max 100 (default: 25)

Response

Success Response Example:

{
  "success": true,
  "products": [
    {
      "id": 1,
      "name": "Eiffel Tower Tour",
      "productCode": "PROD-001",
      "description": "Guided tour of the Eiffel Tower with skip-the-line access",
      "prices": {
        "adult": 45,
        "child": 25,
        "senior": 35
      },
      "status": "active"
    },
    {
      "id": 2,
      "name": "Louvre Museum Pass",
      "productCode": "PROD-002",
      "description": "Full day access to the Louvre Museum",
      "prices": {
        "adult": 60,
        "child": 30
      },
      "status": "active"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 47,
    "totalPages": 2,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}

Error Response

Error Example:

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Unauthorized - Partner not authenticated"
  }
}

Available Errors

HTTP Status	Code	Meaning
`401`	`UNAUTHORIZED`	Invalid or missing authentication token
`500`	`INTERNAL_SERVER_ERROR`	Server error

← Back to Home