GETProducts

Get A Product

/api/v1/products/{productCode}

Retrieve detailed information for a specific product, including associated resources. Product must belong to the authenticated partner.

Authentication Required

Include Bearer token in Authorization header: Authorization: Bearer YOUR_TOKEN

Path Parameters

Name	Type	Required	Description
`productCode`	`string`	Yes	Unique product code identifier (e.g., PROD-001)

Response

Success Response Example:

{
  "success": true,
  "product": {
    "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",
    "resources": [
      {
        "id": 10,
        "name": "Tour Guide - English",
        "type": "guide",
        "isPrimary": true,
        "sameDay": true,
        "timeOffsetStart": 0,
        "timeOffsetEnd": 120
      },
      {
        "id": 11,
        "name": "Eiffel Tower Entrance",
        "type": "venue",
        "isPrimary": false,
        "sameDay": true,
        "timeOffsetStart": 30,
        "timeOffsetEnd": 90
      }
    ]
  }
}

Error Response

Error Example:

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Product PROD-001 not found"
  }
}

Available Errors

HTTP Status	Code	Meaning
`401`	`UNAUTHORIZED`	Invalid or missing authentication token
`400`	`INVALID_REQUEST`	Missing product code
`404`	`NOT_FOUND`	Product not found or does not belong to partner
`500`	`INTERNAL_SERVER_ERROR`	Server error

← Back to Home