How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Virto Commerce Marketing API

Marketing system with dynamic contents and promotions management

Virto Commerce Marketing API is one of 13 APIs that Virto Commerce publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Marketing. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a GitHub repository.

This API exposes 35 operations across 25 paths, and defines 37 schemas. It is described by OpenAPI 3.0.4, at version v1.

Requests are made against the base URL https://virtostart-demo-admin.govirto.com/api.

35 operations 25 paths 37 schemas 6 DELETE8 GET16 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.4
API Version
v1
Base URL
https://virtostart-demo-admin.govirto.com/api
Authentication
OAuth 2.0, API Key, API Key, HTTP Signature, HTTP Basic
Resource Areas
1

Authentication & Security 5

Virto Commerce Marketing API declares 5 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2) using the password and clientCredentials flows. An API key is passed in the query as api_key (api_key). An API key is passed in the header as api_key (api_key_header). It uses HTTP signature authentication (http-signature). It accepts HTTP basic authentication (basic).

  • oauth2 — OAuth2 Resource Owner Password Grant flow
  • api_key — API Key authentication
  • api_key_header — API Key authentication (alternative via header)
  • http-signature — HTTP Signature authentication using Authorization header
  • basic — Basic authentication using username and password

Paths & Operations 35

Across 25 paths, the API surfaces 35 operations — 6 DELETE, 8 GET, 16 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Marketing 35

Marketing system with dynamic contents and promotions management

POST
/api/marketing/contentplaces/listentries/search
Search content places list entries by given criteria
MarketingModuleDynamicContent_DynamicContentPlaceListEntriesSearch body → 200401403
POST
/api/marketing/contentplaces/search
Search dynamic content places by given criteria
MarketingModuleDynamicContent_DynamicContentPlacesSearch body → 200401403
POST
/api/marketing/contentitems/listentries/search
Search content places list entries by given criteria
MarketingModuleDynamicContent_DynamicContentItemsEntriesSearch body → 200401403
POST
/api/marketing/contentitems/search
Search dynamic content items by given criteria
MarketingModuleDynamicContent_DynamicContentItemsSearch body → 200401403
POST
/api/marketing/contentpublications/search
Search dynamic content items by given criteria
MarketingModuleDynamicContent_DynamicContentPublicationsSearch body → 200401403
POST
/api/marketing/contentitems/evaluate
Get dynamic content for given placeholders
MarketingModuleDynamicContent_EvaluateDynamicContent body → 200401403
GET
/api/marketing/contentitems/{id}
Find dynamic content item object by id
MarketingModuleDynamicContent_GetDynamicContentById 1 param → 200401403
POST
/api/marketing/contentitems
Add new dynamic content item object to marketing system
MarketingModuleDynamicContent_CreateDynamicContent body → 200401403
PUT
/api/marketing/contentitems
Update an existing dynamic content item object
MarketingModuleDynamicContent_UpdateDynamicContent body → 204401403
DELETE
/api/marketing/contentitems
Delete a dynamic content item objects
MarketingModuleDynamicContent_DeleteDynamicContents 1 param → 204401403
GET
/api/marketing/contentplaces/{id}
Find dynamic content place object by id
MarketingModuleDynamicContent_GetDynamicContentPlaceById 1 param → 200401403
POST
/api/marketing/contentplaces
Add new dynamic content place object to marketing system
MarketingModuleDynamicContent_CreateDynamicContentPlace body → 200401403
PUT
/api/marketing/contentplaces
Update a existing dynamic content place object
MarketingModuleDynamicContent_UpdateDynamicContentPlace body → 204401403
DELETE
/api/marketing/contentplaces
Delete a dynamic content place objects
MarketingModuleDynamicContent_DeleteDynamicContentPlaces 1 param → 204401403
GET
/api/marketing/contentpublications/new
Get new dynamic content publication object
MarketingModuleDynamicContent_GetNewDynamicPublication → 200401403
GET
/api/marketing/contentpublications/{id}
Find dynamic content publication object by id
MarketingModuleDynamicContent_GetDynamicContentPublicationById 1 param → 200401403
POST
/api/marketing/contentpublications
Add new dynamic content publication object to marketing system
MarketingModuleDynamicContent_CreateDynamicContentPublication body → 200401403
PUT
/api/marketing/contentpublications
Update an existing dynamic content publication object
MarketingModuleDynamicContent_UpdateDynamicContentPublication body → 204401403
DELETE
/api/marketing/contentpublications
Delete a dynamic content publication objects
MarketingModuleDynamicContent_DeleteDynamicContentPublications 1 param → 204401403
GET
/api/marketing/contentfolders/{id}
Find dynamic content folder by id
MarketingModuleDynamicContent_GetDynamicContentFolderById 1 param → 200401403
POST
/api/marketing/contentfolders
Add new dynamic content folder
MarketingModuleDynamicContent_CreateDynamicContentFolder body → 200401403
PUT
/api/marketing/contentfolders
Update an existing dynamic content folder
MarketingModuleDynamicContent_UpdateDynamicContentFolder body → 204401403
DELETE
/api/marketing/contentfolders
Delete a dynamic content folders
MarketingModuleDynamicContent_DeleteDynamicContentFolders 1 param → 204401403
POST
/api/marketing/promotions/search
Search dynamic content places by given criteria
MarketingModulePromotion_PromotionsSearch body → 200401403
POST
/api/marketing/promotions/evaluate
Evaluate promotions
MarketingModulePromotion_EvaluatePromotions body → 200401403
GET
/api/marketing/promotions/{id}
Find promotion object by id
MarketingModulePromotion_GetPromotionById 1 param → 200401403
GET
/api/marketing/promotions/new
Get new dynamic promotion object
MarketingModulePromotion_GetNewDynamicPromotion → 200401403
POST
/api/marketing/promotions
Add new dynamic promotion object to marketing system
MarketingModulePromotion_CreatePromotion body → 200401403
PUT
/api/marketing/promotions
Update an existing dynamic promotion object in marketing system
MarketingModulePromotion_UpdatePromotions body → 200401403
DELETE
/api/marketing/promotions
Delete promotions objects
MarketingModulePromotion_DeletePromotions 1 param → 200401403
POST
/api/marketing/promotions/coupons/search
MarketingModulePromotion_SearchCoupons body → 200401403
GET
/api/marketing/promotions/coupons/{id}
MarketingModulePromotion_GetCoupon 1 param → 200401403
POST
/api/marketing/promotions/coupons/add
MarketingModulePromotion_AddCoupons body → 200401403
DELETE
/api/marketing/promotions/coupons/delete
MarketingModulePromotion_DeleteCoupons 1 param → 200401403
POST
/api/marketing/promotions/coupons/import
MarketingModulePromotion_ImportCouponsAsync body → 200401403

Schemas 37

The contract defines 37 schemas that model the data the API accepts and returns. The most detailed are PromotionEvaluationContext (44 properties), Promotion (25 properties), DynamicContentEvaluationContext (25 properties), PromotionReward (22 properties). Each schema is shown below with its type and property counts.

DynamicContentItem
object
16 properties
DynamicPropertyValueType
string
PromotionConditionAndRewardTree
object
5 properties
DynamicContentListEntrySearchResult
object
2 properties
PromotionReward
object
need to backward compatibility with v.2
22 properties
DynamicContentFolder
object
13 properties
DynamicContentPublication
object
16 properties
Currency
object
Currency
11 properties
PromotionSearchResult
object
2 properties
RewardAmountType
string
DynamicContentListEntry
object
9 properties
DynamicPropertyObjectValue
object
8 properties
DynamicObjectProperty
object
17 properties
DynamicContentConditionTree
object
5 properties
CouponSearchResult
object
2 properties
SortInfo
object
2 properties
DynamicContentItemSearchCriteria
object
12 properties
DynamicContentItemSearchResult
object
2 properties
DynamicContentPlaceSearchCriteria
object
12 properties
Promotion
object
25 properties
ProductPromoEntry
object
14 properties
PromotionSearchCriteria
object
17 properties
PromotionStatus
string
DynamicPropertyName
object
2 properties
DynamicContentPlace
object
13 properties
SortDirection
string
ImportNotification
object
14 properties
PromotionEvaluationContext
object
44 properties
Coupon
object
13 properties
CouponSearchCriteria
object
15 properties
IConditionTree
object
3 properties
DynamicContentPublicationSearchResult
object
2 properties
LocalizedString
object
1 property
DynamicContentPublicationSearchCriteria
object
16 properties
DynamicContentEvaluationContext
object
25 properties
DynamicContentPlaceSearchResult
object
2 properties
ImportRequest
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

virto-commerce-marketing-api-openapi.yml Raw ↑

Other APIs Virto Commerce publishes across the network.

Virto Commerce Catalog API
Virto Commerce Companies and Contacts API
Virto Commerce Inventory API
Virto Commerce Order Management API
Virto Commerce Pricing API
Virto Commerce Quotes API
Virto Commerce Shopping Cart API
Virto Commerce Store API
Virto Commerce VirtoCommerce Platform API
Virto Commerce Webhooks API
Virto Commerce Event Bus API
Virto Commerce Returns API
Where this information came from

This is an independent, third-party profile of Virto Commerce Marketing API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.