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
• integrator_token

Example:

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

response data

[array:promo]

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

Each element includes

• 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.