Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Last Updated:

Lastupdatedate

Livesearch
placeholderSearch the Vibes Developer Wiki
typepage

Available API methods

Table of Contents
maxLevel3


An Incentive Code Issuance entity is a record of an issuance of an Incentive Code.

Anchor
getissuancesforanincentivecode
getissuancesforanincentivecode
Get Issuances for an Incentive Code

Code Block
GET /companies/:company_id/incentives/codes/:code/issuances

Response

An array of all

...

Issuances for the given code.

Anchor
issueanincentivecode
issueanincentivecode
Issue an Incentive Code

Code Block
POST /companies/:company_id/incentives/pools/:pool_id/issuances
{
  "external_issuee_id": "312",
  "code": "aabb-ccdd",
  "referring_application": "system",
  "referring_application_ref_id" : "1234"
}

Request Elements

Data ElementRequiredDescription

external_issuee_id

NoUnique external issuee ID.
codeNo

If provided, a specific code is issued.

referring_application

Only in pools requiring a campaign_registration.Application issuing the code.

referring_application_ref_id

Only in pools requiring a campaign_registration.Application reference ID.

Response

It returns an

...

Issuance entity if there was an available code.

Note
Note: An HTTP error code 422 is returned if there are not enough available codes to issue.

Code Issuance

The same code is issued when using the same issuee_id. An

...

Issuance entity is created after each successful

...

Issuance request.