Sales Channels

The sales channel object

Required attributes

Name
_id
Type
string
Description
The ID of the sales channel
Name
sellerId
Type
string
Description
The ID of the seller of the sales channel
Name
name
Type
string
Description
The name of the sales channel
Name
status
Type
enum(ACTIVE, INACTIVE)
Description
The status of the object, whether it is active or not
Name
type
Type
enum(POS, DISTRIBUTOR, INTERNAL_BOOKING, WEB, MARKETPLACE_APP, KIOSK)
Description
The type of the sales channel

Optional attributes

Name
createdAt
Type
string date-time
Description
An ISO timestamp indicating when the sales channel was created
Name
updatedAt
Type
string date-time
Description
An ISO timestamp indicating when the sales channel was updated
Name
groupId
Type
string
Description
The group of the sales channel
Name
contractTypeIds
Type
array<string>
Description
The contract types that are available through this sales channel
Name
owner
Type
string
Description
The app owner id, if the channel was created by a marketplace app

Example

{
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "type": "POS",
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z",
  "groupId": "507f191e810c19729de860ea",
  "contractTypeIds": [
    "string"
  ],
  "owner": "string"
}

POST/api/sales-channels

Create a sales channel

Payload

One of — Only one of the following types

Required attributes

Name
name
Type
string
Description
The name of the sales channel
Name
status
Type
enum(ACTIVE, INACTIVE)
Description
The status of the object, whether it is active or not
Name
type
Type
enum(DISTRIBUTOR)
Description

Optional attributes

Name
groupId
Type
string
Description
The group of the sales channel
Name
contractTypeIds
Type
array<string>
Description
The contract types that are available through this sales channel
Name
distributor
Type
object
Description
Required nested attributes (2)
Name
type
Type
enum(Redeam, GetYourGuide, Logitix, EventDynamic, StubHub, TicketmasterFrance, ProjectAdmission, Tiqets, TripCom, ANI, TicketNetwork, KorusTicket, ComeToParis, Experticket, Prioticket, RevPro, Automatiq)
Description
The type of the sales channel
Name
integrationType
Type
enum(DistributionService, Logitix, EventDynamic, StubHub, TicketmasterFrance, ProjectAdmission, Tiqets, TripCom, ANI, TicketNetwork, KorusTicket, ComeToParis, Experticket, Prioticket, RevPro, Automatiq)
Description
The integration type of the sales channel

Request

POST

/api/sales-channels

const response = await fetch('https://vivenu.com/api/sales-channels', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {token}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(  {
    "name": "Some fancy Name",
    "status": "ACTIVE",
    "type": "DISTRIBUTOR",
    "groupId": "507f191e810c19729de860ea",
    "contractTypeIds": [
      "string"
    ],
    "distributor": {
      "type": "Redeam",
      "integrationType": "DistributionService"
    }
  }),
})

const data = await response.json()

Response (200)

{
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "type": "POS",
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z",
  "groupId": "507f191e810c19729de860ea",
  "contractTypeIds": [
    "string"
  ],
  "owner": "string"
}

PUT/api/sales-channels/:id

Update a sales channel

Payload

One of — Only one of the following types

Required attributes

Name
name
Type
string
Description
The name of the sales channel
Name
status
Type
enum(ACTIVE, INACTIVE)
Description
The status of the object, whether it is active or not
Name
type
Type
enum(DISTRIBUTOR)
Description

Optional attributes

Name
groupId
Type
string
Description
The group of the sales channel
Name
contractTypeIds
Type
array<string>
Description
The contract types that are available through this sales channel
Name
distributor
Type
object
Description
Required nested attributes (2)
Name
type
Type
enum(Redeam, GetYourGuide, Logitix, EventDynamic, StubHub, TicketmasterFrance, ProjectAdmission, Tiqets, TripCom, ANI, TicketNetwork, KorusTicket, ComeToParis, Experticket, Prioticket, RevPro, Automatiq)
Description
The type of the sales channel
Name
integrationType
Type
enum(DistributionService, Logitix, EventDynamic, StubHub, TicketmasterFrance, ProjectAdmission, Tiqets, TripCom, ANI, TicketNetwork, KorusTicket, ComeToParis, Experticket, Prioticket, RevPro, Automatiq)
Description
The integration type of the sales channel

Request

PUT

/api/sales-channels/:id

const response = await fetch('https://vivenu.com/api/sales-channels/507f191e810c19729de860ea', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer {token}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(  {
    "name": "Some fancy Name",
    "status": "ACTIVE",
    "type": "DISTRIBUTOR",
    "groupId": "507f191e810c19729de860ea",
    "contractTypeIds": [
      "string"
    ],
    "distributor": {
      "type": "Redeam",
      "integrationType": "DistributionService"
    }
  }),
})

const data = await response.json()

Response (200)

{
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "type": "POS",
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z",
  "groupId": "507f191e810c19729de860ea",
  "contractTypeIds": [
    "string"
  ],
  "owner": "string"
}

GET/api/sales-channels/:id

Get a SalesChannel

Query parameters

Optional query parameters

Name
sellerId
Type
string
Description
The ID of the seller

Request

GET

/api/sales-channels/:id

const response = await fetch('https://vivenu.com/api/sales-channels/507f191e810c19729de860ea?sellerId=507f191e810c19729de860ea', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer {token}',
  },
})

const data = await response.json()

Response (200)

{
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "type": "POS",
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z",
  "groupId": "507f191e810c19729de860ea",
  "contractTypeIds": [
    "string"
  ],
  "owner": "string"
}

GET/api/sales-channels

Get all sales channels

Query parameters

Optional query parameters

Name
status
Type
array<enum(ACTIVE, INACTIVE)>
Description
Filter sales channels by status
Name
name
Type
string
Description
Filter sales channels by name
Name
type
Type
array<enum(POS, DISTRIBUTOR, INTERNAL_BOOKING, WEB, MARKETPLACE_APP, KIOSK)>
Description
Filter sales channels by type
Name
permissions
Type
array<enum(salesChannels:access)>
Description
Filter sales channnels by permissions
Name
groupIds
Type
array<string>
Description
Name
sellerId
Type
string
Description
The ID of the seller
Name
top
Type
integer
Description
A limit on the number of objects to be returned. Can range between 1 and 1000.
Name
skip
Type
integer
Description
The number of objects to skip for the requested result

Request

GET

/api/sales-channels

const response = await fetch('https://vivenu.com/api/sales-channels?status=value1%2Cvalue2&name=Some+fancy+Name&type=value1%2Cvalue2&permissions=value1%2Cvalue2&groupIds=value1%2Cvalue2&sellerId=507f191e810c19729de860ea&top=1&skip=1', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer {token}',
  },
})

const data = await response.json()

Response (200)

{
  "docs": [
    {
      "_id": "507f191e810c19729de860ea",
      "sellerId": "507f191e810c19729de860ea",
      "name": "Some fancy Name",
      "status": "ACTIVE",
      "type": "POS",
      "createdAt": "2030-01-23T23:00:00.123Z",
      "updatedAt": "2030-01-23T23:00:00.123Z",
      "groupId": "507f191e810c19729de860ea",
      "contractTypeIds": [
        "string"
      ],
      "owner": "string"
    }
  ],
  "total": 1
}

The sales channel group object

Required attributes

Name
name
Type
string
Description
The name of the sales channel group
Name
status
Type
enum(ACTIVE, INACTIVE)
Description
The status of the sales channel group, whether it is active or not
Name
restrictEventAccess
Type
boolean
Description
Wether channels in this group can only access some events or all
Name
_id
Type
string
Description
The ID of the sales channel group
Name
sellerId
Type
string
Description
The ID of the seller of the sales channel group

Optional attributes

Name
salesChannelIds
Type
array<string>
Description
The sales channels that are in the group
Name
createdAt
Type
string date-time
Description
An ISO timestamp indicating when the sales channel group was created
Name
updatedAt
Type
string date-time
Description
An ISO timestamp indicating when the sales channel group was updated

Example

{
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "restrictEventAccess": true,
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "salesChannelIds": [
    "string"
  ],
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z"
}

POST/api/sales-channels/groups

Create a sales channel group

Payload

Required attributes

Name
name
Type
string
Description
The name of the sales channel group
Name
status
Type
enum(ACTIVE, INACTIVE)
Description
The status of the sales channel group, whether it is active or not
Name
restrictEventAccess
Type
boolean
Description
Wether channels in this group can only access some events or all

Optional attributes

Name
salesChannelIds
Type
array<string>
Description
The sales channels that are in the group

Request

POST

/api/sales-channels/groups

const response = await fetch('https://vivenu.com/api/sales-channels/groups', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {token}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(  {
    "name": "Some fancy Name",
    "status": "ACTIVE",
    "restrictEventAccess": true,
    "salesChannelIds": [
      "string"
    ]
  }),
})

const data = await response.json()

Response (200)

{
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "restrictEventAccess": true,
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "salesChannelIds": [
    "string"
  ],
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z"
}

PUT/api/sales-channels/groups/:id

Update a sales channel group

Payload

Required attributes

Name
name
Type
string
Description
The name of the sales channel group
Name
status
Type
enum(ACTIVE, INACTIVE)
Description
The status of the sales channel group, whether it is active or not
Name
restrictEventAccess
Type
boolean
Description
Wether channels in this group can only access some events or all

Optional attributes

Name
salesChannelIds
Type
array<string>
Description
The sales channels that are in the group

Request

PUT

/api/sales-channels/groups/:id

const response = await fetch('https://vivenu.com/api/sales-channels/groups/507f191e810c19729de860ea', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer {token}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(  {
    "name": "Some fancy Name",
    "status": "ACTIVE",
    "restrictEventAccess": true,
    "salesChannelIds": [
      "string"
    ]
  }),
})

const data = await response.json()

Response (200)

{
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "restrictEventAccess": true,
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "salesChannelIds": [
    "string"
  ],
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z"
}

GET/api/sales-channels/groups/:id

Get a SalesChannelGroup

Request

GET

/api/sales-channels/groups/:id

const response = await fetch('https://vivenu.com/api/sales-channels/groups/507f191e810c19729de860ea', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer {token}',
  },
})

const data = await response.json()

Response (200)

{
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "restrictEventAccess": true,
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "salesChannelIds": [
    "string"
  ],
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z"
}

GET/api/sales-channels/groups

Get all sales channel groups

Query parameters

Optional query parameters

Name
status
Type
array<enum(ACTIVE, INACTIVE)>
Description
Filter sales channel groups by status
Name
name
Type
string
Description
Filter sales channel groups by name
Name
includeDefaultGroups
Type
boolean
Description
Whether default groups should be included
Name
top
Type
integer
Description
A limit on the number of objects to be returned. Can range between 1 and 1000.
Name
skip
Type
integer
Description
The number of objects to skip for the requested result

Request

GET

/api/sales-channels/groups

const response = await fetch('https://vivenu.com/api/sales-channels/groups?status=value1%2Cvalue2&name=Some+fancy+Name&includeDefaultGroups=true&top=1&skip=1', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer {token}',
  },
})

const data = await response.json()

Response (200)

{
  "name": "Some fancy Name",
  "status": "ACTIVE",
  "restrictEventAccess": true,
  "_id": "507f191e810c19729de860ea",
  "sellerId": "507f191e810c19729de860ea",
  "salesChannelIds": [
    "string"
  ],
  "createdAt": "2030-01-23T23:00:00.123Z",
  "updatedAt": "2030-01-23T23:00:00.123Z"
}