VIvimeo
On Demand\Promotions

Get all the codes of a promotion on an On Demand page

This method returns all the codes of a promotion on an On Demand page.

get/ondemand/pages/{ondemand_id}/promotions/{promotion_id}/codes

Request

Path parameters

ondemand_idnumber required
Example:61326

The ID of the On Demand.

promotion_idnumber required
Example:12345

The ID of the promotion.

Query parameters

pagenumber
Example:1

The page number of the results to show.

per_pagenumber
Example:10

The number of items to show on each page of results, up to a maximum of 100.

Response

The codes were returned.

codestring required

A promotion code that can be redeemed on Vimeo.

linkstring required

A link to redeem the promotion code instantly.

max_usesnumber required

The total amount of times this code can be used.

usesnumber required

The number of times that this code has been used.

Example response

{
  "code": "8jgaieumbzstujhn8k304iwwezawkvwm",
  "link": "https://vimeo.com/r/0trBLg/OGpnYWlldW",
  "max_uses": 1
}

Changes

No recorded changes to this operation across all 13 revisions of this API.