{"openapi":"3.1.0","info":{"version":"2.0.0","title":"Levanta Seller API v2","description":"Authorize all requests with an API key in the Authorization header as the second token. E.g. Authorization -> \"Bearer {api_key}\"."},"externalDocs":{"url":"https://app.levanta.io/seller/api-docs"},"servers":[{"url":"https://app.levanta.io/api/seller/v2"}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer"}},"schemas":{},"parameters":{}},"paths":{"/brands/{brand_id}":{"get":{"summary":"Get Brand by ID","tags":["Brands"],"operationId":"SellerGetBrandV2","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"brand_id","in":"path"}],"responses":{"200":{"description":"Get a brand","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the brand"},"name":{"type":"string","description":"The name of the brand"},"active":{"type":"boolean","description":"Whether the brand is active in Levanta"},"image":{"type":"string"},"bio":{"type":"string"},"url":{"type":"string"},"marketplace":{"type":"string","enum":["amazon.com","amazon.com.mx","amazon.co.uk","amazon.ca","amazon.de","amazon.es","amazon.fr","amazon.it","amazon.nl","walmart.com","shopify.com"],"description":"Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). This union is subject to expand as new marketplaces are added."}},"required":["id","name","active","image","bio","url","marketplace"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"404":{"description":"Brand not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[404]},"message":{"type":"string","enum":["Brand not found"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/brands":{"get":{"summary":"List Brands","tags":["Brands"],"operationId":"SellerListBrandsV2","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":25,"description":"The maximum number of items to return"},"required":false,"description":"The maximum number of items to return","name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512,"description":"The cursor returned from the last request, if omitted the first page will be returned"},"required":false,"description":"The cursor returned from the last request, if omitted the first page will be returned","name":"cursor","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"brand_ids","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"active","in":"query"},{"schema":{"type":"string","enum":["all","amazon.com","amazon.com.mx","amazon.co.uk","amazon.ca","amazon.de","amazon.es","amazon.fr","amazon.it","amazon.nl","walmart.com","shopify.com"],"description":"Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). If \"all\" is specified then the scope is all marketplaces. This union is subject to expand as new marketplaces are added."},"required":true,"description":"Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). If \"all\" is specified then the scope is all marketplaces. This union is subject to expand as new marketplaces are added.","name":"marketplace","in":"query"}],"responses":{"200":{"description":"List brands","content":{"application/json":{"schema":{"type":"object","properties":{"brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the brand"},"name":{"type":"string","description":"The name of the brand"},"active":{"type":"boolean","description":"Whether the brand is active in Levanta"},"image":{"type":"string"},"bio":{"type":"string"},"url":{"type":"string"},"marketplace":{"type":"string","enum":["amazon.com","amazon.com.mx","amazon.co.uk","amazon.ca","amazon.de","amazon.es","amazon.fr","amazon.it","amazon.nl","walmart.com","shopify.com"],"description":"Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). This union is subject to expand as new marketplaces are added."}},"required":["id","name","active","image","bio","url","marketplace"]}},"cursor":{"type":["string","null"],"description":"The cursor to use for the next request, if empty there are no more items to return"}},"required":["brands","cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/creators/active":{"get":{"operationId":"SellerListCreatorsV2","tags":["Creators"],"summary":"List Creators","description":"List creators that you have an active partnership with. Filter by brand IDs.","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":25,"description":"The maximum number of items to return"},"required":false,"description":"The maximum number of items to return","name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512,"description":"The cursor returned from the last request, if omitted the first page will be returned"},"required":false,"description":"The cursor returned from the last request, if omitted the first page will be returned","name":"cursor","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"brand_ids","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"creators":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string","description":"Creator email address. Included if the creator and seller have an active partnership."},"bio":{"type":"string"},"partneredBrandIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Array of brand IDs belonging to this seller that the creator has an active partnership with."}},"required":["id","name","bio","partneredBrandIds"]}},"cursor":{"type":["string","null"],"description":"The cursor to use for the next request, if empty there are no more items to return"}},"required":["creators","cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/creators/{id}":{"get":{"summary":"Get Creator by ID","tags":["Creators"],"operationId":"SellerGetCreatorV2","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Get a creator","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string","description":"Creator email address. Included if the creator and seller have an active partnership."},"bio":{"type":"string"},"partneredBrandIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Array of brand IDs belonging to this seller that the creator has an active partnership with."}},"required":["id","name","bio","partneredBrandIds"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"404":{"description":"Creator not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[404]},"message":{"type":"string","enum":["Creator not found"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/products":{"get":{"operationId":"SellerListProductsV2","tags":["Products"],"summary":"List Products","description":"List your products across brands. Filter by brand IDs and product IDs.","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":25,"description":"The maximum number of items to return"},"required":false,"description":"The maximum number of items to return","name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512,"description":"The cursor returned from the last request, if omitted the first page will be returned"},"required":false,"description":"The cursor returned from the last request, if omitted the first page will be returned","name":"cursor","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"brand_ids","in":"query"},{"schema":{"type":"string","description":"Filter products by their primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)"},"required":false,"description":"Filter products by their primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)","name":"product_ids","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"active","in":"query"},{"schema":{"type":"string","enum":["all","amazon.com","amazon.com.mx","amazon.co.uk","amazon.ca","amazon.de","amazon.es","amazon.fr","amazon.it","amazon.nl","walmart.com","shopify.com"],"description":"Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). If \"all\" is specified then the scope is all marketplaces. This union is subject to expand as new marketplaces are added."},"required":true,"description":"Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). If \"all\" is specified then the scope is all marketplaces. This union is subject to expand as new marketplaces are added.","name":"marketplace","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"primaryId":{"type":"string","description":"Primary product identifier for the marketplace (ASIN, Walmart Item ID, or Shopify Variant ID)"},"pricing":{"type":"object","properties":{"price":{"type":"number"},"currency":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"]}},"required":["price","currency"]},"commissionPercentage":{"type":"number"},"title":{"type":"string"},"inStock":{"type":"boolean"},"category":{"type":"string"},"brandId":{"type":"string","format":"uuid"},"active":{"type":"boolean","description":"Whether the product is active in Levanta"},"marketplace":{"type":"string","enum":["amazon.com","amazon.com.mx","amazon.co.uk","amazon.ca","amazon.de","amazon.es","amazon.fr","amazon.it","amazon.nl","walmart.com","shopify.com"],"description":"Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). This union is subject to expand as new marketplaces are added."}},"required":["primaryId","pricing","commissionPercentage","title","inStock","category","brandId","active","marketplace"]}},"cursor":{"type":["string","null"],"description":"The cursor to use for the next request, if empty there are no more items to return"}},"required":["products","cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/reports/performance/date":{"get":{"operationId":"SellerListPerformanceReportsByDateV2","tags":["Reports"],"summary":"List Performance Reports by Date","description":"Aggregated performance metrics across all marketplaces, grouped by date.","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"start","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"end","in":"query"},{"schema":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"],"default":"USD","description":"Target currency for monetary metrics. Defaults to USD."},"required":false,"description":"Target currency for monetary metrics. Defaults to USD.","name":"currency","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of marketplaces to include. Defaults to all marketplaces."},"required":false,"description":"Comma-delimited list of marketplaces to include. Defaults to all marketplaces.","name":"marketplaces","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"brandIds","in":"query"},{"schema":{"type":"string","description":"Filter by product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)"},"required":false,"description":"Filter by product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)","name":"productIds","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"creatorIds","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"],"description":"Currency of all monetary metrics."},"rows":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"ISO date (yyyy-MM-dd)"},"metrics":{"type":"object","properties":{"clicks":{"type":"number"},"sales":{"type":"string","description":"Total sales as a decimal string with 2 places (e.g. \"12.34\")."},"commission":{"type":"string","description":"Total commission as a decimal string with 2 places (e.g. \"12.34\")."},"conversions":{"type":"number"},"addToCarts":{"type":"number","description":"Amazon-only metric. Always 0 for Shopify/Walmart data."},"detailPageViews":{"type":"number","description":"Amazon-only metric. Always 0 for Shopify/Walmart data."},"brandReferralBonus":{"type":"string","description":"Brand referral bonus as a decimal string with 2 places (e.g. \"12.34\")."}},"required":["clicks","sales","commission","conversions","addToCarts","detailPageViews","brandReferralBonus"]}},"required":["date","metrics"]}}},"required":["currency","rows"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/reports/performance/product":{"get":{"operationId":"SellerListPerformanceReportsByProductV2","tags":["Reports"],"summary":"List Performance Reports by Product","description":"Aggregated performance metrics across all marketplaces, grouped by product.","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"start","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"end","in":"query"},{"schema":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"],"default":"USD","description":"Target currency for monetary metrics. Defaults to USD."},"required":false,"description":"Target currency for monetary metrics. Defaults to USD.","name":"currency","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of marketplaces to include. Defaults to all marketplaces."},"required":false,"description":"Comma-delimited list of marketplaces to include. Defaults to all marketplaces.","name":"marketplaces","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"brandIds","in":"query"},{"schema":{"type":"string","description":"Filter by product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)"},"required":false,"description":"Filter by product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)","name":"productIds","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"creatorIds","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":25,"description":"The maximum number of items to return"},"required":false,"description":"The maximum number of items to return","name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512,"description":"The cursor returned from the last request, if omitted the first page will be returned"},"required":false,"description":"The cursor returned from the last request, if omitted the first page will be returned","name":"cursor","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"],"description":"Currency of all monetary metrics."},"rows":{"type":"array","items":{"type":"object","properties":{"product":{"type":["object","null"],"properties":{"primaryId":{"type":"string","description":"Product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)"},"title":{"type":"string"},"marketplace":{"type":"string","enum":["amazon.com","amazon.com.mx","amazon.co.uk","amazon.ca","amazon.de","amazon.es","amazon.fr","amazon.it","amazon.nl","walmart.com","shopify.com"],"description":"Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com). This union is subject to expand as new marketplaces are added."}},"required":["primaryId","title","marketplace"],"description":"Null if the sales are not attributed to a product in Levanta."},"metrics":{"type":"object","properties":{"clicks":{"type":"number"},"sales":{"type":"string","description":"Total sales as a decimal string with 2 places (e.g. \"12.34\")."},"commission":{"type":"string","description":"Total commission as a decimal string with 2 places (e.g. \"12.34\")."},"conversions":{"type":"number"},"addToCarts":{"type":"number","description":"Amazon-only metric. Always 0 for Shopify/Walmart data."},"detailPageViews":{"type":"number","description":"Amazon-only metric. Always 0 for Shopify/Walmart data."},"brandReferralBonus":{"type":"string","description":"Brand referral bonus as a decimal string with 2 places (e.g. \"12.34\")."}},"required":["clicks","sales","commission","conversions","addToCarts","detailPageViews","brandReferralBonus"]}},"required":["product","metrics"]}},"cursor":{"type":["string","null"],"description":"The cursor to use for the next request, if empty there are no more items to return"}},"required":["currency","rows","cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/reports/performance/brand":{"get":{"operationId":"SellerListPerformanceReportsByBrandV2","tags":["Reports"],"summary":"List Performance Reports by Brand","description":"Aggregated performance metrics across all marketplaces, grouped by brand.","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"start","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"end","in":"query"},{"schema":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"],"default":"USD","description":"Target currency for monetary metrics. Defaults to USD."},"required":false,"description":"Target currency for monetary metrics. Defaults to USD.","name":"currency","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of marketplaces to include. Defaults to all marketplaces."},"required":false,"description":"Comma-delimited list of marketplaces to include. Defaults to all marketplaces.","name":"marketplaces","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"brandIds","in":"query"},{"schema":{"type":"string","description":"Filter by product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)"},"required":false,"description":"Filter by product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)","name":"productIds","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"creatorIds","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":25,"description":"The maximum number of items to return"},"required":false,"description":"The maximum number of items to return","name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512,"description":"The cursor returned from the last request, if omitted the first page will be returned"},"required":false,"description":"The cursor returned from the last request, if omitted the first page will be returned","name":"cursor","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"],"description":"Currency of all monetary metrics."},"rows":{"type":"array","items":{"type":"object","properties":{"brand":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"],"description":"Null if sales are not attributed to a brand in Levanta."},"metrics":{"type":"object","properties":{"clicks":{"type":"number"},"sales":{"type":"string","description":"Total sales as a decimal string with 2 places (e.g. \"12.34\")."},"commission":{"type":"string","description":"Total commission as a decimal string with 2 places (e.g. \"12.34\")."},"conversions":{"type":"number"},"addToCarts":{"type":"number","description":"Amazon-only metric. Always 0 for Shopify/Walmart data."},"detailPageViews":{"type":"number","description":"Amazon-only metric. Always 0 for Shopify/Walmart data."},"brandReferralBonus":{"type":"string","description":"Brand referral bonus as a decimal string with 2 places (e.g. \"12.34\")."}},"required":["clicks","sales","commission","conversions","addToCarts","detailPageViews","brandReferralBonus"]}},"required":["brand","metrics"]}},"cursor":{"type":["string","null"],"description":"The cursor to use for the next request, if empty there are no more items to return"}},"required":["currency","rows","cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/reports/performance/creator":{"get":{"operationId":"SellerListPerformanceReportsByCreatorV2","tags":["Reports"],"summary":"List Performance Reports by Creator","description":"Aggregated performance metrics across all marketplaces, grouped by creator.","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"start","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"end","in":"query"},{"schema":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"],"default":"USD","description":"Target currency for monetary metrics. Defaults to USD."},"required":false,"description":"Target currency for monetary metrics. Defaults to USD.","name":"currency","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of marketplaces to include. Defaults to all marketplaces."},"required":false,"description":"Comma-delimited list of marketplaces to include. Defaults to all marketplaces.","name":"marketplaces","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"brandIds","in":"query"},{"schema":{"type":"string","description":"Filter by product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)"},"required":false,"description":"Filter by product primary ID (ASIN, Walmart Item ID, or Shopify Variant ID)","name":"productIds","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"creatorIds","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":25,"description":"The maximum number of items to return"},"required":false,"description":"The maximum number of items to return","name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512,"description":"The cursor returned from the last request, if omitted the first page will be returned"},"required":false,"description":"The cursor returned from the last request, if omitted the first page will be returned","name":"cursor","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","enum":["USD","GBP","CAD","EUR","MXN"],"description":"Currency of all monetary metrics."},"rows":{"type":"array","items":{"type":"object","properties":{"creator":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"],"description":"Null if sales are not attributed to a creator in Levanta."},"metrics":{"type":"object","properties":{"clicks":{"type":"number"},"sales":{"type":"string","description":"Total sales as a decimal string with 2 places (e.g. \"12.34\")."},"commission":{"type":"string","description":"Total commission as a decimal string with 2 places (e.g. \"12.34\")."},"conversions":{"type":"number"},"addToCarts":{"type":"number","description":"Amazon-only metric. Always 0 for Shopify/Walmart data."},"detailPageViews":{"type":"number","description":"Amazon-only metric. Always 0 for Shopify/Walmart data."},"brandReferralBonus":{"type":"string","description":"Brand referral bonus as a decimal string with 2 places (e.g. \"12.34\")."}},"required":["clicks","sales","commission","conversions","addToCarts","detailPageViews","brandReferralBonus"]}},"required":["creator","metrics"]}},"cursor":{"type":["string","null"],"description":"The cursor to use for the next request, if empty there are no more items to return"}},"required":["currency","rows","cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}},"/reports/conversions":{"get":{"operationId":"SellerListConversionsV2","tags":["Reports"],"summary":"List Conversions","description":"Conversion-level sales data for Walmart and Shopify. Date range must not exceed 60 days.","security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"start","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"required":true,"description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ","name":"end","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of marketplaces to include (walmart.com, shopify.com). Amazon is not supported."},"required":false,"description":"Comma-delimited list of marketplaces to include (walmart.com, shopify.com). Amazon is not supported.","name":"marketplaces","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"brandIds","in":"query"},{"schema":{"type":"string","description":"Filter by product primary ID (Walmart Item ID or Shopify Variant ID). ASINs are not supported."},"required":false,"description":"Filter by product primary ID (Walmart Item ID or Shopify Variant ID). ASINs are not supported.","name":"productIds","in":"query"},{"schema":{"type":"string","description":"Comma-delimited list of UUIDs representing an array"},"required":false,"description":"Comma-delimited list of UUIDs representing an array","name":"creatorIds","in":"query"},{"schema":{"type":"string","maxLength":512,"description":"The cursor returned from the last request, if omitted the first page will be returned"},"required":false,"description":"The cursor returned from the last request, if omitted the first page will be returned","name":"cursor","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":500,"default":100,"description":"The maximum number of items to return"},"required":false,"description":"The maximum number of items to return","name":"limit","in":"query"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"conversions":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Date in ISO Format without offset (UTC): YYYY-MM-DDTHH:mm:ss.SSSZ"},"id":{"type":"string"},"orderId":{"type":"string"},"quantity":{"type":"number"},"marketplace":{"type":"string","enum":["walmart.com","shopify.com"]},"sales":{"type":"string","description":"Conversion sales amount as a decimal string with 2 places (e.g. \"12.34\")."},"commissionAmount":{"type":"string","description":"Total commission for the conversion as a decimal string with 2 places (e.g. \"12.34\")."},"currency":{"type":"string","enum":["AED","AUD","BRL","CAD","EUR","INR","JPY","MXN","SAR","SEK","TRY","GBP","USD"],"description":"All conversion amounts are specified in this currency."},"brandId":{"type":["string","null"],"format":"uuid"},"creatorId":{"type":"string","format":"uuid","description":"Creator team UUID."},"subId1":{"type":"string"},"subId2":{"type":"string"},"subId3":{"type":"string"},"product":{"type":"object","properties":{"primaryId":{"type":"string","description":"Product primary ID (Walmart Item ID or Shopify Variant ID)."},"title":{"type":"string"},"ids":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","enum":["ASIN","SKU","GTIN","Walmart Item ID","Variant ID"]},"value":{"type":"string"}},"required":["label","value"]}}},"required":["primaryId","title","ids"]},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED","PAID"]}},"required":["date","id","orderId","quantity","marketplace","sales","commissionAmount","currency","brandId","creatorId","subId1","subId2","subId3","product","status"]}},"cursor":{"type":["string","null"],"description":"The cursor to use for the next request, if empty there are no more items to return"}},"required":["conversions","cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[401]},"message":{"type":"string","enum":["Unauthorized"]}},"required":["status","message"]}}}},"422":{"description":"Input Validation Failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","enum":[422]},"message":{"type":"string","enum":["Input Validation Failed"]}},"required":["status","message"]}}}}}}}},"webhooks":{}}