getpromos

Returns the list of active promotions associated with an agency according to its access credentials.

endpoints

production

https://newapi.vpttours.com/getpromos

request parameters

logindata

[object]

User access credentials. Required fields :

useremail
userpass

Example:

"logindata": {
  "useremail": "XXXXXX@XXXX.XX",
  "userpass": "XXXXX"
},
  "requestdata": []
}

response data

[array:promo]

List of active promotions associated with the logged-in agency.

Each element includes:

Field	Type	Description
id	int	Internal promotion identifier
brochure	string	Brochure code to which the promotion belongs
code	string	Associated tour code
startDate	string (YYYY-MM-DD)	Promotion start date
endDate	string (YYYY-MM-DD)	Promotion end date
comissionPct	string	Applicable commission percentage
discountPct	string/null	Discount percentage, if any
observations	string/null	Additional notes

Example response:

[
  {
    "id": "4933",
    "brochure": "211",
    "code": "520202",
    "startDate": "2025-06-23",
    "endDate": "2025-08-01",
    "comissionPct": "34.00",
    "discountPct": null,
    "observations": null
  },
  {
    "id": "5019",
    "brochure": "211",
    "code": "51231",
    "startDate": "2025-08-01",
    "endDate": "2025-10-01",
    "comissionPct": "34.00",
    "discountPct": null,
    "observations": null
  }
]

notas

If there are no active promotions, an empty array [] will be returned.

Dates are in YYYY-MM-DD format.

The endpoint is only available for authenticated users with valid credentials.