# Get product list

Retrieves a comprehensive list of all available products. This endpoint supports various filtering and sorting options to help you narrow down the results. 

You can filter by product , , , and . Pagination is available using the  and  parameters. 

You can also specify the  order and the  for the response.


Endpoint: GET /v2/products
Version: 2.1
Security: Authorization

## Query parameters:

  - `type` (string)
    type - UUID of type of product. Types is the product segregation: Activity, Event, Package, Day Tour, Voluntourism, Water Tour, Attraction (UUID available in /config)

  - `category` (string)
    category - UUID of listing category. Categories are products groups, like zoo, aquapark, cooking class, and many many more (UUID available in /config)

  - `country` (string)
    country - UUID of country

  - `city` (string)
    city - UUID of city, it will always overwrite country parameter if provided

  - `page` (string)
    page - page number for results

  - `per_page` (string)
    per_page - how many results per page - if not provided default value from user account will be used

  - `sort` (string)
    sort - sorting field - coma separated list of fields e.g. date,-price,-date,price

  - `language` (string)
    language - UUID or code may be provided

  - `fields` (string)
    fields - coma separated list of keys (fields) to be returned (Fields include 'uuid','updatedAt','title','titleTranslated','validFrom','validThrough','basePrice','typeName','typeUuid','links')

## Response 200 fields (application/json):

  - `data` (array, required)
    The main payload of the response.

  - `data.uuid` (string)
    UUID of product

  - `data.updatedAt` (string)
    last update date/time to product

  - `data.title` (string)
    Title of product. Always in English

  - `data.titleTranslated` (string)
    Title of product on requested language

  - `data.validFrom` (string,null)
    Start date for product availability (or null when no limit)

  - `data.validThrough` (string,null)
    End date if product availability (or null when no limit)

  - `data.basePrice` (number)
    Base price of product

  - `data.typeName` (string)
    Type of product

  - `data.typeUuid` (string)
    Type UUID

  - `data.links` (array)
    HATEOAS links

  - `data.links.method` (string, required)

  - `data.links.rel` (string, required)

  - `data.links.href` (string, required)

  - `timestamp` (string, required)
    The timestamp when the response was generated.

  - `links` (array)

  - `meta` (object)

  - `meta.pagination` (object)

  - `meta.pagination.count` (integer)

  - `meta.pagination.current_page` (integer)

  - `meta.pagination.per_page` (integer)

  - `meta.pagination.total_page` (integer)

## Response 400 fields (application/json):

  - `message` (string)
    A human-readable error message.

  - `code` (string)
    An internal error code.

  - `http_code` (integer)
    Http Status Code

## Response 401 fields (application/json):

  - `message` (string)
    A human-readable error message.

  - `code` (string)
    An internal error code.

  - `http_code` (integer)
    Http Status Code

## Response 405 fields (application/json):

  - `message` (string)
    A human-readable error message.

  - `code` (string)
    An internal error code.

  - `http_code` (integer)
    Http Status Code