15055 lines
495 KiB
YAML
15055 lines
495 KiB
YAML
openapi: 3.0.0
|
|
info:
|
|
version: 1.0.0
|
|
title: Medusa Admin API
|
|
description: >-
|
|
API reference for Medusa's Admin endpoints. All endpoints are prefixed with
|
|
`/admin`.
|
|
license:
|
|
name: MIT
|
|
url: 'https://github.com/medusajs/medusa/blob/master/LICENSE'
|
|
tags:
|
|
- name: Auth
|
|
description: >-
|
|
Auth endpoints that allow authorization of admin Users and manages their
|
|
sessions.
|
|
- name: App
|
|
description: App endpoints that allow handling apps in Medusa.
|
|
x-resourceId: OAuth
|
|
- name: Batch Job
|
|
description: Batch Job endpoints that allow handling batch jobs in Medusa.
|
|
x-resourceId: batch_job
|
|
- name: Claim
|
|
description: Claim endpoints that allow handling claims in Medusa.
|
|
x-resourceId: claim_order
|
|
- name: Collection
|
|
description: Collection endpoints that allow handling collections in Medusa.
|
|
x-resourceId: product_collection
|
|
- name: Customer
|
|
description: Customer endpoints that allow handling customers in Medusa.
|
|
x-resourceId: customer
|
|
- name: Customer Group
|
|
description: Customer Group endpoints that allow handling customer groups in Medusa.
|
|
x-resourceId: customer_group
|
|
- name: Discount
|
|
description: Discount endpoints that allow handling discounts in Medusa.
|
|
x-resourceId: discount
|
|
- name: Discount Condition
|
|
description: >-
|
|
Discount Condition endpoints that allow handling discount conditions in
|
|
Medusa.
|
|
x-resourceId: discount_condition
|
|
- name: Draft Order
|
|
description: Draft Order endpoints that allow handling draft orders in Medusa.
|
|
x-resourceId: draft-order
|
|
- name: Gift Card
|
|
description: Gift Card endpoints that allow handling gift cards in Medusa.
|
|
x-resourceId: gift_card
|
|
- name: Invite
|
|
description: Invite endpoints that allow handling invites in Medusa.
|
|
x-resourceId: invite
|
|
- name: Note
|
|
description: Note endpoints that allow handling notes in Medusa.
|
|
x-resourceId: note
|
|
- name: Notification
|
|
description: Notification endpoints that allow handling notifications in Medusa.
|
|
x-resourceId: notification
|
|
- name: Order
|
|
description: Order endpoints that allow handling orders in Medusa.
|
|
x-resourceId: order
|
|
- name: Price List
|
|
description: Price List endpoints that allow handling price lists in Medusa.
|
|
x-resourceId: price_list
|
|
- name: Product
|
|
description: Product endpoints that allow handling products in Medusa.
|
|
x-resourceId: product
|
|
- name: Product Tag
|
|
description: Product Tag endpoints that allow handling product tags in Medusa.
|
|
x-resourceId: product_tag
|
|
- name: Product Types
|
|
description: Product Types endpoints that allow handling product types in Medusa.
|
|
x-resourceId: product_type
|
|
- name: Product Variant
|
|
description: Product Variant endpoints that allow handling product variants in Medusa.
|
|
x-resourceId: product_variant
|
|
- name: Region
|
|
description: Region endpoints that allow handling regions in Medusa.
|
|
x-resourceId: region
|
|
- name: Return Reason
|
|
description: Return Reason endpoints that allow handling return reasons in Medusa.
|
|
x-resourceId: return_reason
|
|
- name: Return
|
|
description: Return endpoints that allow handling returns in Medusa.
|
|
x-resourceId: return
|
|
- name: Sales Channel
|
|
description: Sales Channel endpoints that allow handling sales channels in Medusa.
|
|
x-resourceId: sales_channel
|
|
- name: Shipping Option
|
|
description: Shipping Option endpoints that allow handling shipping options in Medusa.
|
|
x-resourceId: shipping_option
|
|
- name: Shipping Profile
|
|
description: >-
|
|
Shipping Profile endpoints that allow handling shipping profiles in
|
|
Medusa.
|
|
x-resourceId: shipping_profile
|
|
- name: Store
|
|
description: Store endpoints that allow handling stores in Medusa.
|
|
x-resourceId: store
|
|
- name: Swap
|
|
description: Swap endpoints that allow handling swaps in Medusa.
|
|
x-resourceId: swap
|
|
- name: Tax Rate
|
|
description: Tax Rate endpoints that allow handling tax rates in Medusa.
|
|
x-resourceId: tax_rate
|
|
- name: Upload
|
|
description: Upload endpoints that allow handling uploads in Medusa.
|
|
- name: User
|
|
description: User endpoints that allow handling users in Medusa.
|
|
x-resourceId: user
|
|
servers:
|
|
- url: 'https://api.medusa-commerce.com/admin'
|
|
paths:
|
|
/apps/authorizations:
|
|
post:
|
|
operationId: PostApps
|
|
summary: Generates a token for an application.
|
|
description: Generates a token for an application.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- application_name
|
|
- state
|
|
- code
|
|
properties:
|
|
application_name:
|
|
type: string
|
|
description: Name of the application for the token to be generated for.
|
|
state:
|
|
type: string
|
|
description: State of the application.
|
|
code:
|
|
type: string
|
|
description: The code for the generated token.
|
|
tags:
|
|
- App
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
apps:
|
|
$ref: '#/components/schemas/OAuth'
|
|
/apps:
|
|
get:
|
|
operationId: GetApps
|
|
summary: List applications
|
|
description: Retrieve a list of applications.
|
|
x-authenticated: true
|
|
tags:
|
|
- App
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
apps:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/OAuth'
|
|
/auth:
|
|
post:
|
|
operationId: PostAuth
|
|
summary: Authenticate a User
|
|
x-authenticated: false
|
|
description: Logs a User in and authorizes them to manage Store settings.
|
|
parameters: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required:
|
|
- email
|
|
- password
|
|
properties:
|
|
email:
|
|
type: string
|
|
description: The User's email.
|
|
password:
|
|
type: string
|
|
description: The User's password.
|
|
tags:
|
|
- Auth
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
user:
|
|
$ref: '#/components/schemas/user'
|
|
'401':
|
|
description: The user doesn't exist or the credentials are incorrect.
|
|
delete:
|
|
operationId: DeleteAuth
|
|
summary: Delete Session
|
|
x-authenticated: true
|
|
description: Deletes the current session for the logged in user.
|
|
tags:
|
|
- Auth
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
get:
|
|
operationId: GetAuth
|
|
summary: Get Session
|
|
x-authenticated: true
|
|
description: Gets the currently logged in User.
|
|
tags:
|
|
- Auth
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
user:
|
|
$ref: '#/components/schemas/user'
|
|
'400':
|
|
description: An error occurred.
|
|
'/batch-jobs/{id}/cancel':
|
|
post:
|
|
operationId: PostBatchJobsBatchJobCancel
|
|
summary: Marks a batch job as canceled
|
|
description: Marks a batch job as canceled
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the batch job.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Batch Job
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
batch_job:
|
|
$ref: '#/components/schemas/batch_job'
|
|
'/batch-jobs/{id}/confirm':
|
|
post:
|
|
operationId: PostBatchJobsBatchJobConfirmProcessing
|
|
summary: Confirm a batch job
|
|
description: Confirms that a previously requested batch job should be executed.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the batch job.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Batch Job
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
batch_job:
|
|
$ref: '#/components/schemas/batch_job'
|
|
/batch-jobs:
|
|
post:
|
|
operationId: PostBatchJobs
|
|
summary: Create a Batch Job
|
|
description: Creates a Batch Job.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- type
|
|
- context
|
|
properties:
|
|
type:
|
|
type: string
|
|
description: The type of batch job to start.
|
|
example: product-export
|
|
context:
|
|
type: object
|
|
description: >-
|
|
Additional infomration regarding the batch to be used for
|
|
processing.
|
|
example:
|
|
shape:
|
|
prices:
|
|
- region: null
|
|
currency_code: eur
|
|
dynamicImageColumnCount: 4
|
|
dynamicOptionColumnCount: 2
|
|
list_config:
|
|
skip: 0
|
|
take: 50
|
|
order:
|
|
created_at: DESC
|
|
relations:
|
|
- variants
|
|
- variant.prices
|
|
- images
|
|
dry_run:
|
|
type: boolean
|
|
description: >-
|
|
Set a batch job in dry_run mode to get some information on
|
|
what will be done without applying any modifications.
|
|
default: false
|
|
tags:
|
|
- Batch Job
|
|
responses:
|
|
'201':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
batch_job:
|
|
$ref: '#/components/schemas/batch_job'
|
|
get:
|
|
operationId: GetBatchJobs
|
|
summary: List Batch Jobs
|
|
description: Retrieve a list of Batch Jobs.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The number of batch jobs to return.
|
|
schema:
|
|
type: integer
|
|
default: 10
|
|
- in: query
|
|
name: offset
|
|
description: The number of batch jobs to skip before results.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: id
|
|
style: form
|
|
explode: false
|
|
description: Filter by the batch ID
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
description: batch job ID
|
|
- type: array
|
|
description: multiple batch job IDs
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: type
|
|
style: form
|
|
explode: false
|
|
description: Filter by the batch type
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: confirmed_at
|
|
style: form
|
|
explode: false
|
|
description: >-
|
|
Date comparison for when resulting collections was confirmed, i.e.
|
|
less than, greater than etc.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: pre_processed_at
|
|
style: form
|
|
explode: false
|
|
description: >-
|
|
Date comparison for when resulting collections was pre processed,
|
|
i.e. less than, greater than etc.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: completed_at
|
|
style: form
|
|
explode: false
|
|
description: >-
|
|
Date comparison for when resulting collections was completed, i.e.
|
|
less than, greater than etc.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: failed_at
|
|
style: form
|
|
explode: false
|
|
description: >-
|
|
Date comparison for when resulting collections was failed, i.e. less
|
|
than, greater than etc.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: canceled_at
|
|
style: form
|
|
explode: false
|
|
description: >-
|
|
Date comparison for when resulting collections was canceled, i.e.
|
|
less than, greater than etc.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: order
|
|
description: Field used to order retrieved batch jobs
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each order of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in each order of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: created_at
|
|
style: form
|
|
explode: false
|
|
description: >-
|
|
Date comparison for when resulting collections was created, i.e.
|
|
less than, greater than etc.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
style: form
|
|
explode: false
|
|
description: >-
|
|
Date comparison for when resulting collections was updated, i.e.
|
|
less than, greater than etc.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
tags:
|
|
- Batch Job
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
batch_jobs:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/batch_job'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/batch-jobs/{id}':
|
|
get:
|
|
operationId: GetBatchJobsBatchJob
|
|
summary: Retrieve a Batch Job
|
|
description: Retrieves a Batch Job.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Batch Job
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Batch Job
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
batch_job:
|
|
$ref: '#/components/schemas/batch_job'
|
|
'/collections/{id}/products/batch':
|
|
post:
|
|
operationId: PostProductsToCollection
|
|
summary: Updates products associated with a Product Collection
|
|
description: Updates products associated with a Product Collection
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Collection.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- product_ids
|
|
properties:
|
|
product_ids:
|
|
description: An array of Product IDs to add to the Product Collection.
|
|
type: array
|
|
items:
|
|
description: The ID of a Product to add to the Product Collection.
|
|
type: string
|
|
tags:
|
|
- Collection
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
collection:
|
|
$ref: '#/components/schemas/product_collection'
|
|
delete:
|
|
operationId: DeleteProductsFromCollection
|
|
summary: Removes products associated with a Product Collection
|
|
description: Removes products associated with a Product Collection
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Collection.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- product_ids
|
|
properties:
|
|
product_ids:
|
|
description: >-
|
|
An array of Product IDs to remove from the Product
|
|
Collection.
|
|
type: array
|
|
items:
|
|
description: The ID of a Product to add to the Product Collection.
|
|
type: string
|
|
tags:
|
|
- Collection
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the collection
|
|
object:
|
|
type: string
|
|
description: The type of object the removal was executed on
|
|
default: product-collection
|
|
removed_products:
|
|
description: The IDs of the products removed from the collection
|
|
type: array
|
|
items:
|
|
description: The ID of a Product to add to the Product Collection.
|
|
type: string
|
|
/collections:
|
|
post:
|
|
operationId: PostCollections
|
|
summary: Create a Product Collection
|
|
description: Creates a Product Collection.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- title
|
|
properties:
|
|
title:
|
|
type: string
|
|
description: The title to identify the Collection by.
|
|
handle:
|
|
type: string
|
|
description: >-
|
|
An optional handle to be used in slugs, if none is provided
|
|
we will kebab-case the title.
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Collection
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
collection:
|
|
$ref: '#/components/schemas/product_collection'
|
|
get:
|
|
operationId: GetCollections
|
|
summary: List Product Collections
|
|
description: Retrieve a list of Product Collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The number of collections to return.
|
|
schema:
|
|
type: integer
|
|
default: 10
|
|
- in: query
|
|
name: offset
|
|
description: The number of collections to skip before the results.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: title
|
|
description: The title of collections to return.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: handle
|
|
description: The handle of collections to return.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: q
|
|
description: a search term to search titles and handles.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting collections were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting collections were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: deleted_at
|
|
description: Date comparison for when resulting collections were deleted.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
tags:
|
|
- Collection
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
collections:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_collection'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/collections/{id}':
|
|
delete:
|
|
operationId: DeleteCollectionsCollection
|
|
summary: Delete a Product Collection
|
|
description: Deletes a Product Collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Collection.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Collection
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Collection
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: product-collection
|
|
deleted:
|
|
type: boolean
|
|
description: Whether the collection was deleted successfully or not.
|
|
default: true
|
|
get:
|
|
operationId: GetCollectionsCollection
|
|
summary: Retrieve a Product Collection
|
|
description: Retrieves a Product Collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product Collection
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Collection
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
collection:
|
|
$ref: '#/components/schemas/product_collection'
|
|
post:
|
|
operationId: PostCollectionsCollection
|
|
summary: Update a Product Collection
|
|
description: Updates a Product Collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Collection.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
title:
|
|
type: string
|
|
description: The title to identify the Collection by.
|
|
handle:
|
|
type: string
|
|
description: >-
|
|
An optional handle to be used in slugs, if none is provided
|
|
we will kebab-case the title.
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Collection
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
collection:
|
|
$ref: '#/components/schemas/product_collection'
|
|
'/customer-groups/{id}/customers/batch':
|
|
post:
|
|
operationId: PostCustomerGroupsGroupCustomersBatch
|
|
summary: 'Add a list of customers to a customer group '
|
|
description: 'Adds a list of customers, represented by id''s, to a customer group.'
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the customer group.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- customer_ids
|
|
properties:
|
|
customer_ids:
|
|
description: The ids of the customers to add
|
|
type: array
|
|
items:
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: ID of the customer
|
|
type: string
|
|
tags:
|
|
- Customer Group
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer_group:
|
|
$ref: '#/components/schemas/customer_group'
|
|
delete:
|
|
operationId: DeleteCustomerGroupsGroupCustomerBatch
|
|
summary: 'Remove a list of customers from a customer group '
|
|
description: 'Removes a list of customers, represented by id''s, from a customer group.'
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the customer group.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- customer_ids
|
|
properties:
|
|
customer_ids:
|
|
description: The ids of the customers to remove
|
|
type: array
|
|
items:
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: ID of the customer
|
|
type: string
|
|
tags:
|
|
- Customer Group
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer_group:
|
|
$ref: '#/components/schemas/customer_group'
|
|
/customer-groups:
|
|
post:
|
|
operationId: PostCustomerGroups
|
|
summary: Create a CustomerGroup
|
|
description: Creates a CustomerGroup.
|
|
x-authenticated: true
|
|
parameters: []
|
|
tags:
|
|
- Customer Group
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer_group:
|
|
$ref: '#/components/schemas/customer_group'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required:
|
|
- name
|
|
properties:
|
|
name:
|
|
type: string
|
|
description: Name of the customer group
|
|
metadata:
|
|
type: object
|
|
description: Metadata for the customer.
|
|
get:
|
|
operationId: GetCustomerGroups
|
|
summary: Retrieve a list of customer groups
|
|
description: Retrieve a list of customer groups.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: q
|
|
description: Query used for searching customer group names.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: offset
|
|
description: How many groups to skip in the result.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: order
|
|
description: the field used to order the customer groups.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: id
|
|
style: form
|
|
explode: false
|
|
description: Filter by the customer group ID
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
description: customer group ID
|
|
- type: array
|
|
description: multiple customer group IDs
|
|
items:
|
|
type: string
|
|
- type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by IDs less than this ID
|
|
gt:
|
|
type: string
|
|
description: filter by IDs greater than this ID
|
|
lte:
|
|
type: string
|
|
description: filter by IDs less than or equal to this ID
|
|
gte:
|
|
type: string
|
|
description: filter by IDs greater than or equal to this ID
|
|
- in: query
|
|
name: name
|
|
style: form
|
|
explode: false
|
|
description: Filter by the customer group name
|
|
schema:
|
|
type: array
|
|
description: multiple customer group names
|
|
items:
|
|
type: string
|
|
description: customer group name
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting customer groups were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting customer groups were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of customer groups returned.
|
|
schema:
|
|
type: integer
|
|
default: 10
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each customer
|
|
groups of the result.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Customer Group
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer_groups:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/customer_group'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/customer-groups/{id}':
|
|
delete:
|
|
operationId: DeleteCustomerGroupsCustomerGroup
|
|
summary: Delete a CustomerGroup
|
|
description: Deletes a CustomerGroup.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Customer Group
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Customer Group
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted customer group.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: customer_group
|
|
deleted:
|
|
type: boolean
|
|
description: >-
|
|
Whether the customer group was deleted successfully or
|
|
not.
|
|
default: true
|
|
get:
|
|
operationId: GetCustomerGroupsGroup
|
|
summary: Retrieve a CustomerGroup
|
|
description: Retrieves a Customer Group.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Customer Group.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in the customer
|
|
group.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in the customer
|
|
group.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Customer Group
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer_group:
|
|
$ref: '#/components/schemas/customer_group'
|
|
post:
|
|
operationId: PostCustomerGroupsGroup
|
|
summary: Update a CustomerGroup
|
|
description: Update a CustomerGroup.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the customer group.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
name:
|
|
description: Name of the customer group
|
|
type: string
|
|
metadata:
|
|
description: Metadata for the customer.
|
|
type: object
|
|
tags:
|
|
- Customer Group
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer_group:
|
|
$ref: '#/components/schemas/customer_group'
|
|
'/customer-groups/{id}/customers':
|
|
get:
|
|
operationId: GetCustomerGroupsGroupCustomers
|
|
summary: List Customers
|
|
description: Retrieves a list of customers in a customer group
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the customer group.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Customer Group
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customers:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/customer'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
/customers:
|
|
post:
|
|
operationId: PostCustomers
|
|
summary: Create a Customer
|
|
description: Creates a Customer.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- email
|
|
- first_name
|
|
- last_name
|
|
- password
|
|
properties:
|
|
email:
|
|
type: string
|
|
description: The customer's email.
|
|
format: email
|
|
first_name:
|
|
type: string
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
description: The customer's last name.
|
|
password:
|
|
type: string
|
|
description: The customer's password.
|
|
format: password
|
|
phone:
|
|
type: string
|
|
description: The customer's phone number.
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Customer
|
|
responses:
|
|
'201':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer:
|
|
$ref: '#/components/schemas/customer'
|
|
get:
|
|
operationId: GetCustomers
|
|
summary: List Customers
|
|
description: Retrieves a list of Customers.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The number of items to return.
|
|
schema:
|
|
type: integer
|
|
default: 50
|
|
- in: query
|
|
name: offset
|
|
description: The items to skip before result.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: expand
|
|
description: (Comma separated) Which fields should be expanded in each customer.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: q
|
|
description: 'a search term to search email, first_name, and last_name.'
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Customer
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customers:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/customer'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/customers/{id}':
|
|
get:
|
|
operationId: GetCustomersCustomer
|
|
summary: Retrieve a Customer
|
|
description: Retrieves a Customer.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Customer.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: (Comma separated) Which fields should be expanded in the customer.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: (Comma separated) Which fields should be included in the customer.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Customer
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer:
|
|
$ref: '#/components/schemas/customer'
|
|
post:
|
|
operationId: PostCustomersCustomer
|
|
summary: Update a Customer
|
|
description: Updates a Customer.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Customer.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: (Comma separated) Which fields should be expanded in each customer.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: (Comma separated) Which fields should be retrieved in each customer.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
email:
|
|
type: string
|
|
description: The Customer's email.
|
|
format: email
|
|
first_name:
|
|
type: string
|
|
description: The Customer's first name.
|
|
last_name:
|
|
type: string
|
|
description: The Customer's last name.
|
|
phone:
|
|
type: string
|
|
description: The Customer's phone number.
|
|
password:
|
|
type: string
|
|
description: The Customer's password.
|
|
format: password
|
|
groups:
|
|
type: array
|
|
items:
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: The ID of a customer group
|
|
type: string
|
|
description: A list of customer groups to which the customer belongs.
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Customer
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
customer:
|
|
$ref: '#/components/schemas/customer'
|
|
'/discounts/{id}/regions/{region_id}':
|
|
post:
|
|
operationId: PostDiscountsDiscountRegionsRegion
|
|
summary: Adds Region availability
|
|
description: Adds a Region to the list of Regions that a Discount can be used in.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Discount.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: region_id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
delete:
|
|
operationId: DeleteDiscountsDiscountRegionsRegion
|
|
summary: Remove Region availability
|
|
x-authenticated: true
|
|
description: >-
|
|
Removes a Region from the list of Regions that a Discount can be used
|
|
in.
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Discount.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: region_id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
'/discounts/{discount_id}/conditions':
|
|
post:
|
|
operationId: PostDiscountsDiscountConditions
|
|
summary: >-
|
|
Creates a DiscountCondition. Only one of `products`, `product_types`,
|
|
`product_collections`, `product_tags`, and `customer_groups` should be
|
|
provided.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: discount_id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each product of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in each product of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
description: Creates a DiscountCondition
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- operator
|
|
properties:
|
|
operator:
|
|
description: Operator of the condition
|
|
type: string
|
|
enum:
|
|
- in
|
|
- not_in
|
|
products:
|
|
type: array
|
|
description: list of product IDs if the condition is applied on products.
|
|
items:
|
|
type: string
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
list of product type IDs if the condition is applied on
|
|
product types.
|
|
items:
|
|
type: string
|
|
product_collections:
|
|
type: array
|
|
description: >-
|
|
list of product collection IDs if the condition is applied
|
|
on product collections.
|
|
items:
|
|
type: string
|
|
product_tags:
|
|
type: array
|
|
description: >-
|
|
list of product tag IDs if the condition is applied on
|
|
product tags.
|
|
items:
|
|
type: string
|
|
customer_groups:
|
|
type: array
|
|
description: >-
|
|
list of customer group IDs if the condition is applied on
|
|
customer groups.
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Discount Condition
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
/discounts:
|
|
post:
|
|
operationId: PostDiscounts
|
|
summary: Creates a Discount
|
|
x-authenticated: true
|
|
description: >-
|
|
Creates a Discount with a given set of rules that define how the
|
|
Discount behaves.
|
|
parameters:
|
|
- in: query
|
|
name: expand
|
|
description: (Comma separated) Which fields should be expanded in each customer.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: (Comma separated) Which fields should be retrieved in each customer.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- code
|
|
- rule
|
|
properties:
|
|
code:
|
|
type: string
|
|
description: A unique code that will be used to redeem the Discount
|
|
is_dynamic:
|
|
type: boolean
|
|
description: >-
|
|
Whether the Discount should have multiple instances of
|
|
itself, each with a different code. This can be useful for
|
|
automatically generated codes that all have to follow a
|
|
common set of rules.
|
|
default: false
|
|
rule:
|
|
description: The Discount Rule that defines how Discounts are calculated
|
|
type: object
|
|
required:
|
|
- type
|
|
- value
|
|
- allocation
|
|
properties:
|
|
description:
|
|
type: string
|
|
description: A short description of the discount
|
|
type:
|
|
type: string
|
|
description: >-
|
|
The type of the Discount, can be `fixed` for discounts
|
|
that reduce the price by a fixed amount, `percentage`
|
|
for percentage reductions or `free_shipping` for
|
|
shipping vouchers.
|
|
enum:
|
|
- fixed
|
|
- percentage
|
|
- free_shipping
|
|
value:
|
|
type: number
|
|
description: >-
|
|
The value that the discount represents; this will depend
|
|
on the type of the discount
|
|
allocation:
|
|
type: string
|
|
description: The scope that the discount should apply to.
|
|
enum:
|
|
- total
|
|
- item
|
|
conditions:
|
|
type: array
|
|
description: >-
|
|
A set of conditions that can be used to limit when the
|
|
discount can be used. Only one of `products`,
|
|
`product_types`, `product_collections`, `product_tags`,
|
|
and `customer_groups` should be provided.
|
|
items:
|
|
type: object
|
|
required:
|
|
- operator
|
|
properties:
|
|
operator:
|
|
type: string
|
|
description: Operator of the condition
|
|
enum:
|
|
- in
|
|
- not_in
|
|
products:
|
|
type: array
|
|
description: >-
|
|
list of product IDs if the condition is applied on
|
|
products.
|
|
items:
|
|
type: string
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
list of product type IDs if the condition is
|
|
applied on product types.
|
|
items:
|
|
type: string
|
|
product_collections:
|
|
type: array
|
|
description: >-
|
|
list of product collection IDs if the condition is
|
|
applied on product collections.
|
|
items:
|
|
type: string
|
|
product_tags:
|
|
type: array
|
|
description: >-
|
|
list of product tag IDs if the condition is
|
|
applied on product tags.
|
|
items:
|
|
type: string
|
|
customer_groups:
|
|
type: array
|
|
description: >-
|
|
list of customer group IDs if the condition is
|
|
applied on customer groups.
|
|
items:
|
|
type: string
|
|
is_disabled:
|
|
type: boolean
|
|
description: >-
|
|
Whether the Discount code is disabled on creation. You will
|
|
have to enable it later to make it available to Customers.
|
|
default: false
|
|
starts_at:
|
|
type: string
|
|
format: date-time
|
|
description: The time at which the Discount should be available.
|
|
ends_at:
|
|
type: string
|
|
format: date-time
|
|
description: >-
|
|
The time at which the Discount should no longer be
|
|
available.
|
|
valid_duration:
|
|
type: string
|
|
description: Duration the discount runs between
|
|
example: P3Y6M4DT12H30M5S
|
|
regions:
|
|
description: >-
|
|
A list of Region ids representing the Regions in which the
|
|
Discount can be used.
|
|
type: array
|
|
items:
|
|
type: string
|
|
usage_limit:
|
|
type: number
|
|
description: Maximum times the discount can be used
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
get:
|
|
operationId: GetDiscounts
|
|
summary: List Discounts
|
|
x-authenticated: true
|
|
description: Retrieves a list of Discounts
|
|
parameters:
|
|
- in: query
|
|
name: q
|
|
description: Search query applied on the code field.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: rule
|
|
description: Discount Rules filters to apply on the search
|
|
schema:
|
|
type: object
|
|
properties:
|
|
type:
|
|
type: string
|
|
enum:
|
|
- fixed
|
|
- percentage
|
|
- free_shipping
|
|
description: >-
|
|
The type of the Discount, can be `fixed` for discounts that
|
|
reduce the price by a fixed amount, `percentage` for
|
|
percentage reductions or `free_shipping` for shipping
|
|
vouchers.
|
|
allocation:
|
|
type: string
|
|
enum:
|
|
- total
|
|
- item
|
|
description: >-
|
|
The value that the discount represents; this will depend on
|
|
the type of the discount
|
|
- in: query
|
|
name: is_dynamic
|
|
description: Return only dynamic discounts.
|
|
schema:
|
|
type: boolean
|
|
- in: query
|
|
name: is_disabled
|
|
description: Return only disabled discounts.
|
|
schema:
|
|
type: boolean
|
|
- in: query
|
|
name: limit
|
|
description: The number of items in the response
|
|
schema:
|
|
type: number
|
|
default: '20'
|
|
- in: query
|
|
name: offset
|
|
description: The offset of items in response
|
|
schema:
|
|
type: number
|
|
default: '0'
|
|
- in: query
|
|
name: expand
|
|
description: Comma separated list of relations to include in the results.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discounts:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/discount'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/discounts/{id}/dynamic-codes':
|
|
post:
|
|
operationId: PostDiscountsDiscountDynamicCodes
|
|
summary: Create a dynamic Discount code
|
|
description: >-
|
|
Creates a unique code that can map to a parent Discount. This is useful
|
|
if you want to automatically generate codes with the same behaviour.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Discount to create the dynamic code from."
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required:
|
|
- code
|
|
properties:
|
|
code:
|
|
type: string
|
|
description: The unique code that will be used to redeem the Discount.
|
|
usage_limit:
|
|
type: number
|
|
default: '1'
|
|
description: amount of times the discount can be applied.
|
|
metadata:
|
|
type: object
|
|
description: >-
|
|
An optional set of key-value paris to hold additional
|
|
information.
|
|
'/discounts/{discount_id}/conditions/{condition_id}':
|
|
delete:
|
|
operationId: DeleteDiscountsDiscountConditionsCondition
|
|
summary: Delete a DiscountCondition
|
|
description: Deletes a DiscountCondition
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: discount_id
|
|
required: true
|
|
description: The ID of the Discount
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: condition_id
|
|
required: true
|
|
description: The ID of the DiscountCondition
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Comma separated list of relations to include in the results.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Comma separated list of fields to include in the results.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount Condition
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted DiscountCondition
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: discount-condition
|
|
deleted:
|
|
type: boolean
|
|
description: >-
|
|
Whether the discount condition was deleted successfully or
|
|
not.
|
|
default: true
|
|
discount:
|
|
description: The Discount to which the condition used to belong
|
|
$ref: '#/components/schemas/discount'
|
|
get:
|
|
operationId: GetDiscountsDiscountConditionsCondition
|
|
summary: Gets a DiscountCondition
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: discount_id
|
|
required: true
|
|
description: The ID of the Discount.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: condition_id
|
|
required: true
|
|
description: The ID of the DiscountCondition.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Comma separated list of relations to include in the results.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Comma separated list of fields to include in the results.
|
|
schema:
|
|
type: string
|
|
description: Gets a DiscountCondition
|
|
tags:
|
|
- Discount Condition
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount_condition:
|
|
$ref: '#/components/schemas/discount_condition'
|
|
post:
|
|
operationId: PostDiscountsDiscountConditionsCondition
|
|
summary: >-
|
|
Updates a DiscountCondition. Only one of `products`, `product_types`,
|
|
`product_collections`, `product_tags`, and `customer_groups` should be
|
|
provided.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: discount_id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: condition_id
|
|
required: true
|
|
description: The ID of the DiscountCondition.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each item of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in each item of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
description: Updates a DiscountCondition
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
products:
|
|
type: array
|
|
description: list of product IDs if the condition is applied on products.
|
|
items:
|
|
type: string
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
list of product type IDs if the condition is applied on
|
|
product types.
|
|
items:
|
|
type: string
|
|
product_collections:
|
|
type: array
|
|
description: >-
|
|
list of product collection IDs if the condition is applied
|
|
on product collections.
|
|
items:
|
|
type: string
|
|
product_tags:
|
|
type: array
|
|
description: >-
|
|
list of product tag IDs if the condition is applied on
|
|
product tags.
|
|
items:
|
|
type: string
|
|
customer_groups:
|
|
type: array
|
|
description: >-
|
|
list of customer group IDs if the condition is applied on
|
|
customer groups.
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
'/discounts/{id}':
|
|
delete:
|
|
operationId: DeleteDiscountsDiscount
|
|
summary: Delete a Discount
|
|
description: Deletes a Discount.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Discount
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Discount
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: discount
|
|
deleted:
|
|
type: boolean
|
|
description: Whether the discount was deleted successfully or not.
|
|
default: true
|
|
get:
|
|
operationId: GetDiscountsDiscount
|
|
summary: Retrieve a Discount
|
|
description: Retrieves a Discount
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Discount
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Comma separated list of relations to include in the results.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Comma separated list of fields to include in the results.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
post:
|
|
operationId: PostDiscountsDiscount
|
|
summary: Update a Discount
|
|
description: >-
|
|
Updates a Discount with a given set of rules that define how the
|
|
Discount behaves.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Discount.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each item of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in each item of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
code:
|
|
type: string
|
|
description: A unique code that will be used to redeem the Discount
|
|
rule:
|
|
description: The Discount Rule that defines how Discounts are calculated
|
|
type: object
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the Rule
|
|
description:
|
|
type: string
|
|
description: A short description of the discount
|
|
value:
|
|
type: number
|
|
description: >-
|
|
The value that the discount represents; this will depend
|
|
on the type of the discount
|
|
allocation:
|
|
type: string
|
|
description: The scope that the discount should apply to.
|
|
enum:
|
|
- total
|
|
- item
|
|
conditions:
|
|
type: array
|
|
description: >-
|
|
A set of conditions that can be used to limit when the
|
|
discount can be used. Only one of `products`,
|
|
`product_types`, `product_collections`, `product_tags`,
|
|
and `customer_groups` should be provided.
|
|
items:
|
|
type: object
|
|
required:
|
|
- operator
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the Rule
|
|
operator:
|
|
type: string
|
|
description: Operator of the condition
|
|
enum:
|
|
- in
|
|
- not_in
|
|
products:
|
|
type: array
|
|
description: >-
|
|
list of product IDs if the condition is applied on
|
|
products.
|
|
items:
|
|
type: string
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
list of product type IDs if the condition is
|
|
applied on product types.
|
|
items:
|
|
type: string
|
|
product_collections:
|
|
type: array
|
|
description: >-
|
|
list of product collection IDs if the condition is
|
|
applied on product collections.
|
|
items:
|
|
type: string
|
|
product_tags:
|
|
type: array
|
|
description: >-
|
|
list of product tag IDs if the condition is
|
|
applied on product tags.
|
|
items:
|
|
type: string
|
|
customer_groups:
|
|
type: array
|
|
description: >-
|
|
list of customer group IDs if the condition is
|
|
applied on customer groups.
|
|
items:
|
|
type: string
|
|
is_disabled:
|
|
type: boolean
|
|
description: >-
|
|
Whether the Discount code is disabled on creation. You will
|
|
have to enable it later to make it available to Customers.
|
|
starts_at:
|
|
type: string
|
|
format: date-time
|
|
description: The time at which the Discount should be available.
|
|
ends_at:
|
|
type: string
|
|
format: date-time
|
|
description: >-
|
|
The time at which the Discount should no longer be
|
|
available.
|
|
valid_duration:
|
|
type: string
|
|
description: Duration the discount runs between
|
|
example: P3Y6M4DT12H30M5S
|
|
usage_limit:
|
|
type: number
|
|
description: Maximum times the discount can be used
|
|
regions:
|
|
description: >-
|
|
A list of Region ids representing the Regions in which the
|
|
Discount can be used.
|
|
type: array
|
|
items:
|
|
type: string
|
|
metadata:
|
|
description: An object containing metadata of the discount
|
|
type: object
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
'/discounts/{id}/dynamic-codes/{code}':
|
|
delete:
|
|
operationId: DeleteDiscountsDiscountDynamicCodesCode
|
|
summary: Delete a dynamic code
|
|
description: Deletes a dynamic code from a Discount.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Discount
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: code
|
|
required: true
|
|
description: The ID of the Discount
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
'/discounts/code/{code}':
|
|
get:
|
|
operationId: GetDiscountsDiscountCode
|
|
summary: Retrieve a Discount by code
|
|
description: Retrieves a Discount by its discount code
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: code
|
|
required: true
|
|
description: The code of the Discount
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Comma separated list of relations to include in the results.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Comma separated list of fields to include in the results.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Discount
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
discount:
|
|
$ref: '#/components/schemas/discount'
|
|
/draft-orders:
|
|
post:
|
|
operationId: PostDraftOrders
|
|
summary: Create a Draft Order
|
|
description: Creates a Draft Order
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- email
|
|
- items
|
|
- region_id
|
|
- shipping_methods
|
|
properties:
|
|
status:
|
|
description: The status of the draft order
|
|
type: string
|
|
enum:
|
|
- open
|
|
- completed
|
|
email:
|
|
description: The email of the customer of the draft order
|
|
type: string
|
|
format: email
|
|
billing_address:
|
|
description: The Address to be used for billing purposes.
|
|
$ref: '#/components/schemas/address'
|
|
shipping_address:
|
|
description: The Address to be used for shipping.
|
|
$ref: '#/components/schemas/address'
|
|
items:
|
|
description: The Line Items that have been received.
|
|
type: array
|
|
items:
|
|
type: object
|
|
required:
|
|
- quantity
|
|
properties:
|
|
variant_id:
|
|
description: >-
|
|
The ID of the Product Variant to generate the Line
|
|
Item from.
|
|
type: string
|
|
unit_price:
|
|
description: The potential custom price of the item.
|
|
type: integer
|
|
title:
|
|
description: The potential custom title of the item.
|
|
type: string
|
|
quantity:
|
|
description: The quantity of the Line Item.
|
|
type: integer
|
|
metadata:
|
|
description: >-
|
|
The optional key-value map with additional details
|
|
about the Line Item.
|
|
type: object
|
|
region_id:
|
|
description: The ID of the region for the draft order
|
|
type: string
|
|
discounts:
|
|
description: The discounts to add on the draft order
|
|
type: array
|
|
items:
|
|
type: object
|
|
required:
|
|
- code
|
|
properties:
|
|
code:
|
|
description: The code of the discount to apply
|
|
type: string
|
|
customer_id:
|
|
description: The ID of the customer to add on the draft order
|
|
type: string
|
|
no_notification_order:
|
|
description: >-
|
|
An optional flag passed to the resulting order to determine
|
|
use of notifications.
|
|
type: boolean
|
|
shipping_methods:
|
|
description: The shipping methods for the draft order
|
|
type: array
|
|
items:
|
|
type: object
|
|
required:
|
|
- option_id
|
|
properties:
|
|
option_id:
|
|
description: The ID of the shipping option in use
|
|
type: string
|
|
data:
|
|
description: >-
|
|
The optional additional data needed for the shipping
|
|
method
|
|
type: object
|
|
price:
|
|
description: The potential custom price of the shipping
|
|
type: integer
|
|
metadata:
|
|
description: >-
|
|
The optional key-value map with additional details about the
|
|
Draft Order.
|
|
type: object
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
draft_order:
|
|
$ref: '#/components/schemas/draft-order'
|
|
get:
|
|
operationId: GetDraftOrders
|
|
summary: List Draft Orders
|
|
description: Retrieves an list of Draft Orders
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: offset
|
|
description: The number of items to skip before the results.
|
|
schema:
|
|
type: number
|
|
default: '0'
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of items returned.
|
|
schema:
|
|
type: number
|
|
default: '50'
|
|
- in: query
|
|
name: q
|
|
description: >-
|
|
a search term to search emails in carts associated with draft orders
|
|
and display IDs of draft orders
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
draft_orders:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/draft-order'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/draft-orders/{id}/line-items':
|
|
post:
|
|
operationId: PostDraftOrdersDraftOrderLineItems
|
|
summary: Create a Line Item for Draft Order
|
|
description: Creates a Line Item for the Draft Order
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Draft Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- quantity
|
|
properties:
|
|
variant_id:
|
|
description: >-
|
|
The ID of the Product Variant to generate the Line Item
|
|
from.
|
|
type: string
|
|
unit_price:
|
|
description: The potential custom price of the item.
|
|
type: integer
|
|
title:
|
|
description: The potential custom title of the item.
|
|
type: string
|
|
default: Custom item
|
|
quantity:
|
|
description: The quantity of the Line Item.
|
|
type: integer
|
|
metadata:
|
|
description: >-
|
|
The optional key-value map with additional details about the
|
|
Line Item.
|
|
type: object
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
draft_order:
|
|
$ref: '#/components/schemas/draft-order'
|
|
'/draft-orders/{id}':
|
|
delete:
|
|
operationId: DeleteDraftOrdersDraftOrder
|
|
summary: Delete a Draft Order
|
|
description: Deletes a Draft Order
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Draft Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Draft Order.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: draft-order
|
|
deleted:
|
|
type: boolean
|
|
description: Whether the draft order was deleted successfully or not.
|
|
default: true
|
|
get:
|
|
operationId: GetDraftOrdersDraftOrder
|
|
summary: Retrieve a Draft Order
|
|
description: Retrieves a Draft Order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Draft Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
draft_order:
|
|
$ref: '#/components/schemas/draft-order'
|
|
'/draft-orders/{id}/line-items/{line_id}':
|
|
delete:
|
|
operationId: DeleteDraftOrdersDraftOrderLineItemsItem
|
|
summary: Delete a Line Item
|
|
description: Removes a Line Item from a Draft Order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Draft Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: line_id
|
|
required: true
|
|
description: The ID of the Draft Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
draft_order:
|
|
$ref: '#/components/schemas/draft-order'
|
|
post:
|
|
operationId: PostDraftOrdersDraftOrderLineItemsItem
|
|
summary: Update a Line Item for a Draft Order
|
|
description: Updates a Line Item for a Draft Order
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Draft Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: line_id
|
|
required: true
|
|
description: The ID of the Line Item.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
unit_price:
|
|
description: The potential custom price of the item.
|
|
type: integer
|
|
title:
|
|
description: The potential custom title of the item.
|
|
type: string
|
|
quantity:
|
|
description: The quantity of the Line Item.
|
|
type: integer
|
|
metadata:
|
|
description: >-
|
|
The optional key-value map with additional details about the
|
|
Line Item.
|
|
type: object
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
draft_order:
|
|
$ref: '#/components/schemas/draft-order'
|
|
'/draft-orders/{id}/pay':
|
|
post:
|
|
summary: Registers a payment for a Draft Order
|
|
operationId: PostDraftOrdersDraftOrderRegisterPayment
|
|
description: Registers a payment for a Draft Order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The Draft Order id.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/draft-order'
|
|
'/admin/draft-orders/{id}':
|
|
post:
|
|
operationId: PostDraftOrdersDraftOrder
|
|
summary: Update a Draft Order"
|
|
description: Updates a Draft Order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Draft Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region_id:
|
|
type: string
|
|
description: The ID of the Region to create the Draft Order in.
|
|
country_code:
|
|
type: string
|
|
description: The 2 character ISO code for the Country.
|
|
externalDocs:
|
|
url: >-
|
|
https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
|
|
description: See a list of codes.
|
|
email:
|
|
type: string
|
|
description: An email to be used on the Draft Order.
|
|
format: email
|
|
billing_address:
|
|
description: The Address to be used for billing purposes.
|
|
$ref: '#/components/schemas/address'
|
|
shipping_address:
|
|
description: The Address to be used for shipping.
|
|
$ref: '#/components/schemas/address'
|
|
discounts:
|
|
description: An array of Discount codes to add to the Draft Order.
|
|
type: array
|
|
items:
|
|
type: object
|
|
required:
|
|
- code
|
|
properties:
|
|
code:
|
|
description: The code that a Discount is identifed by.
|
|
type: string
|
|
no_notification_order:
|
|
description: >-
|
|
An optional flag passed to the resulting order to determine
|
|
use of notifications.
|
|
type: boolean
|
|
customer_id:
|
|
description: The ID of the Customer to associate the Draft Order with.
|
|
type: string
|
|
tags:
|
|
- Draft Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
draft_order:
|
|
$ref: '#/components/schemas/draft-order'
|
|
/gift-cards:
|
|
post:
|
|
operationId: PostGiftCards
|
|
summary: Create a Gift Card
|
|
description: >-
|
|
Creates a Gift Card that can redeemed by its unique code. The Gift Card
|
|
is only valid within 1 region.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- region_id
|
|
properties:
|
|
value:
|
|
type: integer
|
|
description: >-
|
|
The value (excluding VAT) that the Gift Card should
|
|
represent.
|
|
is_disabled:
|
|
type: boolean
|
|
description: >-
|
|
Whether the Gift Card is disabled on creation. You will have
|
|
to enable it later to make it available to Customers.
|
|
ends_at:
|
|
type: string
|
|
format: date-time
|
|
description: >-
|
|
The time at which the Gift Card should no longer be
|
|
available.
|
|
region_id:
|
|
description: The ID of the Region in which the Gift Card can be used.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Gift Card
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
gift_card:
|
|
$ref: '#/components/schemas/gift_card'
|
|
get:
|
|
operationId: GetGiftCards
|
|
summary: List Gift Cards
|
|
description: Retrieves a list of Gift Cards.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: offset
|
|
description: The number of items to skip before the results.
|
|
schema:
|
|
type: number
|
|
default: '0'
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of items returned.
|
|
schema:
|
|
type: number
|
|
default: '50'
|
|
- in: query
|
|
name: q
|
|
description: a search term to search by code or display ID
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Gift Card
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
gift_cards:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/gift_card'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/gift-cards/{id}':
|
|
delete:
|
|
operationId: DeleteGiftCardsGiftCard
|
|
summary: Delete a Gift Card
|
|
description: Deletes a Gift Card
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Gift Card to delete.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Gift Card
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Gift Card
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: gift-card
|
|
deleted:
|
|
type: boolean
|
|
description: Whether the gift card was deleted successfully or not.
|
|
default: true
|
|
get:
|
|
operationId: GetGiftCardsGiftCard
|
|
summary: Retrieve a Gift Card
|
|
description: Retrieves a Gift Card.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Gift Card.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Gift Card
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
gift_card:
|
|
$ref: '#/components/schemas/gift_card'
|
|
post:
|
|
operationId: PostGiftCardsGiftCard
|
|
summary: Create a Gift Card
|
|
description: >-
|
|
Creates a Gift Card that can redeemed by its unique code. The Gift Card
|
|
is only valid within 1 region.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Gift Card.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
balance:
|
|
type: integer
|
|
description: >-
|
|
The value (excluding VAT) that the Gift Card should
|
|
represent.
|
|
is_disabled:
|
|
type: boolean
|
|
description: >-
|
|
Whether the Gift Card is disabled on creation. You will have
|
|
to enable it later to make it available to Customers.
|
|
ends_at:
|
|
type: string
|
|
format: date-time
|
|
description: >-
|
|
The time at which the Gift Card should no longer be
|
|
available.
|
|
region_id:
|
|
description: The ID of the Region in which the Gift Card can be used.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Gift Card
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
gift_card:
|
|
$ref: '#/components/schemas/gift_card'
|
|
/invites/accept:
|
|
post:
|
|
operationId: PostInvitesInviteAccept
|
|
summary: Accept an Invite
|
|
description: Accepts an Invite and creates a corresponding user
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- token
|
|
- user
|
|
properties:
|
|
token:
|
|
description: The invite token provided by the admin.
|
|
type: string
|
|
user:
|
|
description: The User to create.
|
|
type: object
|
|
required:
|
|
- first_name
|
|
- last_name
|
|
- password
|
|
properties:
|
|
first_name:
|
|
type: string
|
|
description: the first name of the User
|
|
last_name:
|
|
type: string
|
|
description: the last name of the User
|
|
password:
|
|
description: The desired password for the User
|
|
type: string
|
|
format: password
|
|
tags:
|
|
- Invite
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
/invites:
|
|
post:
|
|
operationId: PostInvites
|
|
summary: Create an Invite
|
|
description: Creates an Invite and triggers an 'invite' created event
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- user
|
|
- role
|
|
properties:
|
|
user:
|
|
description: The email for the user to be created.
|
|
type: string
|
|
format: email
|
|
role:
|
|
description: The role of the user to be created.
|
|
type: string
|
|
enum:
|
|
- admin
|
|
- member
|
|
- developer
|
|
tags:
|
|
- Invite
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
get:
|
|
operationId: GetInvites
|
|
summary: Lists all Invites
|
|
description: Lists all Invites
|
|
x-authenticated: true
|
|
tags:
|
|
- Invite
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
invites:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/invite'
|
|
'/invites/{invite_id}':
|
|
delete:
|
|
operationId: DeleteInvitesInvite
|
|
summary: Create an Invite
|
|
description: Creates an Invite and triggers an 'invite' created event
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: invite_id
|
|
required: true
|
|
description: The ID of the Invite
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Invite
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Invite.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
format: invite
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the Invite was deleted.
|
|
default: true
|
|
'/invites/{invite_id}/resend':
|
|
post:
|
|
operationId: PostInvitesInviteResend
|
|
summary: Resend an Invite
|
|
description: Resends an Invite by triggering the 'invite' created event again
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: invite_id
|
|
required: true
|
|
description: The ID of the Invite
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Invite
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
/notes:
|
|
post:
|
|
operationId: PostNotes
|
|
summary: Creates a Note
|
|
description: Creates a Note which can be associated with any resource as required.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- resource_id
|
|
- resource_type
|
|
- value
|
|
properties:
|
|
resource_id:
|
|
type: string
|
|
description: The ID of the resource which the Note relates to.
|
|
resource_type:
|
|
type: string
|
|
description: The type of resource which the Note relates to.
|
|
value:
|
|
type: string
|
|
description: The content of the Note to create.
|
|
tags:
|
|
- Note
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
note:
|
|
$ref: '#/components/schemas/note'
|
|
get:
|
|
operationId: GetNotes
|
|
summary: List Notes
|
|
x-authenticated: true
|
|
description: Retrieves a list of notes
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The number of notes to get
|
|
schema:
|
|
type: number
|
|
default: '50'
|
|
- in: query
|
|
name: offset
|
|
description: The offset at which to get notes
|
|
schema:
|
|
type: number
|
|
default: '0'
|
|
- in: query
|
|
name: resource_id
|
|
description: The ID which the notes belongs to
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Note
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
notes:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/note'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/notes/{id}':
|
|
delete:
|
|
operationId: DeleteNotesNote
|
|
summary: Deletes a Note
|
|
description: Deletes a Note.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Note to delete.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Note
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Note.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: note
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the Note was deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetNotesNote
|
|
summary: Get Note
|
|
description: Retrieves a single note using its id
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the note to retrieve.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Note
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
note:
|
|
$ref: '#/components/schemas/note'
|
|
post:
|
|
operationId: PostNotesNote
|
|
summary: Updates a Note
|
|
x-authenticated: true
|
|
description: Updates a Note associated with some resource
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Note to update
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
type: string
|
|
description: The updated description of the Note.
|
|
tags:
|
|
- Note
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
note:
|
|
$ref: '#/components/schemas/note'
|
|
/notifications:
|
|
get:
|
|
operationId: GetNotifications
|
|
summary: List Notifications
|
|
description: Retrieves a list of Notifications.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: offset
|
|
description: >-
|
|
The number of notifications to skip before starting to collect the
|
|
notifications set
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: limit
|
|
description: The number of notifications to return
|
|
schema:
|
|
type: integer
|
|
default: 50
|
|
- in: query
|
|
name: fields
|
|
description: Comma separated fields to include in the result set
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Comma separated fields to populate
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: event_name
|
|
description: The name of the event that the notification was sent for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: resource_type
|
|
description: The type of resource that the Notification refers to.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: resource_id
|
|
description: The ID of the resource that the Notification refers to.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: to
|
|
description: >-
|
|
The address that the Notification was sent to. This will usually be
|
|
an email address, but represent other addresses such as a chat bot
|
|
user id
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: include_resends
|
|
description: >-
|
|
A boolean indicating whether the result set should include resent
|
|
notifications or not
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Notification
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
notifications:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/notification'
|
|
'/notifications/{id}/resend':
|
|
post:
|
|
operationId: PostNotificationsNotificationResend
|
|
summary: Resend Notification
|
|
description: >-
|
|
Resends a previously sent notifications, with the same data but
|
|
optionally to a different address
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Notification
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
to:
|
|
description: >-
|
|
A new address or user identifier that the Notification
|
|
should be sent to
|
|
type: string
|
|
tags:
|
|
- Notification
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
notification:
|
|
$ref: '#/components/schemas/notification'
|
|
'/orders/{id}/shipping-methods':
|
|
post:
|
|
operationId: PostOrdersOrderShippingMethods
|
|
summary: Add a Shipping Method
|
|
description: >-
|
|
Adds a Shipping Method to an Order. If another Shipping Method exists
|
|
with the same Shipping Profile, the previous Shipping Method will be
|
|
replaced.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required:
|
|
- price
|
|
- option_id
|
|
properties:
|
|
price:
|
|
type: integer
|
|
description: >-
|
|
The price (excluding VAT) that should be charged for the
|
|
Shipping Method
|
|
option_id:
|
|
type: string
|
|
description: >-
|
|
The ID of the Shipping Option to create the Shipping Method
|
|
from.
|
|
data:
|
|
type: object
|
|
description: >-
|
|
The data required for the Shipping Option to create a
|
|
Shipping Method. This will depend on the Fulfillment
|
|
Provider.
|
|
'/orders/{id}/archive':
|
|
post:
|
|
operationId: PostOrdersOrderArchive
|
|
summary: Archive order
|
|
description: Archives the order with the given id.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/claims/{claim_id}/cancel':
|
|
post:
|
|
operationId: PostOrdersClaimCancel
|
|
summary: Cancels a Claim
|
|
description: Cancels a Claim
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: claim_id
|
|
required: true
|
|
description: The ID of the Claim.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Claim
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/claims/{claim_id}/fulfillments/{fulfillment_id}/cancel':
|
|
post:
|
|
operationId: PostOrdersClaimFulfillmentsCancel
|
|
summary: Cancels a fulfilmment related to a Claim
|
|
description: Registers a Fulfillment as canceled.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order which the Claim relates to.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: claim_id
|
|
required: true
|
|
description: The ID of the Claim which the Fulfillment relates to.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: fulfillment_id
|
|
required: true
|
|
description: The ID of the Fulfillment.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Fulfillment
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/swaps/{swap_id}/fulfillments/{fulfillment_id}/cancel':
|
|
post:
|
|
operationId: PostOrdersSwapFulfillmentsCancel
|
|
summary: Cancels a fulfilmment related to a Swap
|
|
description: Registers a Fulfillment as canceled.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order which the Swap relates to.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: swap_id
|
|
required: true
|
|
description: The ID of the Swap which the Fulfillment relates to.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: fulfillment_id
|
|
required: true
|
|
description: The ID of the Fulfillment.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Fulfillment
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/fulfillments/{fulfillment_id}/cancel':
|
|
post:
|
|
operationId: PostOrdersOrderFulfillmentsCancel
|
|
summary: Cancels a fulfilmment
|
|
description: Registers a Fulfillment as canceled.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order which the Fulfillment relates to.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: fulfillment_id
|
|
required: true
|
|
description: The ID of the Fulfillment
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Fulfillment
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/cancel':
|
|
post:
|
|
operationId: PostOrdersOrderCancel
|
|
summary: Cancel an Order
|
|
description: >-
|
|
Registers an Order as canceled. This triggers a flow that will cancel
|
|
any created Fulfillments and Payments, may fail if the Payment or
|
|
Fulfillment Provider is unable to cancel the Payment/Fulfillment.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/swaps/{swap_id}/cancel':
|
|
post:
|
|
operationId: PostOrdersSwapCancel
|
|
summary: Cancels a Swap
|
|
description: Cancels a Swap
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: swap_id
|
|
required: true
|
|
description: The ID of the Swap.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Swap
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/capture':
|
|
post:
|
|
operationId: PostOrdersOrderCapture
|
|
summary: Capture an Order
|
|
description: Captures all the Payments associated with an Order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/complete':
|
|
post:
|
|
operationId: PostOrdersOrderComplete
|
|
summary: Complete an Order
|
|
description: Completes an Order
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/claims/{claim_id}/shipments':
|
|
post:
|
|
operationId: PostOrdersOrderClaimsClaimShipments
|
|
summary: Create Claim Shipment
|
|
description: Registers a Claim Fulfillment as shipped.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: claim_id
|
|
required: true
|
|
description: The ID of the Claim.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- fulfillment_id
|
|
properties:
|
|
fulfillment_id:
|
|
description: The ID of the Fulfillment.
|
|
type: string
|
|
tracking_numbers:
|
|
description: The tracking numbers for the shipment.
|
|
type: array
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Claim
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/order/{id}/claims':
|
|
post:
|
|
operationId: PostOrdersOrderClaims
|
|
summary: Create a Claim
|
|
description: Creates a Claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- type
|
|
- claim_items
|
|
properties:
|
|
type:
|
|
description: >-
|
|
The type of the Claim. This will determine how the Claim is
|
|
treated: `replace` Claims will result in a Fulfillment with
|
|
new items being created, while a `refund` Claim will refund
|
|
the amount paid for the claimed items.
|
|
type: string
|
|
enum:
|
|
- replace
|
|
- refund
|
|
claim_items:
|
|
description: The Claim Items that the Claim will consist of.
|
|
type: array
|
|
items:
|
|
required:
|
|
- item_id
|
|
- quantity
|
|
properties:
|
|
item_id:
|
|
description: The ID of the Line Item that will be claimed.
|
|
type: string
|
|
quantity:
|
|
description: The number of items that will be returned
|
|
type: integer
|
|
note:
|
|
description: >-
|
|
Short text describing the Claim Item in further
|
|
detail.
|
|
type: string
|
|
reason:
|
|
description: The reason for the Claim
|
|
type: string
|
|
enum:
|
|
- missing_item
|
|
- wrong_item
|
|
- production_failure
|
|
- other
|
|
tags:
|
|
description: A list o tags to add to the Claim Item
|
|
type: array
|
|
items:
|
|
type: string
|
|
images:
|
|
description: >-
|
|
A list of image URL's that will be associated with the
|
|
Claim
|
|
items:
|
|
type: string
|
|
return_shipping:
|
|
description: >-
|
|
Optional details for the Return Shipping Method, if the
|
|
items are to be sent back.
|
|
type: object
|
|
properties:
|
|
option_id:
|
|
type: string
|
|
description: >-
|
|
The ID of the Shipping Option to create the Shipping
|
|
Method from.
|
|
price:
|
|
type: integer
|
|
description: The price to charge for the Shipping Method.
|
|
additional_items:
|
|
description: >-
|
|
The new items to send to the Customer when the Claim type is
|
|
Replace.
|
|
type: array
|
|
items:
|
|
required:
|
|
- variant_id
|
|
- quantity
|
|
properties:
|
|
variant_id:
|
|
description: The ID of the Product Variant to ship.
|
|
type: string
|
|
quantity:
|
|
description: The quantity of the Product Variant to ship.
|
|
type: integer
|
|
shipping_methods:
|
|
description: The Shipping Methods to send the additional Line Items with.
|
|
type: array
|
|
items:
|
|
properties:
|
|
id:
|
|
description: The ID of an existing Shipping Method
|
|
type: string
|
|
option_id:
|
|
description: >-
|
|
The ID of the Shipping Option to create a Shipping
|
|
Method from
|
|
type: string
|
|
price:
|
|
description: The price to charge for the Shipping Method
|
|
type: integer
|
|
shipping_address:
|
|
type: object
|
|
description: >-
|
|
An optional shipping address to send the claim to. Defaults
|
|
to the parent order's shipping address
|
|
$ref: '#/components/schemas/address'
|
|
refund_amount:
|
|
description: >-
|
|
The amount to refund the Customer when the Claim type is
|
|
`refund`.
|
|
type: integer
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Claim.
|
|
type: boolean
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Claim
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/fulfillment':
|
|
post:
|
|
operationId: PostOrdersOrderFulfillments
|
|
summary: Create a Fulfillment
|
|
description: >-
|
|
Creates a Fulfillment of an Order - will notify Fulfillment Providers to
|
|
prepare a shipment.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- items
|
|
properties:
|
|
items:
|
|
description: The Line Items to include in the Fulfillment.
|
|
type: array
|
|
items:
|
|
required:
|
|
- item_id
|
|
- quantity
|
|
properties:
|
|
item_id:
|
|
description: The ID of Line Item to fulfill.
|
|
type: string
|
|
quantity:
|
|
description: The quantity of the Line Item to fulfill.
|
|
type: integer
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Swap.
|
|
type: boolean
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Fulfillment
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/shipment':
|
|
post:
|
|
operationId: PostOrdersOrderShipment
|
|
summary: Create a Shipment
|
|
description: Registers a Fulfillment as shipped.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- fulfillment_id
|
|
properties:
|
|
fulfillment_id:
|
|
description: The ID of the Fulfillment.
|
|
type: string
|
|
tracking_numbers:
|
|
description: The tracking numbers for the shipment.
|
|
type: array
|
|
items:
|
|
type: string
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Shipment.
|
|
type: boolean
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/swaps/{swap_id}/shipments':
|
|
post:
|
|
operationId: PostOrdersOrderSwapsSwapShipments
|
|
summary: Create Swap Shipment
|
|
description: Registers a Swap Fulfillment as shipped.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: swap_id
|
|
required: true
|
|
description: The ID of the Swap.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- fulfillment_id
|
|
properties:
|
|
fulfillment_id:
|
|
description: The ID of the Fulfillment.
|
|
type: string
|
|
tracking_numbers:
|
|
description: The tracking numbers for the shipment.
|
|
type: array
|
|
items:
|
|
type: string
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Claim.
|
|
type: boolean
|
|
tags:
|
|
- Swap
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/order/{id}/swaps':
|
|
post:
|
|
operationId: PostOrdersOrderSwaps
|
|
summary: Create a Swap
|
|
description: >-
|
|
Creates a Swap. Swaps are used to handle Return of previously purchased
|
|
goods and Fulfillment of replacements simultaneously.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- return_items
|
|
properties:
|
|
return_items:
|
|
description: The Line Items to return as part of the Swap.
|
|
type: array
|
|
items:
|
|
required:
|
|
- item_id
|
|
- quantity
|
|
properties:
|
|
item_id:
|
|
description: The ID of the Line Item that will be claimed.
|
|
type: string
|
|
quantity:
|
|
description: The number of items that will be returned
|
|
type: integer
|
|
reason_id:
|
|
description: The ID of the Return Reason to use.
|
|
type: string
|
|
note:
|
|
description: An optional note with information about the Return.
|
|
type: string
|
|
return_shipping:
|
|
description: How the Swap will be returned.
|
|
type: object
|
|
required:
|
|
- option_id
|
|
properties:
|
|
option_id:
|
|
type: string
|
|
description: >-
|
|
The ID of the Shipping Option to create the Shipping
|
|
Method from.
|
|
price:
|
|
type: integer
|
|
description: The price to charge for the Shipping Method.
|
|
additional_items:
|
|
description: The new items to send to the Customer.
|
|
type: array
|
|
items:
|
|
required:
|
|
- variant_id
|
|
- quantity
|
|
properties:
|
|
variant_id:
|
|
description: The ID of the Product Variant to ship.
|
|
type: string
|
|
quantity:
|
|
description: The quantity of the Product Variant to ship.
|
|
type: integer
|
|
custom_shipping_options:
|
|
description: >-
|
|
The custom shipping options to potentially create a Shipping
|
|
Method from.
|
|
type: array
|
|
items:
|
|
required:
|
|
- option_id
|
|
- price
|
|
properties:
|
|
option_id:
|
|
description: >-
|
|
The ID of the Shipping Option to override with a
|
|
custom price.
|
|
type: string
|
|
price:
|
|
description: The custom price of the Shipping Option.
|
|
type: integer
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Swap.
|
|
type: boolean
|
|
allow_backorder:
|
|
description: 'If true, swaps can be completed with items out of stock'
|
|
type: boolean
|
|
default: true
|
|
tags:
|
|
- Swap
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/claims/{claim_id}/fulfillments':
|
|
post:
|
|
operationId: PostOrdersOrderClaimsClaimFulfillments
|
|
summary: Create a Claim Fulfillment
|
|
description: Creates a Fulfillment for a Claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: claim_id
|
|
required: true
|
|
description: The ID of the Claim.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Claim.
|
|
type: boolean
|
|
tags:
|
|
- Fulfillment
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/swaps/{swap_id}/fulfillments':
|
|
post:
|
|
operationId: PostOrdersOrderSwapsSwapFulfillments
|
|
summary: Create a Swap Fulfillment
|
|
description: Creates a Fulfillment for a Swap.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: swap_id
|
|
required: true
|
|
description: The ID of the Swap.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Claim.
|
|
type: boolean
|
|
tags:
|
|
- Fulfillment
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}':
|
|
get:
|
|
operationId: GetOrdersOrder
|
|
summary: Retrieve an Order
|
|
description: Retrieves an Order
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
post:
|
|
operationId: PostOrdersOrder
|
|
summary: Update an order
|
|
description: Updates and order
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
email:
|
|
description: the email for the order
|
|
type: string
|
|
billing_address:
|
|
description: Billing address
|
|
anyOf:
|
|
- $ref: '#/components/schemas/address'
|
|
shipping_address:
|
|
description: Shipping address
|
|
anyOf:
|
|
- $ref: '#/components/schemas/address'
|
|
items:
|
|
description: The Line Items for the order
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/line_item'
|
|
region:
|
|
description: ID of the region where the order belongs
|
|
type: string
|
|
discounts:
|
|
description: Discounts applied to the order
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/discount'
|
|
customer_id:
|
|
description: ID of the customer
|
|
type: string
|
|
payment_method:
|
|
description: payment method chosen for the order
|
|
type: object
|
|
properties:
|
|
provider_id:
|
|
type: string
|
|
description: ID of the payment provider
|
|
data:
|
|
description: Data relevant for the given payment method
|
|
type: object
|
|
shipping_method:
|
|
description: The Shipping Method used for shipping the order.
|
|
type: object
|
|
properties:
|
|
provider_id:
|
|
type: string
|
|
description: The ID of the shipping provider.
|
|
profile_id:
|
|
type: string
|
|
description: The ID of the shipping profile.
|
|
price:
|
|
type: integer
|
|
description: The price of the shipping.
|
|
data:
|
|
type: object
|
|
description: Data relevant to the specific shipping method.
|
|
items:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/line_item'
|
|
description: Items to ship
|
|
no_notification:
|
|
description: >-
|
|
A flag to indicate if no notifications should be emitted
|
|
related to the updated order.
|
|
type: boolean
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
/orders:
|
|
get:
|
|
operationId: GetOrders
|
|
summary: List Orders
|
|
description: Retrieves a list of Orders
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: q
|
|
description: >-
|
|
Query used for searching orders by shipping address first name,
|
|
orders' email, and orders' display ID
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: id
|
|
description: ID of the order to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: status
|
|
style: form
|
|
explode: false
|
|
description: Status to search for
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
enum:
|
|
- pending
|
|
- completed
|
|
- archived
|
|
- canceled
|
|
- requires_action
|
|
- in: query
|
|
name: fulfillment_status
|
|
style: form
|
|
explode: false
|
|
description: Fulfillment status to search for.
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
enum:
|
|
- not_fulfilled
|
|
- fulfilled
|
|
- partially_fulfilled
|
|
- shipped
|
|
- partially_shipped
|
|
- canceled
|
|
- returned
|
|
- partially_returned
|
|
- requires_action
|
|
- in: query
|
|
name: payment_status
|
|
style: form
|
|
explode: false
|
|
description: Payment status to search for.
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
enum:
|
|
- captured
|
|
- awaiting
|
|
- not_paid
|
|
- refunded
|
|
- partially_refunded
|
|
- canceled
|
|
- requires_action
|
|
- in: query
|
|
name: display_id
|
|
description: Display ID to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: cart_id
|
|
description: to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: customer_id
|
|
description: to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: email
|
|
description: to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: region_id
|
|
style: form
|
|
explode: false
|
|
description: Regions to search orders by
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
description: ID of a Region.
|
|
- type: array
|
|
items:
|
|
type: string
|
|
description: ID of a Region.
|
|
- in: query
|
|
name: currency_code
|
|
style: form
|
|
explode: false
|
|
description: Currency code to search for
|
|
schema:
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
- in: query
|
|
name: tax_rate
|
|
description: to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting orders were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting orders were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: canceled_at
|
|
description: Date comparison for when resulting orders were canceled.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: sales_channel_id
|
|
style: form
|
|
explode: false
|
|
description: Filter by Sales Channels
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
description: The ID of a Sales Channel
|
|
- in: query
|
|
name: offset
|
|
description: How many orders to skip before the results.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of orders returned.
|
|
schema:
|
|
type: integer
|
|
default: 50
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each order of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in each order of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
orders:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/order'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/orders/{id}/swaps/{swap_id}/process-payment':
|
|
post:
|
|
operationId: PostOrdersOrderSwapsSwapProcessPayment
|
|
summary: Process a Swap difference
|
|
description: >-
|
|
When there are differences between the returned and shipped Products in
|
|
a Swap, the difference must be processed. Either a Refund will be issued
|
|
or a Payment will be captured.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: swap_id
|
|
required: true
|
|
description: The ID of the Swap.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Swap
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/refund':
|
|
post:
|
|
operationId: PostOrdersOrderRefunds
|
|
summary: Create a Refund
|
|
description: Issues a Refund.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- amount
|
|
- reason
|
|
properties:
|
|
amount:
|
|
description: The amount to refund.
|
|
type: integer
|
|
reason:
|
|
description: The reason for the Refund.
|
|
type: string
|
|
note:
|
|
description: A note with additional details about the Refund.
|
|
type: string
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Refund.
|
|
type: boolean
|
|
tags:
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/orders/{id}/return':
|
|
post:
|
|
operationId: PostOrdersOrderReturns
|
|
summary: Request a Return
|
|
description: >-
|
|
Requests a Return. If applicable a return label will be created and
|
|
other plugins notified.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- items
|
|
properties:
|
|
items:
|
|
description: The Line Items that will be returned.
|
|
type: array
|
|
items:
|
|
required:
|
|
- item_id
|
|
- quantity
|
|
properties:
|
|
item_id:
|
|
description: The ID of the Line Item.
|
|
type: string
|
|
reason_id:
|
|
description: The ID of the Return Reason to use.
|
|
type: string
|
|
note:
|
|
description: An optional note with information about the Return.
|
|
type: string
|
|
quantity:
|
|
description: The quantity of the Line Item.
|
|
type: integer
|
|
return_shipping:
|
|
description: >-
|
|
The Shipping Method to be used to handle the return
|
|
shipment.
|
|
type: object
|
|
properties:
|
|
option_id:
|
|
type: string
|
|
description: >-
|
|
The ID of the Shipping Option to create the Shipping
|
|
Method from.
|
|
price:
|
|
type: integer
|
|
description: The price to charge for the Shipping Method.
|
|
note:
|
|
description: An optional note with information about the Return.
|
|
type: string
|
|
receive_now:
|
|
description: >-
|
|
A flag to indicate if the Return should be registerd as
|
|
received immediately.
|
|
type: boolean
|
|
default: false
|
|
no_notification:
|
|
description: >-
|
|
A flag to indicate if no notifications should be emitted
|
|
related to the requested Return.
|
|
type: boolean
|
|
refund:
|
|
description: The amount to refund.
|
|
type: integer
|
|
tags:
|
|
- Return
|
|
- Order
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/order/{id}/claims/{claim_id}':
|
|
post:
|
|
operationId: PostOrdersOrderClaimsClaim
|
|
summary: Update a Claim
|
|
description: Updates a Claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Order.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: claim_id
|
|
required: true
|
|
description: The ID of the Claim.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
claim_items:
|
|
description: The Claim Items that the Claim will consist of.
|
|
type: array
|
|
items:
|
|
required:
|
|
- id
|
|
- images
|
|
- tags
|
|
properties:
|
|
id:
|
|
description: The ID of the Claim Item.
|
|
type: string
|
|
item_id:
|
|
description: The ID of the Line Item that will be claimed.
|
|
type: string
|
|
quantity:
|
|
description: The number of items that will be returned
|
|
type: integer
|
|
note:
|
|
description: >-
|
|
Short text describing the Claim Item in further
|
|
detail.
|
|
type: string
|
|
reason:
|
|
description: The reason for the Claim
|
|
type: string
|
|
enum:
|
|
- missing_item
|
|
- wrong_item
|
|
- production_failure
|
|
- other
|
|
tags:
|
|
description: A list o tags to add to the Claim Item
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: Tag ID
|
|
value:
|
|
type: string
|
|
description: Tag value
|
|
images:
|
|
description: >-
|
|
A list of image URL's that will be associated with the
|
|
Claim
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: Image ID
|
|
url:
|
|
type: string
|
|
description: Image URL
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
shipping_methods:
|
|
description: The Shipping Methods to send the additional Line Items with.
|
|
type: array
|
|
items:
|
|
properties:
|
|
id:
|
|
description: The ID of an existing Shipping Method
|
|
type: string
|
|
option_id:
|
|
description: >-
|
|
The ID of the Shipping Option to create a Shipping
|
|
Method from
|
|
type: string
|
|
price:
|
|
description: The price to charge for the Shipping Method
|
|
type: integer
|
|
no_notification:
|
|
description: >-
|
|
If set to true no notification will be send related to this
|
|
Swap.
|
|
type: boolean
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs to hold additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Claim
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
'/price-lists/{id}/prices/batch':
|
|
post:
|
|
operationId: PostPriceListsPriceListPricesBatch
|
|
summary: Batch update prices for a Price List
|
|
description: Batch update prices for a Price List
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Price List to update prices for.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
prices:
|
|
description: The prices to update or add.
|
|
type: array
|
|
items:
|
|
required:
|
|
- amount
|
|
- variant_id
|
|
properties:
|
|
id:
|
|
description: The ID of the price.
|
|
type: string
|
|
region_id:
|
|
description: >-
|
|
The ID of the Region for which the price is used. Only
|
|
required if currecny_code is not provided.
|
|
type: string
|
|
currency_code:
|
|
description: >-
|
|
The 3 character ISO currency code for which the price
|
|
will be used. Only required if region_id is not
|
|
provided.
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
variant_id:
|
|
description: The ID of the Variant for which the price is used.
|
|
type: string
|
|
amount:
|
|
description: The amount to charge for the Product Variant.
|
|
type: integer
|
|
min_quantity:
|
|
description: The minimum quantity for which the price will be used.
|
|
type: integer
|
|
max_quantity:
|
|
description: The maximum quantity for which the price will be used.
|
|
type: integer
|
|
override:
|
|
description: >-
|
|
If true the prices will replace all existing prices
|
|
associated with the Price List.
|
|
type: boolean
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
price_list:
|
|
$ref: '#/components/schemas/price_list'
|
|
delete:
|
|
operationId: DeletePriceListsPriceListPricesBatch
|
|
summary: Batch delete prices that belong to a Price List
|
|
description: Batch delete prices that belong to a Price List
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: >-
|
|
The ID of the Price List that the Money Amounts (Prices) that will
|
|
be deleted belongs to.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
price_ids:
|
|
description: The price id's of the Money Amounts to delete.
|
|
type: array
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
ids:
|
|
type: array
|
|
items:
|
|
type: string
|
|
description: The IDs of the deleted Money Amounts (Prices).
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: money-amount
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
/price-lists:
|
|
post:
|
|
operationId: PostPriceListsPriceList
|
|
summary: Creates a Price List
|
|
description: Creates a Price List
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- name
|
|
- description
|
|
- type
|
|
- prices
|
|
properties:
|
|
name:
|
|
description: The name of the Price List
|
|
type: string
|
|
description:
|
|
description: A description of the Price List.
|
|
type: string
|
|
starts_at:
|
|
description: >-
|
|
The date with timezone that the Price List starts being
|
|
valid.
|
|
type: string
|
|
format: date
|
|
ends_at:
|
|
description: The date with timezone that the Price List ends being valid.
|
|
type: string
|
|
format: date
|
|
type:
|
|
description: The type of the Price List.
|
|
type: string
|
|
enum:
|
|
- sale
|
|
- override
|
|
status:
|
|
description: The status of the Price List.
|
|
type: string
|
|
enum:
|
|
- active
|
|
- draft
|
|
prices:
|
|
description: The prices of the Price List.
|
|
type: array
|
|
items:
|
|
required:
|
|
- amount
|
|
- variant_id
|
|
properties:
|
|
region_id:
|
|
description: >-
|
|
The ID of the Region for which the price is used. Only
|
|
required if currecny_code is not provided.
|
|
type: string
|
|
currency_code:
|
|
description: >-
|
|
The 3 character ISO currency code for which the price
|
|
will be used. Only required if region_id is not
|
|
provided.
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
amount:
|
|
description: The amount to charge for the Product Variant.
|
|
type: integer
|
|
variant_id:
|
|
description: The ID of the Variant for which the price is used.
|
|
type: string
|
|
min_quantity:
|
|
description: The minimum quantity for which the price will be used.
|
|
type: integer
|
|
max_quantity:
|
|
description: The maximum quantity for which the price will be used.
|
|
type: integer
|
|
customer_groups:
|
|
type: array
|
|
description: A list of customer groups that the Price List applies to.
|
|
items:
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: The ID of a customer group
|
|
type: string
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
price_list:
|
|
$ref: '#/components/schemas/price_list'
|
|
get:
|
|
operationId: GetPriceLists
|
|
summary: List Price Lists
|
|
description: Retrieves a list of Price Lists.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The number of items to get
|
|
schema:
|
|
type: number
|
|
default: '10'
|
|
- in: query
|
|
name: offset
|
|
description: The offset at which to get items
|
|
schema:
|
|
type: number
|
|
default: '0'
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each item of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: order
|
|
description: field to order results by.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: id
|
|
description: ID to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: q
|
|
description: >-
|
|
query to search in price list description, price list name, and
|
|
customer group name fields.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: status
|
|
style: form
|
|
explode: false
|
|
description: Status to search for.
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
enum:
|
|
- active
|
|
- draft
|
|
- in: query
|
|
name: name
|
|
description: price list name to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: customer_groups
|
|
style: form
|
|
explode: false
|
|
description: Customer Group IDs to search for.
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: type
|
|
style: form
|
|
explode: false
|
|
description: Type to search for.
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
enum:
|
|
- sale
|
|
- override
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting price lists were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting price lists were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: deleted_at
|
|
description: Date comparison for when resulting price lists were deleted.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
price_lists:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/price_list'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/price-lists/{id}':
|
|
delete:
|
|
operationId: DeletePriceListsPriceList
|
|
summary: Delete a Price List
|
|
description: Deletes a Price List
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Price List to delete.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Price List.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: price-list
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetPriceListsPriceList
|
|
summary: Retrieve a Price List
|
|
description: Retrieves a Price List.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Price List.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
price_list:
|
|
$ref: '#/components/schemas/price_list'
|
|
post:
|
|
operationId: PostPriceListsPriceListPriceList
|
|
summary: Update a Price List
|
|
description: Updates a Price List
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Price List.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
name:
|
|
description: The name of the Price List
|
|
type: string
|
|
description:
|
|
description: A description of the Price List.
|
|
type: string
|
|
starts_at:
|
|
description: >-
|
|
The date with timezone that the Price List starts being
|
|
valid.
|
|
type: string
|
|
format: date
|
|
ends_at:
|
|
description: The date with timezone that the Price List ends being valid.
|
|
type: string
|
|
format: date
|
|
type:
|
|
description: The type of the Price List.
|
|
type: string
|
|
enum:
|
|
- sale
|
|
- override
|
|
status:
|
|
description: The status of the Price List.
|
|
type: string
|
|
enum:
|
|
- active
|
|
- draft
|
|
prices:
|
|
description: The prices of the Price List.
|
|
type: array
|
|
items:
|
|
required:
|
|
- amount
|
|
- variant_id
|
|
properties:
|
|
id:
|
|
description: The ID of the price.
|
|
type: string
|
|
region_id:
|
|
description: >-
|
|
The ID of the Region for which the price is used. Only
|
|
required if currecny_code is not provided.
|
|
type: string
|
|
currency_code:
|
|
description: >-
|
|
The 3 character ISO currency code for which the price
|
|
will be used. Only required if region_id is not
|
|
provided.
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
variant_id:
|
|
description: The ID of the Variant for which the price is used.
|
|
type: string
|
|
amount:
|
|
description: The amount to charge for the Product Variant.
|
|
type: integer
|
|
min_quantity:
|
|
description: The minimum quantity for which the price will be used.
|
|
type: integer
|
|
max_quantity:
|
|
description: The maximum quantity for which the price will be used.
|
|
type: integer
|
|
customer_groups:
|
|
type: array
|
|
description: A list of customer groups that the Price List applies to.
|
|
items:
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: The ID of a customer group
|
|
type: string
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
price_list:
|
|
$ref: '#/components/schemas/price_list'
|
|
'/price-lists/{id}/products/{product_id}/prices':
|
|
delete:
|
|
operationId: DeletePriceListsPriceListProductsProductPrices
|
|
summary: Delete all the prices related to a specific product in a price list
|
|
description: Delete all the prices related to a specific product in a price list
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: >-
|
|
The ID of the Price List that the Money Amounts that will be deleted
|
|
belongs to.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: product_id
|
|
required: true
|
|
description: The ID of the product from which the money amount will be deleted.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The price ids that have been deleted.
|
|
items:
|
|
type: string
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: money-amount
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
'/price-lists/{id}/variants/{variant_id}/prices':
|
|
delete:
|
|
operationId: DeletePriceListsPriceListVariantsVariantPrices
|
|
summary: Delete all the prices related to a specific variant in a price list
|
|
description: Delete all the prices related to a specific variant in a price list
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: >-
|
|
The ID of the Price List that the Money Amounts that will be deleted
|
|
belongs to.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: variant_id
|
|
required: true
|
|
description: The ID of the variant from which the money amount will be deleted.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Price List
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The price ids that have been deleted.
|
|
items:
|
|
type: string
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: money-amount
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
'/price-lists/{id}/products':
|
|
get:
|
|
operationId: GetPriceListsPriceListProducts
|
|
summary: List Product in a Price List
|
|
description: Retrieves a list of Product that are part of a Price List
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the price list.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: q
|
|
description: >-
|
|
Query used for searching product title and description, variant
|
|
title and sku, and collection title.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: id
|
|
description: ID of the product to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: status
|
|
description: Product status to search for
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
- in: query
|
|
name: collection_id
|
|
description: Collection IDs to search for
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: tags
|
|
description: Tag IDs to search for
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: title
|
|
description: product title to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: description
|
|
description: product description to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: handle
|
|
description: product handle to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: is_giftcard
|
|
description: Search for giftcards using is_giftcard=true.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: type
|
|
description: to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: order
|
|
description: field to sort results by.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting products were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting products were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: deleted_at
|
|
description: Date comparison for when resulting products were deleted.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: offset
|
|
description: How many products to skip in the result.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of products returned.
|
|
schema:
|
|
type: integer
|
|
default: 50
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each product of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in each product of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
products:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
/product-tags:
|
|
get:
|
|
operationId: GetProductTags
|
|
summary: List Product Tags
|
|
description: Retrieve a list of Product Tags.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The number of tags to return.
|
|
schema:
|
|
type: integer
|
|
default: 10
|
|
- in: query
|
|
name: offset
|
|
description: The number of items to skip before the results.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: order
|
|
description: The field to sort items by.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: value
|
|
style: form
|
|
explode: false
|
|
description: The tag values to search for
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: q
|
|
description: A query string to search values for
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: id
|
|
style: form
|
|
explode: false
|
|
description: The tag IDs to search for
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting product tags were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting product tags were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
tags:
|
|
- Product Tag
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product_tags:
|
|
$ref: '#/components/schemas/product_tag'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
/product-types:
|
|
get:
|
|
operationId: GetProductTypes
|
|
summary: List Product Types
|
|
description: Retrieve a list of Product Types.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The number of types to return.
|
|
schema:
|
|
type: integer
|
|
default: 10
|
|
- in: query
|
|
name: offset
|
|
description: The number of items to skip before the results.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: order
|
|
description: The field to sort items by.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: value
|
|
style: form
|
|
explode: false
|
|
description: The type values to search for
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: id
|
|
style: form
|
|
explode: false
|
|
description: The type IDs to search for
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: q
|
|
description: A query string to search values for
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting product types were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting product types were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
tags:
|
|
- Product Type
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product_types:
|
|
$ref: '#/components/schemas/product_type'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/products/{id}/options':
|
|
post:
|
|
operationId: PostProductsProductOptions
|
|
summary: Add an Option
|
|
x-authenticated: true
|
|
description: Adds a Product Option to a Product
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- title
|
|
properties:
|
|
title:
|
|
description: >-
|
|
The title the Product Option will be identified by i.e.
|
|
"Size"
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
/products:
|
|
post:
|
|
operationId: PostProducts
|
|
summary: Create a Product
|
|
x-authenticated: true
|
|
description: Creates a Product
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- title
|
|
properties:
|
|
title:
|
|
description: The title of the Product
|
|
type: string
|
|
subtitle:
|
|
description: The subtitle of the Product
|
|
type: string
|
|
description:
|
|
description: A description of the Product.
|
|
type: string
|
|
is_giftcard:
|
|
description: >-
|
|
A flag to indicate if the Product represents a Gift Card.
|
|
Purchasing Products with this flag set to `true` will result
|
|
in a Gift Card being created.
|
|
type: boolean
|
|
default: false
|
|
discountable:
|
|
description: >-
|
|
A flag to indicate if discounts can be applied to the
|
|
LineItems generated from this Product
|
|
type: boolean
|
|
default: true
|
|
images:
|
|
description: Images of the Product.
|
|
type: array
|
|
items:
|
|
type: string
|
|
thumbnail:
|
|
description: The thumbnail to use for the Product.
|
|
type: string
|
|
handle:
|
|
description: A unique handle to identify the Product by.
|
|
type: string
|
|
status:
|
|
description: The status of the product.
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
default: draft
|
|
type:
|
|
description: The Product Type to associate the Product with.
|
|
type: object
|
|
required:
|
|
- value
|
|
properties:
|
|
id:
|
|
description: The ID of the Product Type.
|
|
type: string
|
|
value:
|
|
description: The value of the Product Type.
|
|
type: string
|
|
collection_id:
|
|
description: The ID of the Collection the Product should belong to.
|
|
type: string
|
|
tags:
|
|
description: Tags to associate the Product with.
|
|
type: array
|
|
items:
|
|
required:
|
|
- value
|
|
properties:
|
|
id:
|
|
description: The ID of an existing Tag.
|
|
type: string
|
|
value:
|
|
description: 'The value of the Tag, these will be upserted.'
|
|
type: string
|
|
sales_channels:
|
|
description: '[EXPERIMENTAL] Sales channels to associate the Product with.'
|
|
type: array
|
|
items:
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: The ID of an existing Sales channel.
|
|
type: string
|
|
options:
|
|
description: >-
|
|
The Options that the Product should have. These define on
|
|
which properties the Product's Product Variants will differ.
|
|
type: array
|
|
items:
|
|
required:
|
|
- title
|
|
properties:
|
|
title:
|
|
description: The title to identify the Product Option by.
|
|
type: string
|
|
variants:
|
|
description: A list of Product Variants to create with the Product.
|
|
type: array
|
|
items:
|
|
required:
|
|
- title
|
|
properties:
|
|
title:
|
|
description: The title to identify the Product Variant by.
|
|
type: string
|
|
sku:
|
|
description: The unique SKU for the Product Variant.
|
|
type: string
|
|
ean:
|
|
description: The EAN number of the item.
|
|
type: string
|
|
upc:
|
|
description: The UPC number of the item.
|
|
type: string
|
|
barcode:
|
|
description: A generic GTIN field for the Product Variant.
|
|
type: string
|
|
hs_code:
|
|
description: The Harmonized System code for the Product Variant.
|
|
type: string
|
|
inventory_quantity:
|
|
description: The amount of stock kept for the Product Variant.
|
|
type: integer
|
|
default: 0
|
|
allow_backorder:
|
|
description: >-
|
|
Whether the Product Variant can be purchased when out
|
|
of stock.
|
|
type: boolean
|
|
manage_inventory:
|
|
description: >-
|
|
Whether Medusa should keep track of the inventory for
|
|
this Product Variant.
|
|
type: boolean
|
|
weight:
|
|
description: The wieght of the Product Variant.
|
|
type: number
|
|
length:
|
|
description: The length of the Product Variant.
|
|
type: number
|
|
height:
|
|
description: The height of the Product Variant.
|
|
type: number
|
|
width:
|
|
description: The width of the Product Variant.
|
|
type: number
|
|
origin_country:
|
|
description: The country of origin of the Product Variant.
|
|
type: string
|
|
mid_code:
|
|
description: >-
|
|
The Manufacturer Identification code for the Product
|
|
Variant.
|
|
type: string
|
|
material:
|
|
description: The material composition of the Product Variant.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
prices:
|
|
type: array
|
|
items:
|
|
required:
|
|
- amount
|
|
properties:
|
|
region_id:
|
|
description: >-
|
|
The ID of the Region for which the price is
|
|
used. Only required if currency_code is not
|
|
provided.
|
|
type: string
|
|
currency_code:
|
|
description: >-
|
|
The 3 character ISO currency code for which the
|
|
price will be used. Only required if region_id
|
|
is not provided.
|
|
type: string
|
|
externalDocs:
|
|
url: >-
|
|
https://en.wikipedia.org/wiki/ISO_4217#Active_codes
|
|
description: See a list of codes.
|
|
amount:
|
|
description: The amount to charge for the Product Variant.
|
|
type: integer
|
|
min_quantity:
|
|
description: >-
|
|
The minimum quantity for which the price will be
|
|
used.
|
|
type: integer
|
|
max_quantity:
|
|
description: >-
|
|
The maximum quantity for which the price will be
|
|
used.
|
|
type: integer
|
|
options:
|
|
type: array
|
|
items:
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
description: >-
|
|
The value to give for the Product Option at the
|
|
same index in the Product's `options` field.
|
|
type: string
|
|
weight:
|
|
description: The wieght of the Product.
|
|
type: number
|
|
length:
|
|
description: The length of the Product.
|
|
type: number
|
|
height:
|
|
description: The height of the Product.
|
|
type: number
|
|
width:
|
|
description: The width of the Product.
|
|
type: number
|
|
hs_code:
|
|
description: The Harmonized System code for the Product Variant.
|
|
type: string
|
|
origin_country:
|
|
description: The country of origin of the Product.
|
|
type: string
|
|
mid_code:
|
|
description: The Manufacturer Identification code for the Product.
|
|
type: string
|
|
material:
|
|
description: The material composition of the Product.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
get:
|
|
operationId: GetProducts
|
|
summary: List Product
|
|
description: Retrieves a list of Product
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: q
|
|
description: >-
|
|
Query used for searching product title and description, variant
|
|
title and sku, and collection title.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: id
|
|
style: form
|
|
explode: false
|
|
description: Filter by product IDs.
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
description: ID of the product to search for.
|
|
- type: array
|
|
items:
|
|
type: string
|
|
description: ID of a product.
|
|
- in: query
|
|
name: status
|
|
style: form
|
|
explode: false
|
|
description: Status to search for
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
- in: query
|
|
name: collection_id
|
|
style: form
|
|
explode: false
|
|
description: Collection ids to search for.
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: tags
|
|
style: form
|
|
explode: false
|
|
description: Tag IDs to search for
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: price_list_id
|
|
style: form
|
|
explode: false
|
|
description: Price List IDs to search for
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: sales_channel_id
|
|
style: form
|
|
explode: false
|
|
description: Sales Channel IDs to filter products by
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: title
|
|
description: title to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: description
|
|
description: description to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: handle
|
|
description: handle to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: is_giftcard
|
|
description: Search for giftcards using is_giftcard=true.
|
|
schema:
|
|
type: boolean
|
|
- in: query
|
|
name: type
|
|
description: type ID to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting products were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting products were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: deleted_at
|
|
description: Date comparison for when resulting products were deleted.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: offset
|
|
description: How many products to skip in the result.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of products returned.
|
|
schema:
|
|
type: integer
|
|
default: 50
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each product of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in each product of
|
|
the result.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
products:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/products/{id}/variants':
|
|
post:
|
|
operationId: PostProductsProductVariants
|
|
summary: Create a Product Variant
|
|
description: >-
|
|
Creates a Product Variant. Each Product Variant must have a unique
|
|
combination of Product Option Values.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- title
|
|
- prices
|
|
- options
|
|
properties:
|
|
title:
|
|
description: The title to identify the Product Variant by.
|
|
type: string
|
|
sku:
|
|
description: The unique SKU for the Product Variant.
|
|
type: string
|
|
ean:
|
|
description: The EAN number of the item.
|
|
type: string
|
|
upc:
|
|
description: The UPC number of the item.
|
|
type: string
|
|
barcode:
|
|
description: A generic GTIN field for the Product Variant.
|
|
type: string
|
|
hs_code:
|
|
description: The Harmonized System code for the Product Variant.
|
|
type: string
|
|
inventory_quantity:
|
|
description: The amount of stock kept for the Product Variant.
|
|
type: integer
|
|
default: 0
|
|
allow_backorder:
|
|
description: >-
|
|
Whether the Product Variant can be purchased when out of
|
|
stock.
|
|
type: boolean
|
|
manage_inventory:
|
|
description: >-
|
|
Whether Medusa should keep track of the inventory for this
|
|
Product Variant.
|
|
type: boolean
|
|
weight:
|
|
description: The wieght of the Product Variant.
|
|
type: number
|
|
length:
|
|
description: The length of the Product Variant.
|
|
type: number
|
|
height:
|
|
description: The height of the Product Variant.
|
|
type: number
|
|
width:
|
|
description: The width of the Product Variant.
|
|
type: number
|
|
origin_country:
|
|
description: The country of origin of the Product Variant.
|
|
type: string
|
|
mid_code:
|
|
description: >-
|
|
The Manufacturer Identification code for the Product
|
|
Variant.
|
|
type: string
|
|
material:
|
|
description: The material composition of the Product Variant.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
prices:
|
|
type: array
|
|
items:
|
|
required:
|
|
- amount
|
|
properties:
|
|
id:
|
|
description: The ID of the price.
|
|
type: string
|
|
region_id:
|
|
description: >-
|
|
The ID of the Region for which the price is used. Only
|
|
required if currency_code is not provided.
|
|
type: string
|
|
currency_code:
|
|
description: >-
|
|
The 3 character ISO currency code for which the price
|
|
will be used. Only required if region_id is not
|
|
provided.
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
amount:
|
|
description: The amount to charge for the Product Variant.
|
|
type: integer
|
|
min_quantity:
|
|
description: The minimum quantity for which the price will be used.
|
|
type: integer
|
|
max_quantity:
|
|
description: The maximum quantity for which the price will be used.
|
|
type: integer
|
|
options:
|
|
type: array
|
|
items:
|
|
required:
|
|
- option_id
|
|
- value
|
|
properties:
|
|
option_id:
|
|
description: The ID of the Product Option to set the value for.
|
|
type: string
|
|
value:
|
|
description: The value to give for the Product Option.
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
get:
|
|
operationId: GetProductsProductVariants
|
|
summary: List a Product's Product Variants
|
|
description: Retrieves a list of the Product Variants associated with a Product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the product to search for the variants.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Comma separated string of the column to select.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Comma separated string of the relations to include.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: offset
|
|
description: How many items to skip before the results.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of items returned.
|
|
schema:
|
|
type: integer
|
|
default: 100
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
variants:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_variant'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/products/{id}/options/{option_id}':
|
|
delete:
|
|
operationId: DeleteProductsProductOptionsOption
|
|
summary: Delete a Product Option
|
|
description: >-
|
|
Deletes a Product Option. Before a Product Option can be deleted all
|
|
Option Values for the Product Option must be the same. You may, for
|
|
example, have to delete some of your variants prior to deleting the
|
|
Product Option
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: option_id
|
|
required: true
|
|
description: The ID of the Product Option.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
option_id:
|
|
type: string
|
|
description: The ID of the deleted Product Option
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: option
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
post:
|
|
operationId: PostProductsProductOptionsOption
|
|
summary: Update a Product Option.
|
|
description: Updates a Product Option
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: option_id
|
|
required: true
|
|
description: The ID of the Product Option.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- title
|
|
properties:
|
|
title:
|
|
description: The title of the Product Option
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
'/products/{id}':
|
|
delete:
|
|
operationId: DeleteProductsProduct
|
|
summary: Delete a Product
|
|
description: Deletes a Product and it's associated Product Variants.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Product.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: product
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetProductsProduct
|
|
summary: Retrieve a Product
|
|
description: Retrieves a Product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
post:
|
|
operationId: PostProductsProduct
|
|
summary: Update a Product
|
|
description: Updates a Product
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
title:
|
|
description: The title of the Product
|
|
type: string
|
|
subtitle:
|
|
description: The subtitle of the Product
|
|
type: string
|
|
description:
|
|
description: A description of the Product.
|
|
type: string
|
|
discountable:
|
|
description: >-
|
|
A flag to indicate if discounts can be applied to the
|
|
LineItems generated from this Product
|
|
type: boolean
|
|
images:
|
|
description: Images of the Product.
|
|
type: array
|
|
items:
|
|
type: string
|
|
thumbnail:
|
|
description: The thumbnail to use for the Product.
|
|
type: string
|
|
handle:
|
|
description: A unique handle to identify the Product by.
|
|
type: string
|
|
status:
|
|
description: The status of the product.
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
type:
|
|
description: The Product Type to associate the Product with.
|
|
type: object
|
|
required:
|
|
- value
|
|
properties:
|
|
id:
|
|
description: The ID of the Product Type.
|
|
type: string
|
|
value:
|
|
description: The value of the Product Type.
|
|
type: string
|
|
collection_id:
|
|
description: The ID of the Collection the Product should belong to.
|
|
type: string
|
|
tags:
|
|
description: Tags to associate the Product with.
|
|
type: array
|
|
items:
|
|
required:
|
|
- value
|
|
properties:
|
|
id:
|
|
description: The ID of an existing Tag.
|
|
type: string
|
|
value:
|
|
description: 'The value of the Tag, these will be upserted.'
|
|
type: string
|
|
sales_channels:
|
|
description: '[EXPERIMENTAL] Sales channels to associate the Product with.'
|
|
type: array
|
|
items:
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: The ID of an existing Sales channel.
|
|
type: string
|
|
variants:
|
|
description: A list of Product Variants to create with the Product.
|
|
type: array
|
|
items:
|
|
properties:
|
|
id:
|
|
description: The ID of the Product Variant.
|
|
type: string
|
|
title:
|
|
description: The title to identify the Product Variant by.
|
|
type: string
|
|
sku:
|
|
description: The unique SKU for the Product Variant.
|
|
type: string
|
|
ean:
|
|
description: The EAN number of the item.
|
|
type: string
|
|
upc:
|
|
description: The UPC number of the item.
|
|
type: string
|
|
barcode:
|
|
description: A generic GTIN field for the Product Variant.
|
|
type: string
|
|
hs_code:
|
|
description: The Harmonized System code for the Product Variant.
|
|
type: string
|
|
inventory_quantity:
|
|
description: The amount of stock kept for the Product Variant.
|
|
type: integer
|
|
allow_backorder:
|
|
description: >-
|
|
Whether the Product Variant can be purchased when out
|
|
of stock.
|
|
type: boolean
|
|
manage_inventory:
|
|
description: >-
|
|
Whether Medusa should keep track of the inventory for
|
|
this Product Variant.
|
|
type: boolean
|
|
weight:
|
|
description: The wieght of the Product Variant.
|
|
type: number
|
|
length:
|
|
description: The length of the Product Variant.
|
|
type: number
|
|
height:
|
|
description: The height of the Product Variant.
|
|
type: number
|
|
width:
|
|
description: The width of the Product Variant.
|
|
type: number
|
|
origin_country:
|
|
description: The country of origin of the Product Variant.
|
|
type: string
|
|
mid_code:
|
|
description: >-
|
|
The Manufacturer Identification code for the Product
|
|
Variant.
|
|
type: string
|
|
material:
|
|
description: The material composition of the Product Variant.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
prices:
|
|
type: array
|
|
items:
|
|
required:
|
|
- amount
|
|
properties:
|
|
id:
|
|
description: The ID of the Price.
|
|
type: string
|
|
region_id:
|
|
description: >-
|
|
The ID of the Region for which the price is
|
|
used. Only required if currency_code is not
|
|
provided.
|
|
type: string
|
|
currency_code:
|
|
description: >-
|
|
The 3 character ISO currency code for which the
|
|
price will be used. Only required if region_id
|
|
is not provided.
|
|
type: string
|
|
externalDocs:
|
|
url: >-
|
|
https://en.wikipedia.org/wiki/ISO_4217#Active_codes
|
|
description: See a list of codes.
|
|
amount:
|
|
description: The amount to charge for the Product Variant.
|
|
type: integer
|
|
min_quantity:
|
|
description: >-
|
|
The minimum quantity for which the price will be
|
|
used.
|
|
type: integer
|
|
max_quantity:
|
|
description: >-
|
|
The maximum quantity for which the price will be
|
|
used.
|
|
type: integer
|
|
options:
|
|
type: array
|
|
items:
|
|
required:
|
|
- option_id
|
|
- value
|
|
properties:
|
|
option_id:
|
|
description: The ID of the Option.
|
|
type: string
|
|
value:
|
|
description: >-
|
|
The value to give for the Product Option at the
|
|
same index in the Product's `options` field.
|
|
type: string
|
|
weight:
|
|
description: The wieght of the Product.
|
|
type: number
|
|
length:
|
|
description: The length of the Product.
|
|
type: number
|
|
height:
|
|
description: The height of the Product.
|
|
type: number
|
|
width:
|
|
description: The width of the Product.
|
|
type: number
|
|
origin_country:
|
|
description: The country of origin of the Product.
|
|
type: string
|
|
mid_code:
|
|
description: The Manufacturer Identification code for the Product.
|
|
type: string
|
|
material:
|
|
description: The material composition of the Product.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
'/products/{id}/variants/{variant_id}':
|
|
delete:
|
|
operationId: DeleteProductsProductVariantsVariant
|
|
summary: Delete a Product Variant
|
|
description: Deletes a Product Variant.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: variant_id
|
|
required: true
|
|
description: The ID of the Product Variant.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
description: The ID of the deleted Product Variant.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: variant
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
post:
|
|
operationId: PostProductsProductVariantsVariant
|
|
summary: Update a Product Variant
|
|
description: Update a Product Variant.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: variant_id
|
|
required: true
|
|
description: The ID of the Product Variant.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
title:
|
|
description: The title to identify the Product Variant by.
|
|
type: string
|
|
sku:
|
|
description: The unique SKU for the Product Variant.
|
|
type: string
|
|
ean:
|
|
description: The EAN number of the item.
|
|
type: string
|
|
upc:
|
|
description: The UPC number of the item.
|
|
type: string
|
|
barcode:
|
|
description: A generic GTIN field for the Product Variant.
|
|
type: string
|
|
hs_code:
|
|
description: The Harmonized System code for the Product Variant.
|
|
type: string
|
|
inventory_quantity:
|
|
description: The amount of stock kept for the Product Variant.
|
|
type: integer
|
|
allow_backorder:
|
|
description: >-
|
|
Whether the Product Variant can be purchased when out of
|
|
stock.
|
|
type: boolean
|
|
manage_inventory:
|
|
description: >-
|
|
Whether Medusa should keep track of the inventory for this
|
|
Product Variant.
|
|
type: boolean
|
|
weight:
|
|
description: The wieght of the Product Variant.
|
|
type: number
|
|
length:
|
|
description: The length of the Product Variant.
|
|
type: number
|
|
height:
|
|
description: The height of the Product Variant.
|
|
type: number
|
|
width:
|
|
description: The width of the Product Variant.
|
|
type: number
|
|
origin_country:
|
|
description: The country of origin of the Product Variant.
|
|
type: string
|
|
mid_code:
|
|
description: >-
|
|
The Manufacturer Identification code for the Product
|
|
Variant.
|
|
type: string
|
|
material:
|
|
description: The material composition of the Product Variant.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
prices:
|
|
type: array
|
|
items:
|
|
required:
|
|
- amount
|
|
properties:
|
|
id:
|
|
description: The ID of the price.
|
|
type: string
|
|
region_id:
|
|
description: >-
|
|
The ID of the Region for which the price is used. Only
|
|
required if currency_code is not provided.
|
|
type: string
|
|
currency_code:
|
|
description: >-
|
|
The 3 character ISO currency code for which the price
|
|
will be used. Only required if region_id is not
|
|
provided.
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
amount:
|
|
description: The amount to charge for the Product Variant.
|
|
type: integer
|
|
min_quantity:
|
|
description: The minimum quantity for which the price will be used.
|
|
type: integer
|
|
max_quantity:
|
|
description: The maximum quantity for which the price will be used.
|
|
type: integer
|
|
options:
|
|
type: array
|
|
items:
|
|
required:
|
|
- option_id
|
|
- value
|
|
properties:
|
|
option_id:
|
|
description: The ID of the Product Option to set the value for.
|
|
type: string
|
|
value:
|
|
description: The value to give for the Product Option.
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
/products/tag-usage:
|
|
get:
|
|
operationId: GetProductsTagUsage
|
|
summary: List Product Tags Usage Number
|
|
description: Retrieves a list of Product Tags with how many times each is used.
|
|
x-authenticated: true
|
|
tags:
|
|
- Product Tag
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tags:
|
|
type: array
|
|
items:
|
|
properties:
|
|
id:
|
|
description: The ID of the tag.
|
|
type: string
|
|
usage_count:
|
|
description: The number of products that use this tag.
|
|
type: string
|
|
value:
|
|
description: The value of the tag.
|
|
type: string
|
|
/products/types:
|
|
get:
|
|
operationId: GetProductsTypes
|
|
summary: List Product Types
|
|
description: Retrieves a list of Product Types.
|
|
x-authenticated: true
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
types:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_type'
|
|
'/products/{id}/metadata':
|
|
post:
|
|
operationId: PostProductsProductMetadata
|
|
summary: Set Product metadata
|
|
description: Set metadata key/value pair for Product
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Product.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- key
|
|
- value
|
|
properties:
|
|
key:
|
|
description: The metadata key
|
|
type: string
|
|
value:
|
|
description: The metadata value
|
|
type: string
|
|
tags:
|
|
- Product
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/product'
|
|
'/regions/{id}/countries':
|
|
post:
|
|
operationId: PostRegionsRegionCountries
|
|
summary: Add Country
|
|
description: Adds a Country to the list of Countries in a Region
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- country_code
|
|
properties:
|
|
country_code:
|
|
description: The 2 character ISO code for the Country.
|
|
type: string
|
|
externalDocs:
|
|
url: >-
|
|
https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
|
|
description: See a list of codes.
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
'/regions/{id}/fulfillment-providers':
|
|
post:
|
|
operationId: PostRegionsRegionFulfillmentProviders
|
|
summary: Add Fulfillment Provider
|
|
description: Adds a Fulfillment Provider to a Region
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- provider_id
|
|
properties:
|
|
provider_id:
|
|
description: The ID of the Fulfillment Provider to add.
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
'/regions/{id}/payment-providers':
|
|
post:
|
|
operationId: PostRegionsRegionPaymentProviders
|
|
summary: Add Payment Provider
|
|
description: Adds a Payment Provider to a Region
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- provider_id
|
|
properties:
|
|
provider_id:
|
|
description: The ID of the Payment Provider to add.
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
/regions:
|
|
post:
|
|
operationId: PostRegions
|
|
summary: Create a Region
|
|
description: Creates a Region
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- name
|
|
- currency_code
|
|
- tax_rate
|
|
- payment_providers
|
|
- fulfillment_providers
|
|
- countries
|
|
properties:
|
|
name:
|
|
description: The name of the Region
|
|
type: string
|
|
currency_code:
|
|
description: The 3 character ISO currency code to use for the Region.
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
tax_code:
|
|
description: An optional tax code the Region.
|
|
type: string
|
|
tax_rate:
|
|
description: The tax rate to use on Orders in the Region.
|
|
type: number
|
|
payment_providers:
|
|
description: >-
|
|
A list of Payment Provider IDs that should be enabled for
|
|
the Region
|
|
type: array
|
|
items:
|
|
type: string
|
|
fulfillment_providers:
|
|
description: >-
|
|
A list of Fulfillment Provider IDs that should be enabled
|
|
for the Region
|
|
type: array
|
|
items:
|
|
type: string
|
|
countries:
|
|
description: >-
|
|
A list of countries' 2 ISO Characters that should be
|
|
included in the Region.
|
|
example:
|
|
- US
|
|
type: array
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
get:
|
|
operationId: GetRegions
|
|
summary: List Regions
|
|
description: Retrieves a list of Regions.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
schema:
|
|
type: integer
|
|
default: 50
|
|
required: false
|
|
description: limit the number of regions in response
|
|
- in: query
|
|
name: offset
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
required: false
|
|
description: Offset of regions in response (used for pagination)
|
|
- in: query
|
|
name: created_at
|
|
schema:
|
|
type: object
|
|
required: false
|
|
description: >-
|
|
Date comparison for when resulting region was created, i.e. less
|
|
than, greater than etc.
|
|
- in: query
|
|
name: updated_at
|
|
schema:
|
|
type: object
|
|
required: false
|
|
description: >-
|
|
Date comparison for when resulting region was updated, i.e. less
|
|
than, greater than etc.
|
|
- in: query
|
|
name: deleted_at
|
|
schema:
|
|
type: object
|
|
required: false
|
|
description: >-
|
|
Date comparison for when resulting region was deleted, i.e. less
|
|
than, greater than etc.
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
regions:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/region'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/regions/{id}':
|
|
delete:
|
|
operationId: DeleteRegionsRegion
|
|
summary: Delete a Region
|
|
description: Deletes a Region.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Region.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: region
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetRegionsRegion
|
|
summary: Retrieve a Region
|
|
description: Retrieves a Region.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
post:
|
|
operationId: PostRegionsRegion
|
|
summary: Update a Region
|
|
description: Updates a Region
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
name:
|
|
description: The name of the Region
|
|
type: string
|
|
currency_code:
|
|
description: The 3 character ISO currency code to use for the Region.
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
automatic_taxes:
|
|
description: >-
|
|
If true Medusa will automatically calculate taxes for carts
|
|
in this region. If false you have to manually call POST
|
|
/carts/:id/taxes.
|
|
type: boolean
|
|
gift_cards_taxable:
|
|
description: >-
|
|
Whether gift cards in this region should be applied sales
|
|
tax when purchasing a gift card
|
|
type: boolean
|
|
tax_provider_id:
|
|
description: >-
|
|
The ID of the tax provider to use; if null the system tax
|
|
provider is used
|
|
type: string
|
|
tax_code:
|
|
description: An optional tax code the Region.
|
|
type: string
|
|
tax_rate:
|
|
description: The tax rate to use on Orders in the Region.
|
|
type: number
|
|
payment_providers:
|
|
description: >-
|
|
A list of Payment Provider IDs that should be enabled for
|
|
the Region
|
|
type: array
|
|
items:
|
|
type: string
|
|
fulfillment_providers:
|
|
description: >-
|
|
A list of Fulfillment Provider IDs that should be enabled
|
|
for the Region
|
|
type: array
|
|
items:
|
|
type: string
|
|
countries:
|
|
description: >-
|
|
A list of countries' 2 ISO Characters that should be
|
|
included in the Region.
|
|
type: array
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
'/regions/{id}/fulfillment-options':
|
|
get:
|
|
operationId: GetRegionsRegionFulfillmentOptions
|
|
summary: List Fulfillment Options available in the Region
|
|
description: Gathers all the fulfillment options available to in the Region.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
fulfillment_options:
|
|
type: array
|
|
items:
|
|
properties:
|
|
provider_id:
|
|
type: string
|
|
description: ID of the fulfillment provider
|
|
options:
|
|
type: array
|
|
description: fulfillment provider options
|
|
example:
|
|
- id: manual-fulfillment
|
|
- id: manual-fulfillment-return
|
|
is_return: true
|
|
'/regions/{id}/countries/{country_code}':
|
|
delete:
|
|
operationId: PostRegionsRegionCountriesCountry
|
|
summary: Remove Country
|
|
x-authenticated: true
|
|
description: Removes a Country from the list of Countries in a Region
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: country_code
|
|
description: The 2 character ISO code for the Country.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
'/regions/{id}/fulfillment-providers/{provider_id}':
|
|
delete:
|
|
operationId: PostRegionsRegionFulfillmentProvidersProvider
|
|
summary: Remove Fulfillment Provider
|
|
description: Removes a Fulfillment Provider.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: provider_id
|
|
required: true
|
|
description: The ID of the Fulfillment Provider.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
'/regions/{id}/payment-providers/{provider_id}':
|
|
delete:
|
|
operationId: PostRegionsRegionPaymentProvidersProvider
|
|
summary: Remove Payment Provider
|
|
description: Removes a Payment Provider.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Region.
|
|
schema:
|
|
type: string
|
|
- in: path
|
|
name: provider_id
|
|
required: true
|
|
description: The ID of the Payment Provider.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Region
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/region'
|
|
/return-reasons:
|
|
post:
|
|
operationId: PostReturnReasons
|
|
summary: Create a Return Reason
|
|
description: Creates a Return Reason
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- label
|
|
- value
|
|
properties:
|
|
label:
|
|
description: The label to display to the Customer.
|
|
type: string
|
|
value:
|
|
description: >-
|
|
The value that the Return Reason will be identified by. Must
|
|
be unique.
|
|
type: string
|
|
parent_return_reason_id:
|
|
description: The ID of the parent return reason.
|
|
type: string
|
|
description:
|
|
description: An optional description to for the Reason.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Return Reason
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
return_reason:
|
|
$ref: '#/components/schemas/return_reason'
|
|
get:
|
|
operationId: GetReturnReasons
|
|
summary: List Return Reasons
|
|
description: Retrieves a list of Return Reasons.
|
|
x-authenticated: true
|
|
tags:
|
|
- Return Reason
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
return_reasons:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/return_reason'
|
|
'/return-reasons/{id}':
|
|
delete:
|
|
operationId: DeleteReturnReason
|
|
summary: Delete a return reason
|
|
description: Deletes a return reason.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the return reason
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Return Reason
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted return reason
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: return_reason
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetReturnReasonsReason
|
|
summary: Retrieve a Return Reason
|
|
description: Retrieves a Return Reason.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Return Reason.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Return Reason
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
return_reason:
|
|
$ref: '#/components/schemas/return_reason'
|
|
post:
|
|
operationId: PostReturnReasonsReason
|
|
summary: Update a Return Reason
|
|
description: Updates a Return Reason
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Return Reason.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
label:
|
|
description: The label to display to the Customer.
|
|
type: string
|
|
value:
|
|
description: >-
|
|
The value that the Return Reason will be identified by. Must
|
|
be unique.
|
|
type: string
|
|
description:
|
|
description: An optional description to for the Reason.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Return Reason
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
return_reason:
|
|
$ref: '#/components/schemas/return_reason'
|
|
'/returns/{id}/cancel':
|
|
post:
|
|
operationId: PostReturnsReturnCancel
|
|
summary: Cancel a Return
|
|
description: Registers a Return as canceled.
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Return.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Return
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/order'
|
|
/returns:
|
|
get:
|
|
operationId: GetReturns
|
|
summary: List Returns
|
|
description: Retrieves a list of Returns
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The upper limit for the amount of responses returned.
|
|
schema:
|
|
type: number
|
|
default: '50'
|
|
- in: query
|
|
name: offset
|
|
description: The offset of the list returned.
|
|
schema:
|
|
type: number
|
|
default: '0'
|
|
tags:
|
|
- Return
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
returns:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/return'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/returns/{id}/receive':
|
|
post:
|
|
operationId: PostReturnsReturnReceive
|
|
summary: Receive a Return
|
|
description: >-
|
|
Registers a Return as received. Updates statuses on Orders and Swaps
|
|
accordingly.
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Return.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- items
|
|
properties:
|
|
items:
|
|
description: The Line Items that have been received.
|
|
type: array
|
|
items:
|
|
required:
|
|
- item_id
|
|
- quantity
|
|
properties:
|
|
item_id:
|
|
description: The ID of the Line Item.
|
|
type: string
|
|
quantity:
|
|
description: The quantity of the Line Item.
|
|
type: integer
|
|
refund:
|
|
description: The amount to refund.
|
|
type: number
|
|
tags:
|
|
- Return
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
return:
|
|
$ref: '#/components/schemas/return'
|
|
'/sales-channels/{id}/products/batch':
|
|
post:
|
|
operationId: PostSalesChannelsChannelProductsBatch
|
|
summary: Assign a batch of product to a sales channel
|
|
description: Assign a batch of product to a sales channel.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Sales channel.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- product_ids
|
|
properties:
|
|
product_ids:
|
|
description: The IDs of the products to add to the Sales Channel
|
|
type: array
|
|
items:
|
|
type: object
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the product
|
|
tags:
|
|
- Sales Channel
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
sales_channel:
|
|
$ref: '#/components/schemas/sales_channel'
|
|
delete:
|
|
operationId: DeleteSalesChannelsChannelProductsBatch
|
|
summary: Remove a list of products from a sales channel
|
|
description: Remove a list of products from a sales channel.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Sales Channel
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- product_ids
|
|
properties:
|
|
product_ids:
|
|
description: The IDs of the products to delete from the Sales Channel.
|
|
type: array
|
|
items:
|
|
type: object
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: The ID of a product
|
|
type: string
|
|
tags:
|
|
- Sales Channel
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
sales_channel:
|
|
$ref: '#/components/schemas/sales_channel'
|
|
/sales-channels:
|
|
post:
|
|
operationId: PostSalesChannels
|
|
summary: Create a Sales Channel
|
|
description: Creates a Sales Channel.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- name
|
|
properties:
|
|
name:
|
|
description: The name of the Sales Channel
|
|
type: string
|
|
description:
|
|
description: The description of the Sales Channel
|
|
type: string
|
|
is_disabled:
|
|
description: Whether the Sales Channel is disabled or not.
|
|
type: boolean
|
|
tags:
|
|
- Sales Channel
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
sales_channel:
|
|
$ref: '#/components/schemas/sales_channel'
|
|
get:
|
|
operationId: GetSalesChannels
|
|
summary: List sales channels
|
|
description: Retrieves a list of sales channels
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: id
|
|
description: ID of the sales channel
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: name
|
|
description: Name of the sales channel
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: description
|
|
description: Description of the sales channel
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: q
|
|
description: Query used for searching sales channels' names and descriptions.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: order
|
|
description: The field to order the results by.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: created_at
|
|
description: Date comparison for when resulting collections were created.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: updated_at
|
|
description: Date comparison for when resulting collections were updated.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: deleted_at
|
|
description: Date comparison for when resulting collections were deleted.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
lt:
|
|
type: string
|
|
description: filter by dates less than this date
|
|
format: date
|
|
gt:
|
|
type: string
|
|
description: filter by dates greater than this date
|
|
format: date
|
|
lte:
|
|
type: string
|
|
description: filter by dates less than or equal to this date
|
|
format: date
|
|
gte:
|
|
type: string
|
|
description: filter by dates greater than or equal to this date
|
|
format: date
|
|
- in: query
|
|
name: offset
|
|
description: How many sales channels to skip in the result.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of sales channels returned.
|
|
schema:
|
|
type: integer
|
|
default: 20
|
|
- in: query
|
|
name: expand
|
|
description: >-
|
|
(Comma separated) Which fields should be expanded in each sales
|
|
channel of the result.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: >-
|
|
(Comma separated) Which fields should be included in each sales
|
|
channel of the result.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Sales Channel
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
sales_channels:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/sales_channel'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/sales-channels/{id}':
|
|
delete:
|
|
operationId: DeleteSalesChannelsSalesChannel
|
|
summary: Delete a sales channel
|
|
description: Deletes the sales channel.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Sales channel.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Sales Channel
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted sales channel
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: sales-channel
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetSalesChannelsSalesChannel
|
|
summary: Retrieve a sales channel
|
|
description: Retrieves the sales channel.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Sales channel.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Sales Channel
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
sales_channel:
|
|
$ref: '#/components/schemas/sales_channel'
|
|
post:
|
|
operationId: PostSalesChannelsSalesChannel
|
|
summary: Update a Sales Channel
|
|
description: Updates a Sales Channel.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Sales Channel.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
name:
|
|
type: string
|
|
description: Name of the sales channel.
|
|
description:
|
|
type: string
|
|
description: Sales Channel description.
|
|
is_disabled:
|
|
type: boolean
|
|
description: Indication of if the sales channel is active.
|
|
tags:
|
|
- Sales Channel
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
sales_channel:
|
|
$ref: '#/components/schemas/sales_channel'
|
|
/shipping-options:
|
|
post:
|
|
operationId: PostShippingOptions
|
|
summary: Create Shipping Option
|
|
description: Creates a Shipping Option
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- name
|
|
- region_id
|
|
- provider_id
|
|
- data
|
|
- price_type
|
|
properties:
|
|
name:
|
|
description: The name of the Shipping Option
|
|
type: string
|
|
region_id:
|
|
description: >-
|
|
The ID of the Region in which the Shipping Option will be
|
|
available.
|
|
type: string
|
|
provider_id:
|
|
description: >-
|
|
The ID of the Fulfillment Provider that handles the Shipping
|
|
Option.
|
|
type: string
|
|
profile_id:
|
|
description: >-
|
|
The ID of the Shipping Profile to add the Shipping Option
|
|
to.
|
|
type: number
|
|
data:
|
|
description: >-
|
|
The data needed for the Fulfillment Provider to handle
|
|
shipping with this Shipping Option.
|
|
type: object
|
|
price_type:
|
|
description: The type of the Shipping Option price.
|
|
type: string
|
|
enum:
|
|
- flat_rate
|
|
- calculated
|
|
amount:
|
|
description: The amount to charge for the Shipping Option.
|
|
type: integer
|
|
requirements:
|
|
description: >-
|
|
The requirements that must be satisfied for the Shipping
|
|
Option to be available.
|
|
type: array
|
|
items:
|
|
required:
|
|
- type
|
|
- amount
|
|
properties:
|
|
type:
|
|
description: The type of the requirement
|
|
type: string
|
|
enum:
|
|
- max_subtotal
|
|
- min_subtotal
|
|
amount:
|
|
description: The amount to compare with.
|
|
type: integer
|
|
is_return:
|
|
description: Whether the Shipping Option defines a return shipment.
|
|
type: boolean
|
|
default: false
|
|
admin_only:
|
|
description: 'If true, the option can be used for draft orders'
|
|
type: boolean
|
|
default: false
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Shipping Option
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
shipping_option:
|
|
$ref: '#/components/schemas/shipping_option'
|
|
get:
|
|
operationId: GetShippingOptions
|
|
summary: List Shipping Options
|
|
description: Retrieves a list of Shipping Options.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: region_id
|
|
schema:
|
|
type: string
|
|
description: Region ID to fetch options from
|
|
- in: query
|
|
name: is_return
|
|
schema:
|
|
type: boolean
|
|
description: Flag for fetching return options only
|
|
- in: query
|
|
name: admin_only
|
|
schema:
|
|
type: boolean
|
|
description: Flag for fetching admin specific options
|
|
tags:
|
|
- Shipping Option
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
shipping_options:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/shipping_option'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
'/shipping-options/{id}':
|
|
delete:
|
|
operationId: DeleteShippingOptionsOption
|
|
summary: Delete a Shipping Option
|
|
description: Deletes a Shipping Option.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Shipping Option.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Shipping Option
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Shipping Option.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: shipping-option
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetShippingOptionsOption
|
|
summary: Retrieve a Shipping Option
|
|
description: Retrieves a Shipping Option.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Shipping Option.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Shipping Option
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
shipping_option:
|
|
$ref: '#/components/schemas/shipping_option'
|
|
post:
|
|
operationId: PostShippingOptionsOption
|
|
summary: Update Shipping Option
|
|
description: Updates a Shipping Option
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Shipping Option.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- requirements
|
|
properties:
|
|
name:
|
|
description: The name of the Shipping Option
|
|
type: string
|
|
amount:
|
|
description: The amount to charge for the Shipping Option.
|
|
type: integer
|
|
admin_only:
|
|
description: 'If true, the option can be used for draft orders'
|
|
type: boolean
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
requirements:
|
|
description: >-
|
|
The requirements that must be satisfied for the Shipping
|
|
Option to be available.
|
|
type: array
|
|
items:
|
|
required:
|
|
- type
|
|
- amount
|
|
properties:
|
|
id:
|
|
description: The ID of the requirement
|
|
type: string
|
|
type:
|
|
description: The type of the requirement
|
|
type: string
|
|
enum:
|
|
- max_subtotal
|
|
- min_subtotal
|
|
amount:
|
|
description: The amount to compare with.
|
|
type: integer
|
|
tags:
|
|
- Shipping Option
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
shipping_option:
|
|
$ref: '#/components/schemas/shipping_option'
|
|
/shipping-profiles:
|
|
post:
|
|
operationId: PostShippingProfiles
|
|
summary: Create a Shipping Profile
|
|
description: Creates a Shipping Profile
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- name
|
|
properties:
|
|
name:
|
|
description: The name of the Shipping Profile
|
|
type: string
|
|
tags:
|
|
- Shipping Profile
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
shipping_profile:
|
|
$ref: '#/components/schemas/shipping_profile'
|
|
get:
|
|
operationId: GetShippingProfiles
|
|
summary: List Shipping Profiles
|
|
description: Retrieves a list of Shipping Profile.
|
|
x-authenticated: true
|
|
tags:
|
|
- Shipping Profile
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
shipping_profiles:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/shipping_profile'
|
|
'/shipping-profiles/{id}':
|
|
delete:
|
|
operationId: DeleteShippingProfilesProfile
|
|
summary: Delete a Shipping Profile
|
|
description: Deletes a Shipping Profile.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Shipping Profile.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Shipping Profile
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Shipping Profile.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: shipping_profile
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetShippingProfilesProfile
|
|
summary: Retrieve a Shipping Profile
|
|
description: Retrieves a Shipping Profile.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Shipping Profile.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Shipping Profile
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
shipping_profile:
|
|
$ref: '#/components/schemas/shipping_profile'
|
|
post:
|
|
operationId: PostShippingProfilesProfile
|
|
summary: Update a Shipping Profiles
|
|
description: Updates a Shipping Profile
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Shipping Profile.
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
name:
|
|
description: The name of the Shipping Profile
|
|
type: string
|
|
tags:
|
|
- Shipping Profile
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
shipping_profile:
|
|
$ref: '#/components/schemas/shipping_profile'
|
|
'/store/currencies/{code}':
|
|
post:
|
|
operationId: PostStoreCurrenciesCode
|
|
summary: Add a Currency Code
|
|
description: Adds a Currency Code to the available currencies.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: code
|
|
required: true
|
|
description: The 3 character ISO currency code.
|
|
schema:
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
tags:
|
|
- Store
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
store:
|
|
$ref: '#/components/schemas/store'
|
|
delete:
|
|
operationId: DeleteStoreCurrenciesCode
|
|
summary: Remove a Currency Code
|
|
description: Removes a Currency Code from the available currencies.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: code
|
|
required: true
|
|
description: The 3 character ISO currency code.
|
|
schema:
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
tags:
|
|
- Store
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
store:
|
|
$ref: '#/components/schemas/store'
|
|
/store:
|
|
get:
|
|
operationId: GetStore
|
|
summary: Retrieve Store details.
|
|
description: Retrieves the Store details
|
|
x-authenticated: true
|
|
tags:
|
|
- Store
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
store:
|
|
$ref: '#/components/schemas/store'
|
|
post:
|
|
operationId: PostStore
|
|
summary: Update Store details.
|
|
description: Updates the Store details
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
name:
|
|
description: The name of the Store
|
|
type: string
|
|
swap_link_template:
|
|
description: >-
|
|
A template for Swap links - use `{{cart_id}}` to insert the
|
|
Swap Cart id
|
|
type: string
|
|
payment_link_template:
|
|
description: >-
|
|
A template for payment links links - use `{{cart_id}}` to
|
|
insert the Cart id
|
|
type: string
|
|
invite_link_template:
|
|
description: >-
|
|
A template for invite links - use `{{invite_token}}` to
|
|
insert the invite token
|
|
type: string
|
|
default_currency_code:
|
|
description: The default currency code for the Store.
|
|
type: string
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
currencies:
|
|
description: Array of currencies in 2 character ISO code format.
|
|
type: array
|
|
items:
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- Store
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
store:
|
|
$ref: '#/components/schemas/store'
|
|
/store/payment-providers:
|
|
get:
|
|
operationId: GetStorePaymentProviders
|
|
summary: Retrieve configured Payment Providers
|
|
description: Retrieves the configured Payment Providers
|
|
x-authenticated: true
|
|
tags:
|
|
- Store
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
payment_providers:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/payment_provider'
|
|
/store/tax-providers:
|
|
get:
|
|
operationId: GetStoreTaxProviders
|
|
summary: Retrieve configured Tax Providers
|
|
description: Retrieves the configured Tax Providers
|
|
x-authenticated: true
|
|
tags:
|
|
- Store
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_providers:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/tax_provider'
|
|
'/swaps/{id}':
|
|
get:
|
|
operationId: GetSwapsSwap
|
|
summary: Retrieve a Swap
|
|
description: Retrieves a Swap.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Swap.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Swap
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
swap:
|
|
$ref: '#/components/schemas/swap'
|
|
/swaps:
|
|
get:
|
|
operationId: GetSwaps
|
|
summary: List Swaps
|
|
description: Retrieves a list of Swaps.
|
|
parameters:
|
|
- in: query
|
|
name: limit
|
|
description: The upper limit for the amount of responses returned.
|
|
schema:
|
|
type: number
|
|
default: '50'
|
|
- in: query
|
|
name: offset
|
|
description: The offset of the list returned.
|
|
schema:
|
|
type: number
|
|
default: '0'
|
|
x-authenticated: true
|
|
tags:
|
|
- Swap
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
swaps:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/swap'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/tax-rates/{id}/product-types/batch':
|
|
post:
|
|
operationId: PostTaxRatesTaxRateProductTypes
|
|
summary: Add Tax Rate to Product Types
|
|
description: Associates a Tax Rate with a list of Product Types
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the tax rate.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- product_types
|
|
properties:
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
The IDs of the types of products to associate with this tax
|
|
rate
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
delete:
|
|
operationId: DeleteTaxRatesTaxRateProductTypes
|
|
summary: Remove Tax Rate from Product Types
|
|
description: Removes a Tax Rate from a list of Product Types
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the tax rate.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- product_types
|
|
properties:
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
The IDs of the types of products to remove association with
|
|
this tax rate
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
'/tax-rates/{id}/products/batch':
|
|
post:
|
|
operationId: PostTaxRatesTaxRateProducts
|
|
summary: Add Tax Rate to Products
|
|
description: Associates a Tax Rate with a list of Products
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the tax rate.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- products
|
|
properties:
|
|
products:
|
|
type: array
|
|
description: The IDs of the products to associate with this tax rate
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
delete:
|
|
operationId: DeleteTaxRatesTaxRateProducts
|
|
summary: Removes Tax Rate from Products
|
|
description: Removes a Tax Rate from a list of Products
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the tax rate.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- products
|
|
properties:
|
|
products:
|
|
type: array
|
|
description: >-
|
|
The IDs of the products to remove association with this tax
|
|
rate
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
'/tax-rates/{id}/shipping-options/batch':
|
|
post:
|
|
operationId: PostTaxRatesTaxRateShippingOptions
|
|
summary: Add Tax Rate to Product Types
|
|
description: Associates a Tax Rate with a list of Shipping Options
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the tax rate.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- shipping_options
|
|
properties:
|
|
shipping_options:
|
|
type: array
|
|
description: >-
|
|
The IDs of the shipping options to associate with this tax
|
|
rate
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
delete:
|
|
operationId: DeleteTaxRatesTaxRateShippingOptions
|
|
summary: Removes a Tax Rate from Product Types
|
|
description: Removes a Tax Rate from a list of Product Types
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the tax rate.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- shipping_options
|
|
properties:
|
|
shipping_options:
|
|
type: array
|
|
description: >-
|
|
The IDs of the shipping options to remove association with
|
|
this tax rate
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
/tax-rates:
|
|
post:
|
|
operationId: PostTaxRates
|
|
summary: Create a Tax Rate
|
|
description: Creates a Tax Rate
|
|
parameters:
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- code
|
|
- name
|
|
- region_id
|
|
properties:
|
|
code:
|
|
type: string
|
|
description: A code to identify the tax type by
|
|
name:
|
|
type: string
|
|
description: A human friendly name for the tax
|
|
region_id:
|
|
type: string
|
|
description: The ID of the Region that the rate belongs to
|
|
rate:
|
|
type: number
|
|
description: The numeric rate to charge
|
|
products:
|
|
type: array
|
|
description: The IDs of the products associated with this tax rate
|
|
items:
|
|
type: string
|
|
shipping_options:
|
|
type: array
|
|
description: >-
|
|
The IDs of the shipping options associated with this tax
|
|
rate
|
|
items:
|
|
type: string
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
The IDs of the types of products associated with this tax
|
|
rate
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
get:
|
|
operationId: GetTaxRates
|
|
summary: List Tax Rates
|
|
description: Retrieves a list of TaxRates
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: name
|
|
description: Name of tax rate to retrieve
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: region_id
|
|
style: form
|
|
explode: false
|
|
description: Filter by Region ID
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
- type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: code
|
|
description: code to search for.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: rate
|
|
style: form
|
|
explode: false
|
|
description: Filter by Rate
|
|
schema:
|
|
oneOf:
|
|
- type: number
|
|
- type: object
|
|
properties:
|
|
lt:
|
|
type: number
|
|
description: filter by rates less than this number
|
|
gt:
|
|
type: number
|
|
description: filter by rates greater than this number
|
|
lte:
|
|
type: number
|
|
description: filter by rates less than or equal to this number
|
|
gte:
|
|
type: number
|
|
description: filter by rates greater than or equal to this number
|
|
- in: query
|
|
name: offset
|
|
description: How many tax rates to skip before retrieving the result.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of tax rates returned.
|
|
schema:
|
|
type: integer
|
|
default: 50
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in each item.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved for each item.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rates:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
'/tax-rates/{id}':
|
|
delete:
|
|
operationId: DeleteTaxRatesTaxRate
|
|
summary: Delete a Tax Rate
|
|
description: Deletes a Tax Rate
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the Shipping Option.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted Shipping Option.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: tax-rate
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetTaxRatesTaxRate
|
|
summary: Get Tax Rate
|
|
description: Retrieves a TaxRate
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the tax rate.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
post:
|
|
operationId: PostTaxRatesTaxRate
|
|
summary: Update a Tax Rate
|
|
description: Updates a Tax Rate
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: ID of the tax rate.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: fields
|
|
description: Which fields should be included in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
- in: query
|
|
name: expand
|
|
description: Which fields should be expanded and retrieved in the result.
|
|
style: form
|
|
explode: false
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
code:
|
|
type: string
|
|
description: A code to identify the tax type by
|
|
name:
|
|
type: string
|
|
description: A human friendly name for the tax
|
|
region_id:
|
|
type: string
|
|
description: The ID of the Region that the rate belongs to
|
|
rate:
|
|
type: number
|
|
description: The numeric rate to charge
|
|
products:
|
|
type: array
|
|
description: The IDs of the products associated with this tax rate
|
|
items:
|
|
type: string
|
|
shipping_options:
|
|
type: array
|
|
description: >-
|
|
The IDs of the shipping options associated with this tax
|
|
rate
|
|
items:
|
|
type: string
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
The IDs of the types of products associated with this tax
|
|
rate
|
|
items:
|
|
type: string
|
|
tags:
|
|
- Tax Rate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
/uploads:
|
|
post:
|
|
operationId: PostUploads
|
|
summary: Uploads a file
|
|
description: Uploads a file to the specific fileservice that is installed in Medusa.
|
|
x-authenticated: true
|
|
tags:
|
|
- Upload
|
|
requestBody:
|
|
content:
|
|
multipart/form-data:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
files:
|
|
type: string
|
|
format: binary
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
uploads:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
url:
|
|
type: string
|
|
description: The URL of the uploaded file.
|
|
format: uri
|
|
/users:
|
|
post:
|
|
operationId: PostUsers
|
|
summary: Create a User
|
|
description: Creates a User
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- email
|
|
- password
|
|
properties:
|
|
email:
|
|
description: The Users email.
|
|
type: string
|
|
format: email
|
|
first_name:
|
|
description: The name of the User.
|
|
type: string
|
|
last_name:
|
|
description: The name of the User.
|
|
type: string
|
|
role:
|
|
description: Userrole assigned to the user.
|
|
type: string
|
|
enum:
|
|
- admin
|
|
- member
|
|
- developer
|
|
password:
|
|
description: The Users password.
|
|
type: string
|
|
format: password
|
|
tags:
|
|
- User
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
user:
|
|
$ref: '#/components/schemas/user'
|
|
get:
|
|
operationId: GetUsers
|
|
summary: Retrieve all users
|
|
description: Retrieves all users.
|
|
x-authenticated: true
|
|
tags:
|
|
- User
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
users:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/user'
|
|
'/users/{id}':
|
|
delete:
|
|
operationId: DeleteUsersUser
|
|
summary: Delete a User
|
|
description: Deletes a User
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the User.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- Users
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The ID of the deleted user.
|
|
object:
|
|
type: string
|
|
description: The type of the object that was deleted.
|
|
default: user
|
|
deleted:
|
|
type: boolean
|
|
description: Whether or not the items were deleted.
|
|
default: true
|
|
get:
|
|
operationId: GetUsersUser
|
|
summary: Retrieve a User
|
|
description: Retrieves a User.
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the User.
|
|
schema:
|
|
type: string
|
|
tags:
|
|
- User
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
user:
|
|
$ref: '#/components/schemas/user'
|
|
post:
|
|
operationId: PostUsersUser
|
|
summary: Update a User
|
|
description: Updates a User
|
|
parameters:
|
|
- in: path
|
|
name: id
|
|
required: true
|
|
description: The ID of the User.
|
|
schema:
|
|
type: string
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
first_name:
|
|
description: The name of the User.
|
|
type: string
|
|
last_name:
|
|
description: The name of the User.
|
|
type: string
|
|
role:
|
|
description: Userrole assigned to the user.
|
|
type: string
|
|
enum:
|
|
- admin
|
|
- member
|
|
- developer
|
|
api_token:
|
|
description: The api token of the User.
|
|
type: string
|
|
metadata:
|
|
description: >-
|
|
An optional set of key-value pairs with additional
|
|
information.
|
|
type: object
|
|
tags:
|
|
- User
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
user:
|
|
$ref: '#/components/schemas/user'
|
|
/users/password-token:
|
|
post:
|
|
operationId: PostUsersUserPasswordToken
|
|
summary: Generate a password token for a User.
|
|
description: Generates a password token for a User with a given email.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- email
|
|
properties:
|
|
email:
|
|
description: The Users email.
|
|
type: string
|
|
format: email
|
|
tags:
|
|
- User
|
|
responses:
|
|
'204':
|
|
description: OK
|
|
/users/reset-password:
|
|
post:
|
|
operationId: PostUsersUserPassword
|
|
summary: Set the password for a User.
|
|
description: Sets the password for a User given the correct token.
|
|
x-authenticated: true
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
required:
|
|
- token
|
|
- password
|
|
properties:
|
|
email:
|
|
description: The Users email.
|
|
type: string
|
|
format: email
|
|
token:
|
|
description: The token generated from the 'password-token' endpoint.
|
|
type: string
|
|
password:
|
|
description: The Users new password.
|
|
type: string
|
|
format: password
|
|
tags:
|
|
- User
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
user:
|
|
$ref: '#/components/schemas/user'
|
|
/variants:
|
|
get:
|
|
operationId: GetVariants
|
|
summary: List Product Variants.
|
|
description: Retrieves a list of Product Variants
|
|
x-authenticated: true
|
|
parameters:
|
|
- in: query
|
|
name: q
|
|
description: Query used for searching variants.
|
|
schema:
|
|
type: string
|
|
- in: query
|
|
name: offset
|
|
description: How many variants to skip in the result.
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
- in: query
|
|
name: limit
|
|
description: Limit the number of variants returned.
|
|
schema:
|
|
type: integer
|
|
default: 20
|
|
tags:
|
|
- Product Variant
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
variants:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_variant'
|
|
count:
|
|
type: integer
|
|
description: The total number of items available
|
|
offset:
|
|
type: integer
|
|
description: The number of items skipped before these items
|
|
limit:
|
|
type: integer
|
|
description: The number of items per page
|
|
components:
|
|
schemas:
|
|
address:
|
|
title: Address
|
|
description: An address.
|
|
x-resourceId: address
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: ID of the address
|
|
example: addr_01G8ZC9VS1XVE149MGH2J7QSSH
|
|
customer_id:
|
|
type: string
|
|
description: ID of the customer this address belongs to
|
|
example: cus_01G2SG30J8C85S4A5CHM2S1NS2
|
|
customer:
|
|
description: Available if the relation `customer` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A customer object.
|
|
company:
|
|
type: string
|
|
description: Company name
|
|
example: Acme
|
|
first_name:
|
|
type: string
|
|
description: First name
|
|
example: Arno
|
|
last_name:
|
|
type: string
|
|
description: Last name
|
|
example: Willms
|
|
address_1:
|
|
type: string
|
|
description: Address line 1
|
|
example: 14433 Kemmer Court
|
|
address_2:
|
|
type: string
|
|
description: Address line 2
|
|
example: Suite 369
|
|
city:
|
|
type: string
|
|
description: City
|
|
example: South Geoffreyview
|
|
country_code:
|
|
type: string
|
|
description: The 2 character ISO code of the country in lower case
|
|
externalDocs:
|
|
url: >-
|
|
https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
|
|
description: See a list of codes.
|
|
example: st
|
|
country:
|
|
description: A country object. Available if the relation `country` is expanded.
|
|
type: object
|
|
province:
|
|
type: string
|
|
description: Province
|
|
example: Kentucky
|
|
postal_code:
|
|
type: string
|
|
description: Postal Code
|
|
example: 72093
|
|
phone:
|
|
type: string
|
|
description: Phone Number
|
|
example: 16128234334802
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
batch_job:
|
|
title: Batch Job
|
|
description: A Batch Job.
|
|
x-resourceId: batch_job
|
|
required:
|
|
- type
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The unique identifier for the batch job.
|
|
example: batch_01G8T782965PYFG0751G0Z38B4
|
|
type:
|
|
type: string
|
|
description: The type of batch job.
|
|
enum:
|
|
- product-import
|
|
- product-export
|
|
status:
|
|
type: string
|
|
description: The status of the batch job.
|
|
enum:
|
|
- created
|
|
- pre_processed
|
|
- confirmed
|
|
- processing
|
|
- completed
|
|
- canceled
|
|
- failed
|
|
default: created
|
|
created_by:
|
|
type: string
|
|
description: The unique identifier of the user that created the batch job.
|
|
example: usr_01G1G5V26F5TB3GPAPNJ8X1S3V
|
|
created_by_user:
|
|
description: >-
|
|
A user object. Available if the relation `created_by_user` is
|
|
expanded.
|
|
type: object
|
|
context:
|
|
type: object
|
|
description: >-
|
|
The context of the batch job, the type of the batch job determines
|
|
what the context should contain.
|
|
example:
|
|
shape:
|
|
prices:
|
|
- region: null
|
|
currency_code: eur
|
|
dynamicImageColumnCount: 4
|
|
dynamicOptionColumnCount: 2
|
|
list_config:
|
|
skip: 0
|
|
take: 50
|
|
order:
|
|
created_at: DESC
|
|
relations:
|
|
- variants
|
|
- variant.prices
|
|
- images
|
|
dry_run:
|
|
type: boolean
|
|
description: Specify if the job must apply the modifications or not.
|
|
default: false
|
|
result:
|
|
type: object
|
|
description: The result of the batch job.
|
|
properties:
|
|
count:
|
|
type: number
|
|
advancement_count:
|
|
type: number
|
|
progress:
|
|
type: number
|
|
errors:
|
|
type: object
|
|
properties:
|
|
message:
|
|
type: string
|
|
code:
|
|
oneOf:
|
|
- type: string
|
|
- type: number
|
|
err:
|
|
type: array
|
|
stat_descriptors:
|
|
type: object
|
|
properties:
|
|
key:
|
|
type: string
|
|
name:
|
|
type: string
|
|
message:
|
|
type: string
|
|
file_key:
|
|
type: string
|
|
file_size:
|
|
type: number
|
|
example:
|
|
errors:
|
|
- err: []
|
|
code: unknown
|
|
message: Method not implemented.
|
|
stat_descriptors:
|
|
- key: product-export-count
|
|
name: Product count to export
|
|
message: There will be 8 products exported by this action
|
|
pre_processed_at:
|
|
type: string
|
|
description: The date from which the job has been pre processed.
|
|
format: date-time
|
|
processing_at:
|
|
type: string
|
|
description: The date the job is processing at.
|
|
format: date-time
|
|
confirmed_at:
|
|
type: string
|
|
description: The date when the confirmation has been done.
|
|
format: date-time
|
|
completed_at:
|
|
type: string
|
|
description: The date of the completion.
|
|
format: date-time
|
|
canceled_at:
|
|
type: string
|
|
description: The date of the concellation.
|
|
format: date-time
|
|
failed_at:
|
|
type: string
|
|
description: The date when the job failed.
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was last updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
cart:
|
|
title: Cart
|
|
description: Represents a user cart
|
|
x-resourceId: cart
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The cart's ID
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
email:
|
|
type: string
|
|
description: The email associated with the cart
|
|
format: email
|
|
billing_address_id:
|
|
type: string
|
|
description: The billing address's ID
|
|
example: addr_01G8ZH853YPY9B94857DY91YGW
|
|
billing_address:
|
|
description: Available if the relation `billing_address` is expanded.
|
|
$ref: '#/components/schemas/address'
|
|
shipping_address_id:
|
|
type: string
|
|
description: The shipping address's ID
|
|
example: addr_01G8ZH853YPY9B94857DY91YGW
|
|
shipping_address:
|
|
description: Available if the relation `shipping_address` is expanded.
|
|
$ref: '#/components/schemas/address'
|
|
items:
|
|
description: Available if the relation `items` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/line_item'
|
|
region_id:
|
|
type: string
|
|
description: The region's ID
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
region:
|
|
description: A region object. Available if the relation `region` is expanded.
|
|
type: object
|
|
discounts:
|
|
type: array
|
|
description: Available if the relation `discounts` is expanded.
|
|
items:
|
|
type: object
|
|
description: A discount object.
|
|
gift_cards:
|
|
type: array
|
|
description: Available if the relation `gift_cards` is expanded.
|
|
items:
|
|
type: object
|
|
description: A gift card object.
|
|
customer_id:
|
|
type: string
|
|
description: The customer's ID
|
|
example: cus_01G2SG30J8C85S4A5CHM2S1NS2
|
|
customer:
|
|
description: A customer object. Available if the relation `customer` is expanded.
|
|
type: object
|
|
payment_session:
|
|
description: The selected payment session in the cart.
|
|
$ref: '#/components/schemas/payment_session'
|
|
payment_sessions:
|
|
type: array
|
|
description: The payment sessions created on the cart.
|
|
items:
|
|
$ref: '#/components/schemas/payment_session'
|
|
payment_id:
|
|
type: string
|
|
description: The payment's ID if available
|
|
example: pay_01G8ZCC5W42ZNY842124G7P5R9
|
|
payment:
|
|
description: Available if the relation `payment` is expanded.
|
|
$ref: '#/components/schemas/payment'
|
|
shipping_methods:
|
|
type: array
|
|
description: The shipping methods added to the cart.
|
|
items:
|
|
$ref: '#/components/schemas/shipping_method'
|
|
type:
|
|
type: string
|
|
description: The cart's type.
|
|
enum:
|
|
- default
|
|
- swap
|
|
- draft_order
|
|
- payment_link
|
|
- claim
|
|
default: default
|
|
completed_at:
|
|
type: string
|
|
description: The date with timezone at which the cart was completed.
|
|
format: date-time
|
|
payment_authorized_at:
|
|
type: string
|
|
description: The date with timezone at which the payment was authorized.
|
|
format: date-time
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of a cart in
|
|
case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
context:
|
|
type: object
|
|
description: >-
|
|
The context of the cart which can include info like IP or user
|
|
agent.
|
|
example:
|
|
ip: '::1'
|
|
user_agent: PostmanRuntime/7.29.2
|
|
sales_channel_id:
|
|
type: string
|
|
description: The sales channel ID the cart is associated with.
|
|
example: null
|
|
sales_channel:
|
|
description: >-
|
|
A sales channel object. Available if the relation `sales_channel` is
|
|
expanded.
|
|
type: object
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
shipping_total:
|
|
type: integer
|
|
description: The total of shipping
|
|
example: 1000
|
|
discount_total:
|
|
type: integer
|
|
description: The total of discount
|
|
example: 800
|
|
tax_total:
|
|
type: integer
|
|
description: The total of tax
|
|
example: 0
|
|
refunded_total:
|
|
type: integer
|
|
description: >-
|
|
The total amount refunded if the order associated with this cart is
|
|
returned.
|
|
example: 0
|
|
total:
|
|
type: integer
|
|
description: The total amount of the cart
|
|
example: 8200
|
|
subtotal:
|
|
type: integer
|
|
description: The subtotal of the cart
|
|
example: 8000
|
|
refundable_amount:
|
|
type: integer
|
|
description: The amount that can be refunded
|
|
example: 8200
|
|
gift_card_total:
|
|
type: integer
|
|
description: The total of gift cards
|
|
example: 0
|
|
gift_card_tax_total:
|
|
type: integer
|
|
description: The total of gift cards with taxes
|
|
example: 0
|
|
claim_image:
|
|
title: Claim Image
|
|
description: Represents photo documentation of a claim.
|
|
x-resourceId: claim_image
|
|
required:
|
|
- claim_item_id
|
|
- url
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The claim image's ID
|
|
example: cimg_01G8ZH853Y6TFXWPG5EYE81X63
|
|
claim_item_id:
|
|
type: string
|
|
description: The ID of the claim item associated with the image
|
|
claim_item:
|
|
description: >-
|
|
A claim item object. Available if the relation `claim_item` is
|
|
expanded.
|
|
type: object
|
|
url:
|
|
type: string
|
|
description: The URL of the image
|
|
format: uri
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
claim_item:
|
|
title: Claim Item
|
|
description: >-
|
|
Represents a claimed item along with information about the reasons for
|
|
the claim.
|
|
x-resourceId: claim_item
|
|
required:
|
|
- claim_order_id
|
|
- item_id
|
|
- variant_id
|
|
- reason
|
|
- quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The claim item's ID
|
|
example: citm_01G8ZH853Y6TFXWPG5EYE81X63
|
|
images:
|
|
type: array
|
|
description: Available if the relation `images` is expanded.
|
|
items:
|
|
$ref: '#/components/schemas/claim_image'
|
|
claim_order_id:
|
|
description: The ID of the claim this item is associated with.
|
|
type: string
|
|
claim_order:
|
|
description: >-
|
|
A claim order object. Available if the relation `claim_order` is
|
|
expanded.
|
|
type: object
|
|
item_id:
|
|
description: The ID of the line item that the claim item refers to.
|
|
type: string
|
|
example: item_01G8ZM25TN49YV9EQBE2NC27KC
|
|
item:
|
|
description: Available if the relation `item` is expanded.
|
|
$ref: '#/components/schemas/line_item'
|
|
variant_id:
|
|
description: The ID of the product variant that is claimed.
|
|
type: string
|
|
example: variant_01G1G5V2MRX2V3PVSR2WXYPFB6
|
|
variant:
|
|
description: A variant object. Available if the relation `variant` is expanded.
|
|
type: object
|
|
reason:
|
|
description: The reason for the claim
|
|
type: string
|
|
enum:
|
|
- missing_item
|
|
- wrong_item
|
|
- production_failure
|
|
- other
|
|
note:
|
|
description: 'An optional note about the claim, for additional information'
|
|
type: string
|
|
example: I don't like it.
|
|
quantity:
|
|
description: >-
|
|
The quantity of the item that is being claimed; must be less than or
|
|
equal to the amount purchased in the original order.
|
|
type: integer
|
|
example: 1
|
|
tags:
|
|
description: >-
|
|
User defined tags for easy filtering and grouping. Available if the
|
|
relation 'tags' is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/claim_tag'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
claim_order:
|
|
title: Claim Order
|
|
description: >-
|
|
Claim Orders represent a group of faulty or missing items. Each claim
|
|
order consists of a subset of items associated with an original order,
|
|
and can contain additional information about fulfillments and returns.
|
|
x-resourceId: claim_order
|
|
required:
|
|
- type
|
|
- order_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The claim's ID
|
|
example: claim_01G8ZH853Y6TFXWPG5EYE81X63
|
|
type:
|
|
type: string
|
|
enum:
|
|
- refund
|
|
- replace
|
|
payment_status:
|
|
type: string
|
|
description: The status of the claim's payment
|
|
enum:
|
|
- na
|
|
- not_refunded
|
|
- refunded
|
|
default: na
|
|
fulfillment_status:
|
|
type: string
|
|
enum:
|
|
- not_fulfilled
|
|
- partially_fulfilled
|
|
- fulfilled
|
|
- partially_shipped
|
|
- shipped
|
|
- partially_returned
|
|
- returned
|
|
- canceled
|
|
- requires_action
|
|
default: not_fulfilled
|
|
claim_items:
|
|
description: The items that have been claimed
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/claim_item'
|
|
additional_items:
|
|
description: >-
|
|
Refers to the new items to be shipped when the claim order has the
|
|
type `replace`
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/line_item'
|
|
order_id:
|
|
description: The ID of the order that the claim comes from.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
return_order:
|
|
description: >-
|
|
A return object. Holds information about the return if the claim is
|
|
to be returned. Available if the relation 'return_order' is expanded
|
|
type: object
|
|
shipping_address_id:
|
|
description: The ID of the address that the new items should be shipped to
|
|
type: string
|
|
example: addr_01G8ZH853YPY9B94857DY91YGW
|
|
shipping_address:
|
|
description: Available if the relation `shipping_address` is expanded.
|
|
$ref: '#/components/schemas/address'
|
|
shipping_methods:
|
|
description: The shipping methods that the claim order will be shipped with.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/shipping_method'
|
|
fulfillments:
|
|
description: The fulfillments of the new items to be shipped
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/fulfillment'
|
|
refund_amount:
|
|
description: The amount that will be refunded in conjunction with the claim
|
|
type: integer
|
|
example: 1000
|
|
canceled_at:
|
|
description: The date with timezone at which the claim was canceled.
|
|
type: string
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
no_notification:
|
|
description: >-
|
|
Flag for describing whether or not notifications related to this
|
|
should be send.
|
|
type: boolean
|
|
example: false
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of the cart
|
|
associated with the claim in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
claim_tag:
|
|
title: Claim Tag
|
|
description: >-
|
|
Claim Tags are user defined tags that can be assigned to claim items for
|
|
easy filtering and grouping.
|
|
x-resourceId: claim_tag
|
|
required:
|
|
- value
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The claim tag's ID
|
|
example: ctag_01G8ZCC5Y63B95V6B5SHBZ91S4
|
|
value:
|
|
description: The value that the claim tag holds
|
|
type: string
|
|
example: Damaged
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
country:
|
|
title: Country
|
|
description: Country details
|
|
x-resourceId: country
|
|
required:
|
|
- iso_2
|
|
- iso_3
|
|
- num_code
|
|
- name
|
|
- display_name
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The country's ID
|
|
example: 109
|
|
iso_2:
|
|
type: string
|
|
description: The 2 character ISO code of the country in lower case
|
|
example: it
|
|
externalDocs:
|
|
url: >-
|
|
https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
|
|
description: See a list of codes.
|
|
iso_3:
|
|
type: string
|
|
description: The 2 character ISO code of the country in lower case
|
|
example: ita
|
|
externalDocs:
|
|
url: >-
|
|
https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements
|
|
description: See a list of codes.
|
|
num_code:
|
|
description: The numerical ISO code for the country.
|
|
type: string
|
|
example: 380
|
|
externalDocs:
|
|
url: >-
|
|
https://en.wikipedia.org/wiki/ISO_3166-1_numeric#Officially_assigned_code_elements
|
|
description: See a list of codes.
|
|
name:
|
|
description: The normalized country name in upper case.
|
|
type: string
|
|
example: ITALY
|
|
display_name:
|
|
description: The country name appropriate for display.
|
|
type: string
|
|
example: Italy
|
|
region_id:
|
|
type: string
|
|
description: The region ID this country is associated with.
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
region:
|
|
description: A region object. Available if the relation `region` is expanded.
|
|
type: object
|
|
currency:
|
|
title: Currency
|
|
description: Currency
|
|
x-resourceId: currency
|
|
required:
|
|
- code
|
|
- symbol
|
|
- symbol_native
|
|
- name
|
|
properties:
|
|
code:
|
|
description: The 3 character ISO code for the currency.
|
|
type: string
|
|
example: usd
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
symbol:
|
|
description: The symbol used to indicate the currency.
|
|
type: string
|
|
example: $
|
|
symbol_native:
|
|
description: The native symbol used to indicate the currency.
|
|
type: string
|
|
example: $
|
|
name:
|
|
description: The written name of the currency
|
|
type: string
|
|
example: US Dollar
|
|
custom_shipping_option:
|
|
title: Custom Shipping Option
|
|
description: >-
|
|
Custom Shipping Options are 'overriden' Shipping Options. Store managers
|
|
can attach a Custom Shipping Option to a cart in order to set a custom
|
|
price for a particular Shipping Option
|
|
x-resourceId: custom_shipping_option
|
|
required:
|
|
- price
|
|
- shipping_option_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The custom shipping option's ID
|
|
example: cso_01G8X99XNB77DMFBJFWX6DN9V9
|
|
price:
|
|
description: >-
|
|
The custom price set that will override the shipping option's
|
|
original price
|
|
type: integer
|
|
example: 1000
|
|
shipping_option_id:
|
|
description: >-
|
|
The ID of the Shipping Option that the custom shipping option
|
|
overrides
|
|
type: string
|
|
example: so_01G1G5V27GYX4QXNARRQCW1N8T
|
|
shipping_option:
|
|
description: >-
|
|
A shipping option object. Available if the relation
|
|
`shipping_option` is expanded.
|
|
type: object
|
|
cart_id:
|
|
description: The ID of the Cart that the custom shipping option is attached to
|
|
type: string
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
cart:
|
|
description: A cart object. Available if the relation `cart` is expanded.
|
|
type: object
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
customer_group:
|
|
title: Customer Group
|
|
description: Represents a customer group
|
|
x-resourceId: customer_group
|
|
required:
|
|
- name
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The customer group's ID
|
|
example: cgrp_01G8ZH853Y6TFXWPG5EYE81X63
|
|
name:
|
|
type: string
|
|
description: The name of the customer group
|
|
example: VIP
|
|
customers:
|
|
type: array
|
|
description: >-
|
|
The customers that belong to the customer group. Available if the
|
|
relation `customers` is expanded.
|
|
items:
|
|
type: object
|
|
description: A customer object.
|
|
price_lists:
|
|
type: array
|
|
description: >-
|
|
The price lists that are associated with the customer group.
|
|
Available if the relation `price_lists` is expanded.
|
|
items:
|
|
$ref: '#/components/schemas/price_list'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
customer:
|
|
title: Customer
|
|
description: Represents a customer
|
|
x-resourceId: customer
|
|
required:
|
|
- email
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The customer's ID
|
|
example: cus_01G2SG30J8C85S4A5CHM2S1NS2
|
|
email:
|
|
type: string
|
|
description: The customer's email
|
|
format: email
|
|
first_name:
|
|
type: string
|
|
description: The customer's first name
|
|
example: Arno
|
|
last_name:
|
|
type: string
|
|
description: The customer's first name
|
|
example: Willms
|
|
billing_address_id:
|
|
type: string
|
|
description: The customer's billing address ID
|
|
example: addr_01G8ZH853YPY9B94857DY91YGW
|
|
billing_address:
|
|
description: Available if the relation `billing_address` is expanded.
|
|
$ref: '#/components/schemas/address'
|
|
shipping_addresses:
|
|
description: Available if the relation `shipping_addresses` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/address'
|
|
phone:
|
|
type: string
|
|
description: The customer's phone number
|
|
example: 16128234334802
|
|
has_account:
|
|
type: boolean
|
|
description: Whether the customer has an account or not
|
|
default: false
|
|
orders:
|
|
description: Available if the relation `orders` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: An order object.
|
|
groups:
|
|
description: >-
|
|
The customer groups the customer belongs to. Available if the
|
|
relation `groups` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/customer_group'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
discount_condition_customer_group:
|
|
title: Product Tag Discount Condition
|
|
description: Associates a discount condition with a customer group
|
|
x-resourceId: discount_condition_customer_group
|
|
required:
|
|
- customer_group_id
|
|
- condition_id
|
|
properties:
|
|
customer_group_id:
|
|
description: The ID of the Product Tag
|
|
type: string
|
|
example: cgrp_01G8ZH853Y6TFXWPG5EYE81X63
|
|
condition_id:
|
|
description: The ID of the Discount Condition
|
|
type: string
|
|
example: discon_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
customer_group:
|
|
description: Available if the relation `customer_group` is expanded.
|
|
$ref: '#/components/schemas/customer_group'
|
|
discount_condition:
|
|
description: Available if the relation `discount_condition` is expanded.
|
|
$ref: '#/components/schemas/discount_condition'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
discount_condition_product_collection:
|
|
title: Product Collection Discount Condition
|
|
description: Associates a discount condition with a product collection
|
|
x-resourceId: discount_condition_product_collection
|
|
required:
|
|
- product_collection_id
|
|
- condition_id
|
|
properties:
|
|
product_collection_id:
|
|
description: The ID of the Product Collection
|
|
type: string
|
|
example: pcol_01F0YESBFAZ0DV6V831JXWH0BG
|
|
condition_id:
|
|
description: The ID of the Discount Condition
|
|
type: string
|
|
example: discon_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
product_collection:
|
|
description: Available if the relation `product_collection` is expanded.
|
|
$ref: '#/components/schemas/product_collection'
|
|
discount_condition:
|
|
description: Available if the relation `discount_condition` is expanded.
|
|
$ref: '#/components/schemas/discount_condition'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
discount_condition_product_tag:
|
|
title: Product Tag Discount Condition
|
|
description: Associates a discount condition with a product tag
|
|
x-resourceId: discount_condition_product_tag
|
|
required:
|
|
- product_tag_id
|
|
- condition_id
|
|
properties:
|
|
product_tag_id:
|
|
description: The ID of the Product Tag
|
|
type: string
|
|
example: ptag_01F0YESHPZYY3H4SJ3A5918SBN
|
|
condition_id:
|
|
description: The ID of the Discount Condition
|
|
type: string
|
|
example: discon_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
product_tag:
|
|
description: Available if the relation `product_tag` is expanded.
|
|
$ref: '#/components/schemas/product_tag'
|
|
discount_condition:
|
|
description: Available if the relation `discount_condition` is expanded.
|
|
$ref: '#/components/schemas/discount_condition'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
discount_condition_product_type:
|
|
title: Product Type Discount Condition
|
|
description: Associates a discount condition with a product type
|
|
x-resourceId: discount_condition_product
|
|
required:
|
|
- product_type_id
|
|
- condition_id
|
|
properties:
|
|
product_type_id:
|
|
description: The ID of the Product Tag
|
|
type: string
|
|
example: ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
condition_id:
|
|
description: The ID of the Discount Condition
|
|
type: string
|
|
example: discon_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
product_type:
|
|
description: Available if the relation `product_type` is expanded.
|
|
$ref: '#/components/schemas/product_type'
|
|
discount_condition:
|
|
description: Available if the relation `discount_condition` is expanded.
|
|
$ref: '#/components/schemas/discount_condition'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
discount_condition_product:
|
|
title: Product Discount Condition
|
|
description: Associates a discount condition with a product
|
|
x-resourceId: discount_condition_product
|
|
required:
|
|
- product_id
|
|
- condition_id
|
|
properties:
|
|
product_id:
|
|
description: The ID of the Product Tag
|
|
type: string
|
|
example: prod_01G1G5V2MBA328390B5AXJ610F
|
|
condition_id:
|
|
description: The ID of the Discount Condition
|
|
type: string
|
|
example: discon_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
product:
|
|
description: Available if the relation `product` is expanded.
|
|
$ref: '#/components/schemas/product'
|
|
discount_condition:
|
|
description: Available if the relation `discount_condition` is expanded.
|
|
$ref: '#/components/schemas/discount_condition'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
discount_condition:
|
|
title: Discount Condition
|
|
description: Holds rule conditions for when a discount is applicable
|
|
x-resourceId: discount_condition
|
|
required:
|
|
- type
|
|
- operator
|
|
- discount_rule_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The discount condition's ID
|
|
example: discon_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
type:
|
|
description: The type of the Condition
|
|
type: string
|
|
enum:
|
|
- products
|
|
- product_types
|
|
- product_collections
|
|
- product_tags
|
|
- customer_groups
|
|
operator:
|
|
description: The operator of the Condition
|
|
type: string
|
|
enum:
|
|
- in
|
|
- not_in
|
|
discount_rule_id:
|
|
type: string
|
|
description: The ID of the discount rule associated with the condition
|
|
example: dru_01F0YESMVK96HVX7N419E3CJ7C
|
|
discount_rule:
|
|
description: Available if the relation `discount_rule` is expanded.
|
|
$ref: '#/components/schemas/discount_rule'
|
|
products:
|
|
description: >-
|
|
products associated with this condition if type = products.
|
|
Available if the relation `products` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A product object.
|
|
product_types:
|
|
description: >-
|
|
product types associated with this condition if type =
|
|
product_types. Available if the relation `product_types` is
|
|
expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A product type object.
|
|
product_tags:
|
|
description: >-
|
|
product tags associated with this condition if type = product_tags.
|
|
Available if the relation `product_tags` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A product tag object.
|
|
product_collections:
|
|
description: >-
|
|
product collections associated with this condition if type =
|
|
product_collections. Available if the relation `product_collections`
|
|
is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A product collection object.
|
|
customer_groups:
|
|
description: >-
|
|
customer groups associated with this condition if type =
|
|
customer_groups. Available if the relation `customer_groups` is
|
|
expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A customer group object.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
discount_rule:
|
|
title: Discount Rule
|
|
description: >-
|
|
Holds the rules that governs how a Discount is calculated when applied
|
|
to a Cart.
|
|
x-resourceId: discount_rule
|
|
required:
|
|
- type
|
|
- value
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The discount rule's ID
|
|
example: dru_01F0YESMVK96HVX7N419E3CJ7C
|
|
type:
|
|
description: >-
|
|
The type of the Discount, can be `fixed` for discounts that reduce
|
|
the price by a fixed amount, `percentage` for percentage reductions
|
|
or `free_shipping` for shipping vouchers.
|
|
type: string
|
|
enum:
|
|
- fixed
|
|
- percentage
|
|
- free_shipping
|
|
example: percentage
|
|
description:
|
|
description: A short description of the discount
|
|
type: string
|
|
example: 10 Percent
|
|
value:
|
|
description: >-
|
|
The value that the discount represents; this will depend on the type
|
|
of the discount
|
|
type: integer
|
|
example: 10
|
|
allocation:
|
|
description: The scope that the discount should apply to.
|
|
type: string
|
|
enum:
|
|
- total
|
|
- item
|
|
example: total
|
|
conditions:
|
|
description: >-
|
|
A set of conditions that can be used to limit when the discount can
|
|
be used. Available if the relation `conditions` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A discount condition object.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
discount:
|
|
title: Discount
|
|
description: >-
|
|
Represents a discount that can be applied to a cart for promotional
|
|
purposes.
|
|
x-resourceId: discount
|
|
required:
|
|
- code
|
|
- is_dynamic
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The discount's ID
|
|
example: disc_01F0YESMW10MGHWJKZSDDMN0VN
|
|
code:
|
|
description: >-
|
|
A unique code for the discount - this will be used by the customer
|
|
to apply the discount
|
|
type: string
|
|
example: 10DISC
|
|
is_dynamic:
|
|
description: >-
|
|
A flag to indicate if multiple instances of the discount can be
|
|
generated. I.e. for newsletter discounts
|
|
type: boolean
|
|
example: false
|
|
rule_id:
|
|
type: string
|
|
description: The Discount Rule that governs the behaviour of the Discount
|
|
example: dru_01F0YESMVK96HVX7N419E3CJ7C
|
|
rule:
|
|
description: Available if the relation `rule` is expanded.
|
|
$ref: '#/components/schemas/discount_rule'
|
|
is_disabled:
|
|
description: >-
|
|
Whether the Discount has been disabled. Disabled discounts cannot be
|
|
applied to carts
|
|
type: boolean
|
|
example: false
|
|
parent_discount_id:
|
|
type: string
|
|
description: >-
|
|
The Discount that the discount was created from. This will always be
|
|
a dynamic discount
|
|
example: disc_01G8ZH853YPY9B94857DY91YGW
|
|
parent_discount:
|
|
description: Available if the relation `parent_discount` is expanded.
|
|
$ref: '#/components/schemas/discount'
|
|
starts_at:
|
|
description: The time at which the discount can be used.
|
|
type: string
|
|
format: date-time
|
|
ends_at:
|
|
description: The time at which the discount can no longer be used.
|
|
type: string
|
|
format: date-time
|
|
valid_duration:
|
|
type: string
|
|
description: Duration the discount runs between
|
|
example: P3Y6M4DT12H30M5S
|
|
regions:
|
|
description: >-
|
|
The Regions in which the Discount can be used. Available if the
|
|
relation `regions` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A region object.
|
|
usage_limit:
|
|
description: The maximum number of times that a discount can be used.
|
|
type: integer
|
|
example: 100
|
|
usage_count:
|
|
description: The number of times a discount has been used.
|
|
type: integer
|
|
example: 50
|
|
default: 0
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
draft-order:
|
|
title: DraftOrder
|
|
description: Represents a draft order
|
|
x-resourceId: draft-order
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The draft order's ID
|
|
example: dorder_01G8TJFKBG38YYFQ035MSVG03C
|
|
status:
|
|
type: string
|
|
description: The status of the draft order
|
|
enum:
|
|
- open
|
|
- completed
|
|
default: open
|
|
display_id:
|
|
type: string
|
|
description: The draft order's display ID
|
|
example: 2
|
|
cart_id:
|
|
type: string
|
|
description: The ID of the cart associated with the draft order.
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
cart:
|
|
description: A cart object. Available if the relation `cart` is expanded.
|
|
type: object
|
|
order_id:
|
|
type: string
|
|
description: The ID of the order associated with the draft order.
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
canceled_at:
|
|
type: string
|
|
description: The date the draft order was canceled at.
|
|
format: date-time
|
|
completed_at:
|
|
type: string
|
|
description: The date the draft order was completed at.
|
|
format: date-time
|
|
no_notification_order:
|
|
type: boolean
|
|
description: Whether to send the customer notifications regarding order updates.
|
|
example: false
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of the cart
|
|
associated with the draft order in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
fulfillment_item:
|
|
title: Fulfillment Item
|
|
description: >-
|
|
Correlates a Line Item with a Fulfillment, keeping track of the quantity
|
|
of the Line Item.
|
|
x-resourceId: fulfillment_item
|
|
required:
|
|
- fulfillment_id
|
|
- item_id
|
|
- quantity
|
|
properties:
|
|
fulfillment_id:
|
|
description: The id of the Fulfillment that the Fulfillment Item belongs to.
|
|
type: string
|
|
example: ful_01G8ZRTMQCA76TXNAT81KPJZRF
|
|
item_id:
|
|
description: The id of the Line Item that the Fulfillment Item references.
|
|
type: string
|
|
example: item_01G8ZC9GWT6B2GP5FSXRXNFNGN
|
|
fulfillment:
|
|
description: >-
|
|
A fulfillment object. Available if the relation `fulfillment` is
|
|
expanded.
|
|
type: object
|
|
item:
|
|
description: Available if the relation `item` is expanded.
|
|
$ref: '#/components/schemas/line_item'
|
|
quantity:
|
|
description: The quantity of the Line Item that is included in the Fulfillment.
|
|
type: integer
|
|
example: 1
|
|
fulfillment_provider:
|
|
title: Fulfillment Provider
|
|
description: >-
|
|
Represents a fulfillment provider plugin and holds its installation
|
|
status.
|
|
x-resourceId: fulfillment_provider
|
|
properties:
|
|
id:
|
|
description: The id of the fulfillment provider as given by the plugin.
|
|
type: string
|
|
example: manual
|
|
is_installed:
|
|
description: >-
|
|
Whether the plugin is installed in the current version. Plugins that
|
|
are no longer installed are not deleted by will have this field set
|
|
to `false`.
|
|
type: boolean
|
|
example: true
|
|
fulfillment:
|
|
title: Fulfillment
|
|
description: >-
|
|
Fulfillments are created once store operators can prepare the purchased
|
|
goods. Fulfillments will eventually be shipped and hold information
|
|
about how to track shipments. Fulfillments are created through a
|
|
provider, which is typically an external shipping aggregator, shipping
|
|
partner og 3PL, most plugins will have asynchronous communications with
|
|
these providers through webhooks in order to automatically update and
|
|
synchronize the state of Fulfillments.
|
|
x-resourceId: fulfillment
|
|
required:
|
|
- provider_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The cart's ID
|
|
example: ful_01G8ZRTMQCA76TXNAT81KPJZRF
|
|
claim_order_id:
|
|
description: The id of the Claim that the Fulfillment belongs to.
|
|
type: string
|
|
example: null
|
|
claim_order:
|
|
description: >-
|
|
A claim order object. Available if the relation `claim_order` is
|
|
expanded.
|
|
type: object
|
|
swap_id:
|
|
description: The id of the Swap that the Fulfillment belongs to.
|
|
type: string
|
|
example: null
|
|
swap:
|
|
description: A swap object. Available if the relation `swap` is expanded.
|
|
type: object
|
|
order_id:
|
|
description: The id of the Order that the Fulfillment belongs to.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
provider_id:
|
|
description: >-
|
|
The id of the Fulfillment Provider responsible for handling the
|
|
fulfillment
|
|
type: string
|
|
example: manual
|
|
provider:
|
|
description: Available if the relation `provider` is expanded.
|
|
$ref: '#/components/schemas/fulfillment_provider'
|
|
items:
|
|
description: >-
|
|
The Fulfillment Items in the Fulfillment - these hold information
|
|
about how many of each Line Item has been fulfilled. Available if
|
|
the relation `items` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/fulfillment_item'
|
|
tracking_links:
|
|
description: >-
|
|
The Tracking Links that can be used to track the status of the
|
|
Fulfillment, these will usually be provided by the Fulfillment
|
|
Provider. Available if the relation `tracking_links` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/tracking_link'
|
|
tracking_numbers:
|
|
deprecated: true
|
|
description: >-
|
|
The tracking numbers that can be used to track the status of the
|
|
fulfillment.
|
|
type: array
|
|
items:
|
|
type: string
|
|
data:
|
|
description: >-
|
|
This contains all the data necessary for the Fulfillment provider to
|
|
handle the fulfillment.
|
|
type: object
|
|
example: {}
|
|
shipped_at:
|
|
description: The date with timezone at which the Fulfillment was shipped.
|
|
type: string
|
|
format: date-time
|
|
no_notification:
|
|
description: >-
|
|
Flag for describing whether or not notifications related to this
|
|
should be send.
|
|
type: boolean
|
|
example: false
|
|
canceled_at:
|
|
description: The date with timezone at which the Fulfillment was canceled.
|
|
type: string
|
|
format: date-time
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of the
|
|
fulfillment in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
gift_card_transaction:
|
|
title: Gift Card Transaction
|
|
description: >-
|
|
Gift Card Transactions are created once a Customer uses a Gift Card to
|
|
pay for their Order
|
|
x-resourceId: gift_card_transaction
|
|
required:
|
|
- gift_card_id
|
|
- amount
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The gift card transaction's ID
|
|
example: gct_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
gift_card_id:
|
|
description: The ID of the Gift Card that was used in the transaction.
|
|
type: string
|
|
example: gift_01G8XKBPBQY2R7RBET4J7E0XQZ
|
|
gift_card:
|
|
description: >-
|
|
A gift card object. Available if the relation `gift_card` is
|
|
expanded.
|
|
type: object
|
|
order_id:
|
|
description: The ID of the Order that the Gift Card was used to pay for.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
amount:
|
|
description: The amount that was used from the Gift Card.
|
|
type: integer
|
|
example: 10
|
|
created_at:
|
|
description: The date with timezone at which the resource was created.
|
|
type: string
|
|
format: date-time
|
|
is_taxable:
|
|
description: Whether the transaction is taxable or not.
|
|
type: boolean
|
|
example: false
|
|
tax_rate:
|
|
description: The tax rate of the transaction
|
|
type: number
|
|
example: 0
|
|
gift_card:
|
|
title: Gift Card
|
|
description: >-
|
|
Gift Cards are redeemable and represent a value that can be used towards
|
|
the payment of an Order.
|
|
x-resourceId: gift_card
|
|
required:
|
|
- code
|
|
- value
|
|
- balance
|
|
- region_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The cart's ID
|
|
example: gift_01G8XKBPBQY2R7RBET4J7E0XQZ
|
|
code:
|
|
description: >-
|
|
The unique code that identifies the Gift Card. This is used by the
|
|
Customer to redeem the value of the Gift Card.
|
|
type: string
|
|
example: 3RFT-MH2C-Y4YZ-XMN4
|
|
value:
|
|
description: The value that the Gift Card represents.
|
|
type: integer
|
|
example: 10
|
|
balance:
|
|
description: The remaining value on the Gift Card.
|
|
type: integer
|
|
example: 10
|
|
region_id:
|
|
type: string
|
|
description: The id of the Region in which the Gift Card is available.
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
region:
|
|
description: A region object. Available if the relation `region` is expanded.
|
|
type: object
|
|
order_id:
|
|
type: string
|
|
description: The id of the Order that the Gift Card was purchased in.
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
is_disabled:
|
|
description: >-
|
|
Whether the Gift Card has been disabled. Disabled Gift Cards cannot
|
|
be applied to carts.
|
|
type: boolean
|
|
example: false
|
|
ends_at:
|
|
description: The time at which the Gift Card can no longer be used.
|
|
type: string
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
idempotency_key:
|
|
title: Idempotency Key
|
|
description: >-
|
|
Idempotency Key is used to continue a process in case of any failure
|
|
that might occur.
|
|
x-resourceId: idempotency_key
|
|
required:
|
|
- idempotency_key
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The idempotency key's ID
|
|
example: ikey_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
idempotency_key:
|
|
description: >-
|
|
The unique randomly generated key used to determine the state of a
|
|
process.
|
|
type: string
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
description: Date which the idempotency key was locked.
|
|
type: string
|
|
format: date-time
|
|
locked_at:
|
|
description: Date which the idempotency key was locked.
|
|
type: string
|
|
format: date-time
|
|
request_method:
|
|
description: The method of the request
|
|
type: string
|
|
example: POST
|
|
request_params:
|
|
type: object
|
|
description: The parameters passed to the request
|
|
example:
|
|
id: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
request_path:
|
|
description: The request's path
|
|
type: string
|
|
example: /store/carts/cart_01G8ZH853Y6TFXWPG5EYE81X63/complete
|
|
response_code:
|
|
type: string
|
|
description: The response's code.
|
|
example: 200
|
|
response_body:
|
|
type: object
|
|
description: The response's body
|
|
example:
|
|
id: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
recovery_point:
|
|
type: string
|
|
description: Where to continue from.
|
|
default: started
|
|
image:
|
|
title: Image
|
|
description: Images holds a reference to a URL at which the image file can be found.
|
|
x-resourceId: image
|
|
required:
|
|
- url
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The image's ID
|
|
example: img_01G749BFYR6T8JTVW6SGW3K3E6
|
|
url:
|
|
description: The URL at which the image file can be found.
|
|
type: string
|
|
format: uri
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
invite:
|
|
title: Invite
|
|
description: Represents an invite
|
|
x-resourceId: invite
|
|
required:
|
|
- user_email
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The invite's ID
|
|
example: invite_01G8TKE4XYCTHSCK2GDEP47RE1
|
|
user_email:
|
|
type: string
|
|
description: The email of the user being invited.
|
|
format: email
|
|
role:
|
|
type: string
|
|
description: The user's role.
|
|
enum:
|
|
- admin
|
|
- member
|
|
- developer
|
|
default: member
|
|
accepted:
|
|
type: boolean
|
|
description: Whether the invite was accepted or not.
|
|
example: false
|
|
token:
|
|
type: string
|
|
description: The token used to accept the invite.
|
|
expores_at:
|
|
type: string
|
|
description: The date the invite expires at.
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
line_item_adjustment:
|
|
title: Line Item Adjustment
|
|
description: Represents an Line Item Adjustment
|
|
x-resourceId: line_item_adjustment
|
|
required:
|
|
- item_id
|
|
- description
|
|
- amount
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The invite's ID
|
|
example: lia_01G8TKE4XYCTHSCK2GDEP47RE1
|
|
item_id:
|
|
type: string
|
|
description: The ID of the line item
|
|
example: item_01G8ZC9GWT6B2GP5FSXRXNFNGN
|
|
item:
|
|
description: Available if the relation `item` is expanded.
|
|
$ref: '#/components/schemas/line_item'
|
|
description:
|
|
type: string
|
|
description: The line item's adjustment description
|
|
example: Adjusted item's price.
|
|
discount_id:
|
|
type: string
|
|
description: The ID of the discount associated with the adjustment
|
|
example: disc_01F0YESMW10MGHWJKZSDDMN0VN
|
|
discount:
|
|
description: Available if the relation `discount` is expanded.
|
|
$ref: '#/components/schemas/discount'
|
|
amount:
|
|
type: number
|
|
description: The adjustment amount
|
|
example: 1000
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
line_item_tax_line:
|
|
title: Line Item Tax Line
|
|
description: Represents an Line Item Tax Line
|
|
x-resourceId: line_item_tax_line
|
|
required:
|
|
- item_id
|
|
- rate
|
|
- name
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The line item tax line's ID
|
|
example: litl_01G1G5V2DRX1SK6NQQ8VVX4HQ8
|
|
item_id:
|
|
type: string
|
|
description: The ID of the line item
|
|
example: item_01G8ZC9GWT6B2GP5FSXRXNFNGN
|
|
item:
|
|
description: Available if the relation `item` is expanded.
|
|
$ref: '#/components/schemas/line_item'
|
|
code:
|
|
description: A code to identify the tax type by
|
|
type: string
|
|
example: tax01
|
|
name:
|
|
description: A human friendly name for the tax
|
|
type: string
|
|
example: Tax Example
|
|
rate:
|
|
description: The numeric rate to charge tax by
|
|
type: number
|
|
example: 10
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
line_item:
|
|
title: Line Item
|
|
description: >-
|
|
Line Items represent purchasable units that can be added to a Cart for
|
|
checkout. When Line Items are purchased they will get copied to the
|
|
resulting order and can eventually be referenced in Fulfillments and
|
|
Returns. Line Items may also be created when processing Swaps and
|
|
Claims.
|
|
x-resourceId: line_item
|
|
required:
|
|
- title
|
|
- unit_price
|
|
- quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The cart's ID
|
|
example: item_01G8ZC9GWT6B2GP5FSXRXNFNGN
|
|
cart_id:
|
|
description: The ID of the Cart that the Line Item belongs to.
|
|
type: string
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
cart:
|
|
description: A cart object. Available if the relation `cart` is expanded.
|
|
type: object
|
|
order_id:
|
|
description: The ID of the Order that the Line Item belongs to.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
swap_id:
|
|
description: The id of the Swap that the Line Item belongs to.
|
|
type: string
|
|
example: null
|
|
swap:
|
|
description: A swap object. Available if the relation `swap` is expanded.
|
|
type: object
|
|
claim_order_id:
|
|
description: The id of the Claim that the Line Item belongs to.
|
|
type: string
|
|
example: null
|
|
claim_order:
|
|
description: >-
|
|
A claim order object. Available if the relation `claim_order` is
|
|
expanded.
|
|
type: object
|
|
tax_lines:
|
|
description: Available if the relation `tax_lines` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/line_item_tax_line'
|
|
adjustments:
|
|
description: Available if the relation `adjustments` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/line_item_adjustment'
|
|
title:
|
|
description: >-
|
|
The title of the Line Item, this should be easily identifiable by
|
|
the Customer.
|
|
type: string
|
|
example: Medusa Coffee Mug
|
|
description:
|
|
description: A more detailed description of the contents of the Line Item.
|
|
type: string
|
|
example: One Size
|
|
thumbnail:
|
|
description: A URL string to a small image of the contents of the Line Item.
|
|
type: string
|
|
format: uri
|
|
example: >-
|
|
https://medusa-public-images.s3.eu-west-1.amazonaws.com/coffee-mug.png
|
|
is_return:
|
|
description: Is the item being returned
|
|
type: boolean
|
|
example: false
|
|
is_giftcard:
|
|
description: Flag to indicate if the Line Item is a Gift Card.
|
|
type: boolean
|
|
example: false
|
|
should_merge:
|
|
description: >-
|
|
Flag to indicate if new Line Items with the same variant should be
|
|
merged or added as an additional Line Item.
|
|
type: boolean
|
|
example: false
|
|
allow_discounts:
|
|
description: >-
|
|
Flag to indicate if the Line Item should be included when doing
|
|
discount calculations.
|
|
type: boolean
|
|
example: false
|
|
has_shipping:
|
|
description: >-
|
|
Flag to indicate if the Line Item has fulfillment associated with
|
|
it.
|
|
type: boolean
|
|
example: false
|
|
unit_price:
|
|
description: >-
|
|
The price of one unit of the content in the Line Item. This should
|
|
be in the currency defined by the Cart/Order/Swap/Claim that the
|
|
Line Item belongs to.
|
|
type: boolean
|
|
example: 8000
|
|
variant_id:
|
|
description: The id of the Product Variant contained in the Line Item.
|
|
type: string
|
|
example: variant_01G1G5V2MRX2V3PVSR2WXYPFB6
|
|
variant:
|
|
description: >-
|
|
A product variant object. The Product Variant contained in the Line
|
|
Item. Available if the relation `variant` is expanded.
|
|
type: object
|
|
quantity:
|
|
description: The quantity of the content in the Line Item.
|
|
type: integer
|
|
example: 1
|
|
fulfilled_quantity:
|
|
description: The quantity of the Line Item that has been fulfilled.
|
|
type: integer
|
|
example: 0
|
|
returned_quantity:
|
|
description: The quantity of the Line Item that has been returned.
|
|
type: integer
|
|
example: 0
|
|
shipped_quantity:
|
|
description: The quantity of the Line Item that has been shipped.
|
|
type: integer
|
|
example: 0
|
|
refundable:
|
|
description: >-
|
|
The amount that can be refunded from the given Line Item. Takes
|
|
taxes and discounts into consideration.
|
|
type: integer
|
|
example: 0
|
|
subtotal:
|
|
type: integer
|
|
description: The subtotal of the line item
|
|
example: 8000
|
|
tax_total:
|
|
type: integer
|
|
description: The total of tax of the line item
|
|
example: 0
|
|
total:
|
|
type: integer
|
|
description: The total amount of the line item
|
|
example: 8000
|
|
original_total:
|
|
type: integer
|
|
description: The original total amount of the line item
|
|
example: 8000
|
|
original_tax_total:
|
|
type: integer
|
|
description: The original tax total amount of the line item
|
|
example: 0
|
|
discount_total:
|
|
type: integer
|
|
description: The total of discount of the line item
|
|
example: 0
|
|
gift_card_total:
|
|
type: integer
|
|
description: The total of the gift card of the line item
|
|
example: 0
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
money_amount:
|
|
title: Money Amount
|
|
description: >-
|
|
Money Amounts represents an amount that a given Product Variant can be
|
|
purcased for. Each Money Amount either has a Currency or Region
|
|
associated with it to indicate the pricing in a given Currency or, for
|
|
fully region-based pricing, the given price in a specific Region. If
|
|
region-based pricing is used the amount will be in the currency defined
|
|
for the Reigon.
|
|
x-resourceId: money_amount
|
|
required:
|
|
- currency_code
|
|
- amount
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The money amount's ID
|
|
example: ma_01F0YESHRFQNH5S8Q0PK84YYZN
|
|
currency_code:
|
|
description: The 3 character currency code that the Money Amount is given in.
|
|
type: string
|
|
example: usd
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
currency:
|
|
description: Available if the relation `currency` is expanded.
|
|
$ref: '#/components/schemas/currency'
|
|
amount:
|
|
description: >-
|
|
The amount in the smallest currecny unit (e.g. cents 100 cents to
|
|
charge $1) that the Product Variant will cost.
|
|
type: integer
|
|
example: 100
|
|
min_quantity:
|
|
description: >-
|
|
The minimum quantity that the Money Amount applies to. If this value
|
|
is not set, the Money Amount applies to all quantities.
|
|
type: integer
|
|
example: 1
|
|
max_quantity:
|
|
description: >-
|
|
The maximum quantity that the Money Amount applies to. If this value
|
|
is not set, the Money Amount applies to all quantities.
|
|
type: integer
|
|
example: 1
|
|
price_list_id:
|
|
type: string
|
|
description: The ID of the price list associated with the money amount
|
|
example: pl_01G8X3CKJXCG5VXVZ87H9KC09W
|
|
price_list:
|
|
description: Available if the relation `price_list` is expanded.
|
|
$ref: '#/components/schemas/price_list'
|
|
variant_id:
|
|
description: The id of the Product Variant contained in the Line Item.
|
|
type: string
|
|
example: variant_01G1G5V2MRX2V3PVSR2WXYPFB6
|
|
variant:
|
|
description: >-
|
|
The Product Variant contained in the Line Item. Available if the
|
|
relation `variant` is expanded.
|
|
type: object
|
|
region_id:
|
|
type: string
|
|
description: The region's ID
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
region:
|
|
description: A region object. Available if the relation `region` is expanded.
|
|
type: object
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
note:
|
|
title: Note
|
|
description: >-
|
|
Notes are elements which we can use in association with different
|
|
resources to allow users to describe additional information in relation
|
|
to these.
|
|
x-resourceId: note
|
|
required:
|
|
- value
|
|
- resource_type
|
|
- resource_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The note's ID
|
|
example: note_01G8TM8ENBMC7R90XRR1G6H26Q
|
|
resource_type:
|
|
description: The type of resource that the Note refers to.
|
|
type: string
|
|
example: order
|
|
resource_id:
|
|
description: The ID of the resource that the Note refers to.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
value:
|
|
description: The contents of the note.
|
|
type: string
|
|
example: This order must be fulfilled on Monday
|
|
author_id:
|
|
type: string
|
|
description: The ID of the author (user)
|
|
example: usr_01G1G5V26F5TB3GPAPNJ8X1S3V
|
|
author:
|
|
description: Available if the relation `author` is expanded.
|
|
$ref: '#/components/schemas/user'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
notification_provider:
|
|
title: Notification Provider
|
|
description: >-
|
|
Represents a notification provider plugin and holds its installation
|
|
status.
|
|
x-resourceId: notification_provider
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: The id of the notification provider as given by the plugin.
|
|
type: string
|
|
example: sendgrid
|
|
is_installed:
|
|
description: >-
|
|
Whether the plugin is installed in the current version. Plugins that
|
|
are no longer installed are not deleted by will have this field set
|
|
to `false`.
|
|
type: boolean
|
|
default: true
|
|
notification:
|
|
title: Notification
|
|
description: >-
|
|
Notifications a communications sent via Notification Providers as a
|
|
reaction to internal events such as `order.placed`. Notifications can be
|
|
used to show a chronological timeline for communications sent to a
|
|
Customer regarding an Order, and enables resends.
|
|
x-resourceId: notification
|
|
required:
|
|
- resource_type
|
|
- resource_id
|
|
- to
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The notification's ID
|
|
example: noti_01G53V9Y6CKMCGBM1P0X7C28RX
|
|
event_name:
|
|
description: The name of the event that the notification was sent for.
|
|
type: string
|
|
example: order.placed
|
|
resource_type:
|
|
description: The type of resource that the Notification refers to.
|
|
type: string
|
|
example: order
|
|
resource_id:
|
|
description: The ID of the resource that the Notification refers to.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
customer_id:
|
|
description: The ID of the Customer that the Notification was sent to.
|
|
type: string
|
|
example: cus_01G2SG30J8C85S4A5CHM2S1NS2
|
|
customer:
|
|
description: A customer object. Available if the relation `customer` is expanded.
|
|
type: object
|
|
to:
|
|
description: >-
|
|
The address that the Notification was sent to. This will usually be
|
|
an email address, but represent other addresses such as a chat bot
|
|
user id
|
|
type: string
|
|
example: user@example.com
|
|
data:
|
|
description: >-
|
|
The data that the Notification was sent with. This contains all the
|
|
data necessary for the Notification Provider to initiate a resend.
|
|
type: object
|
|
example: {}
|
|
resends:
|
|
description: >-
|
|
The resends that have been completed after the original
|
|
Notification.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/notification_resend'
|
|
provider_id:
|
|
description: The id of the Notification Provider that handles the Notification.
|
|
type: string
|
|
example: sengrid
|
|
provider:
|
|
description: Available if the relation `provider` is expanded.
|
|
$ref: '#/components/schemas/notification_provider'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
notification_resend:
|
|
title: Notification Resend
|
|
description: A resend of a Notification.
|
|
x-resourceId: notification_resend
|
|
properties:
|
|
id:
|
|
description: The notification resend's ID
|
|
type: string
|
|
example: noti_01F0YET45G9NHP08Z66CE4QKBS
|
|
event_name:
|
|
description: The name of the event that the notification was sent for.
|
|
type: string
|
|
example: order.placed
|
|
resource_type:
|
|
description: The type of resource that the Notification refers to.
|
|
type: string
|
|
example: order
|
|
resource_id:
|
|
description: The ID of the resource that the Notification refers to.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
customer_id:
|
|
description: The ID of the Customer that the Notification was sent to.
|
|
type: string
|
|
example: cus_01G2SG30J8C85S4A5CHM2S1NS2
|
|
customer:
|
|
description: A customer object. Available if the relation `customer` is expanded.
|
|
type: object
|
|
to:
|
|
description: >-
|
|
The address that the Notification was sent to. This will usually be
|
|
an email address, but represent other addresses such as a chat bot
|
|
user id
|
|
type: string
|
|
example: user@example.com
|
|
data:
|
|
description: >-
|
|
The data that the Notification was sent with. This contains all the
|
|
data necessary for the Notification Provider to initiate a resend.
|
|
type: object
|
|
example: {}
|
|
parent_id:
|
|
description: The ID of the Notification that was originally sent.
|
|
type: string
|
|
example: noti_01G53V9Y6CKMCGBM1P0X7C28RX
|
|
parent_notification:
|
|
description: Available if the relation `parent_notification` is expanded.
|
|
$ref: '#/components/schemas/notification'
|
|
provider_id:
|
|
description: The ID of the Notification Provider that handles the Notification.
|
|
type: string
|
|
example: sengrid
|
|
provider:
|
|
description: Available if the relation `provider` is expanded.
|
|
$ref: '#/components/schemas/notification_provider'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
OAuth:
|
|
title: OAuth
|
|
description: Represent an OAuth app
|
|
x-resourceId: OAuth
|
|
required:
|
|
- id
|
|
- display_name
|
|
- application_name
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The app's ID
|
|
example: example_app
|
|
display_name:
|
|
type: string
|
|
description: The app's display name
|
|
example: Example app
|
|
application_name:
|
|
type: string
|
|
description: The app's name
|
|
example: example
|
|
install_url:
|
|
type: string
|
|
description: The URL to install the app
|
|
format: uri
|
|
uninstall_url:
|
|
type: string
|
|
description: The URL to uninstall the app
|
|
format: uri
|
|
data:
|
|
type: object
|
|
description: Any data necessary to the app.
|
|
example: {}
|
|
order:
|
|
title: Order
|
|
description: Represents an order
|
|
x-resourceId: order
|
|
required:
|
|
- customer_id
|
|
- email
|
|
- region_id
|
|
- currency_code
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The order's ID
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
status:
|
|
type: string
|
|
description: The order's status
|
|
enum:
|
|
- pending
|
|
- completed
|
|
- archived
|
|
- canceled
|
|
- requires_action
|
|
default: pending
|
|
fulfillment_status:
|
|
type: string
|
|
description: The order's fulfillment status
|
|
enum:
|
|
- not_fulfilled
|
|
- partially_fulfilled
|
|
- fulfilled
|
|
- partially_shipped
|
|
- shipped
|
|
- partially_returned
|
|
- returned
|
|
- canceled
|
|
- requires_action
|
|
default: not_fulfilled
|
|
payment_status:
|
|
type: string
|
|
description: The order's payment status
|
|
enum:
|
|
- not_paid
|
|
- awaiting
|
|
- captured
|
|
- partially_refunded
|
|
- refuneded
|
|
- canceled
|
|
- requires_action
|
|
default: not_paid
|
|
display_id:
|
|
type: integer
|
|
description: The order's display ID
|
|
example: 2
|
|
cart_id:
|
|
type: string
|
|
description: The ID of the cart associated with the order
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
cart:
|
|
description: A cart object. Available if the relation `cart` is expanded.
|
|
type: object
|
|
customer_id:
|
|
type: string
|
|
description: The ID of the customer associated with the order
|
|
example: cus_01G2SG30J8C85S4A5CHM2S1NS2
|
|
customer:
|
|
description: A customer object. Available if the relation `customer` is expanded.
|
|
type: object
|
|
email:
|
|
description: The email associated with the order
|
|
type: string
|
|
format: email
|
|
billing_address_id:
|
|
type: string
|
|
description: The ID of the billing address associated with the order
|
|
example: addr_01G8ZH853YPY9B94857DY91YGW
|
|
billing_address:
|
|
description: Available if the relation `billing_address` is expanded.
|
|
$ref: '#/components/schemas/address'
|
|
shipping_address_id:
|
|
type: string
|
|
description: The ID of the shipping address associated with the order
|
|
example: addr_01G8ZH853YPY9B94857DY91YGW
|
|
shipping_address:
|
|
description: Available if the relation `shipping_address` is expanded.
|
|
$ref: '#/components/schemas/address'
|
|
region_id:
|
|
type: string
|
|
description: The region's ID
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
region:
|
|
description: A region object. Available if the relation `region` is expanded.
|
|
type: object
|
|
currency_code:
|
|
description: The 3 character currency code that is used in the order
|
|
type: string
|
|
example: usd
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
currency:
|
|
description: Available if the relation `currency` is expanded.
|
|
$ref: '#/components/schemas/currency'
|
|
tax_rate:
|
|
description: The order's tax rate
|
|
type: number
|
|
example: 0
|
|
discounts:
|
|
type: array
|
|
description: >-
|
|
The discounts used in the order. Available if the relation
|
|
`discounts` is expanded.
|
|
items:
|
|
type: object
|
|
description: A discount object.
|
|
gift_cards:
|
|
type: array
|
|
description: >-
|
|
The gift cards used in the order. Available if the relation
|
|
`gift_cards` is expanded.
|
|
items:
|
|
type: object
|
|
description: A gift card object.
|
|
shipping_methods:
|
|
type: array
|
|
description: >-
|
|
The shipping methods used in the order. Available if the relation
|
|
`shipping_methods` is expanded.
|
|
items:
|
|
$ref: '#/components/schemas/shipping_method'
|
|
payments:
|
|
type: array
|
|
description: >-
|
|
The payments used in the order. Available if the relation `payments`
|
|
is expanded.
|
|
items:
|
|
$ref: '#/components/schemas/payment'
|
|
fulfillments:
|
|
type: array
|
|
description: >-
|
|
The fulfillments used in the order. Available if the relation
|
|
`fulfillments` is expanded.
|
|
items:
|
|
$ref: '#/components/schemas/fulfillment'
|
|
returns:
|
|
type: array
|
|
description: >-
|
|
The returns associated with the order. Available if the relation
|
|
`returns` is expanded.
|
|
items:
|
|
type: object
|
|
description: A return object.
|
|
claims:
|
|
type: array
|
|
description: >-
|
|
The claims associated with the order. Available if the relation
|
|
`claims` is expanded.
|
|
items:
|
|
type: object
|
|
description: A claim order object.
|
|
refunds:
|
|
type: array
|
|
description: >-
|
|
The refunds associated with the order. Available if the relation
|
|
`refunds` is expanded.
|
|
items:
|
|
type: object
|
|
description: A refund object.
|
|
swaps:
|
|
type: array
|
|
description: >-
|
|
The swaps associated with the order. Available if the relation
|
|
`swaps` is expanded.
|
|
items:
|
|
type: object
|
|
description: A swap object.
|
|
draft_order_id:
|
|
type: string
|
|
description: The ID of the draft order this order is associated with.
|
|
example: null
|
|
draft_order:
|
|
description: >-
|
|
A draft order object. Available if the relation `draft_order` is
|
|
expanded.
|
|
type: object
|
|
items:
|
|
type: array
|
|
description: >-
|
|
The line items that belong to the order. Available if the relation
|
|
`items` is expanded.
|
|
items:
|
|
$ref: '#/components/schemas/line_item'
|
|
gift_card_transactions:
|
|
type: array
|
|
description: >-
|
|
The gift card transactions used in the order. Available if the
|
|
relation `gift_card_transactions` is expanded.
|
|
items:
|
|
$ref: '#/components/schemas/gift_card_transaction'
|
|
canceled_at:
|
|
type: string
|
|
description: The date the order was canceled on.
|
|
format: date-time
|
|
no_notification:
|
|
description: >-
|
|
Flag for describing whether or not notifications related to this
|
|
should be send.
|
|
type: boolean
|
|
example: false
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the processing of the order
|
|
in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
external_id:
|
|
description: The ID of an external order.
|
|
type: string
|
|
example: null
|
|
sales_channel_id:
|
|
type: string
|
|
description: The ID of the sales channel this order is associated with.
|
|
example: null
|
|
sales_channel:
|
|
description: >-
|
|
A sales channel object. Available if the relation `sales_channel` is
|
|
expanded.
|
|
type: object
|
|
shipping_total:
|
|
type: integer
|
|
description: The total of shipping
|
|
example: 1000
|
|
discount_total:
|
|
type: integer
|
|
description: The total of discount
|
|
example: 800
|
|
tax_total:
|
|
type: integer
|
|
description: The total of tax
|
|
example: 0
|
|
refunded_total:
|
|
type: integer
|
|
description: The total amount refunded if the order is returned.
|
|
example: 0
|
|
total:
|
|
type: integer
|
|
description: The total amount of the order
|
|
example: 8200
|
|
subtotal:
|
|
type: integer
|
|
description: The subtotal of the order
|
|
example: 8000
|
|
paid_total:
|
|
type: integer
|
|
description: The total amount paid
|
|
example: 8000
|
|
refundable_amount:
|
|
type: integer
|
|
description: The amount that can be refunded
|
|
example: 8200
|
|
gift_card_total:
|
|
type: integer
|
|
description: The total of gift cards
|
|
example: 0
|
|
gift_card_tax_total:
|
|
type: integer
|
|
description: The total of gift cards with taxes
|
|
example: 0
|
|
payment_provider:
|
|
title: Payment Provider
|
|
description: Represents a Payment Provider plugin and holds its installation status.
|
|
x-resourceId: payment_provider
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
description: The id of the payment provider as given by the plugin.
|
|
type: string
|
|
example: manual
|
|
is_installed:
|
|
description: >-
|
|
Whether the plugin is installed in the current version. Plugins that
|
|
are no longer installed are not deleted by will have this field set
|
|
to `false`.
|
|
type: boolean
|
|
default: true
|
|
payment_session:
|
|
title: Payment Session
|
|
description: >-
|
|
Payment Sessions are created when a Customer initilizes the checkout
|
|
flow, and can be used to hold the state of a payment flow. Each Payment
|
|
Session is controlled by a Payment Provider, who is responsible for the
|
|
communication with external payment services. Authorized Payment
|
|
Sessions will eventually get promoted to Payments to indicate that they
|
|
are authorized for capture/refunds/etc.
|
|
x-resourceId: payment_session
|
|
required:
|
|
- cart_id
|
|
- provider_id
|
|
- status
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The payment session's ID
|
|
example: ps_01G901XNSRM2YS3ASN9H5KG3FZ
|
|
cart_id:
|
|
description: The id of the Cart that the Payment Session is created for.
|
|
type: string
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
cart:
|
|
description: A cart object. Available if the relation `cart` is expanded.
|
|
type: object
|
|
provider_id:
|
|
description: >-
|
|
The id of the Payment Provider that is responsible for the Payment
|
|
Session
|
|
type: string
|
|
example: manual
|
|
is_selected:
|
|
description: >-
|
|
A flag to indicate if the Payment Session has been selected as the
|
|
method that will be used to complete the purchase.
|
|
type: boolean
|
|
example: true
|
|
status:
|
|
description: >-
|
|
Indicates the status of the Payment Session. Will default to
|
|
`pending`, and will eventually become `authorized`. Payment Sessions
|
|
may have the status of `requires_more` to indicate that further
|
|
actions are to be completed by the Customer.
|
|
type: string
|
|
enum:
|
|
- authorized
|
|
- pending
|
|
- requires_more
|
|
- error
|
|
- canceled
|
|
example: pending
|
|
data:
|
|
description: >-
|
|
The data required for the Payment Provider to identify, modify and
|
|
process the Payment Session. Typically this will be an object that
|
|
holds an id to the external payment session, but can be an empty
|
|
object if the Payment Provider doesn't hold any state.
|
|
type: object
|
|
example: {}
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of a cart in
|
|
case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
payment:
|
|
title: Payment
|
|
description: >-
|
|
Payments represent an amount authorized with a given payment method,
|
|
Payments can be captured, canceled or refunded.
|
|
x-resourceId: payment
|
|
required:
|
|
- amount
|
|
- currency_code
|
|
- provider_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The payment's ID
|
|
example: pay_01G2SJNT6DEEWDFNAJ4XWDTHKE
|
|
swap_id:
|
|
description: The ID of the Swap that the Payment is used for.
|
|
type: string
|
|
example: null
|
|
swap:
|
|
description: A swap object. Available if the relation `swap` is expanded.
|
|
type: object
|
|
cart_id:
|
|
description: The id of the Cart that the Payment Session is created for.
|
|
type: string
|
|
cart:
|
|
description: A cart object. Available if the relation `cart` is expanded.
|
|
type: object
|
|
order_id:
|
|
description: The ID of the Order that the Payment is used for.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
amount:
|
|
description: The amount that the Payment has been authorized for.
|
|
type: integer
|
|
example: 100
|
|
currency_code:
|
|
description: The 3 character ISO currency code that the Payment is completed in.
|
|
type: string
|
|
example: usd
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
currency:
|
|
description: Available if the relation `currency` is expanded.
|
|
$ref: '#/components/schemas/currency'
|
|
amount_refunded:
|
|
description: >-
|
|
The amount of the original Payment amount that has been refunded
|
|
back to the Customer.
|
|
type: integer
|
|
example: 0
|
|
provider_id:
|
|
description: The id of the Payment Provider that is responsible for the Payment
|
|
type: string
|
|
example: manual
|
|
data:
|
|
description: >-
|
|
The data required for the Payment Provider to identify, modify and
|
|
process the Payment. Typically this will be an object that holds an
|
|
id to the external payment session, but can be an empty object if
|
|
the Payment Provider doesn't hold any state.
|
|
type: object
|
|
example: {}
|
|
captured_at:
|
|
description: The date with timezone at which the Payment was captured.
|
|
type: string
|
|
format: date-time
|
|
canceled_at:
|
|
description: The date with timezone at which the Payment was canceled.
|
|
type: string
|
|
format: date-time
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of a payment
|
|
in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
price_list:
|
|
title: Price List
|
|
description: >-
|
|
Price Lists represents a set of prices that overrides the default price
|
|
for one or more product variants.
|
|
x-resourceId: price_list
|
|
required:
|
|
- name
|
|
- description
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The price list's ID
|
|
example: pl_01G8X3CKJXCG5VXVZ87H9KC09W
|
|
name:
|
|
type: string
|
|
description: The price list's name
|
|
example: VIP Prices
|
|
description:
|
|
type: string
|
|
description: The price list's description
|
|
example: Prices for VIP customers
|
|
type:
|
|
description: >-
|
|
The type of Price List. This can be one of either `sale` or
|
|
`override`.
|
|
type: string
|
|
enum:
|
|
- sale
|
|
- override
|
|
default: sale
|
|
status:
|
|
description: The status of the Price List
|
|
type: string
|
|
enum:
|
|
- active
|
|
- draft
|
|
default: draft
|
|
starts_at:
|
|
description: The date with timezone that the Price List starts being valid.
|
|
type: string
|
|
format: date-time
|
|
ends_at:
|
|
description: The date with timezone that the Price List stops being valid.
|
|
type: string
|
|
format: date-time
|
|
customer_groups:
|
|
description: >-
|
|
The Customer Groups that the Price List applies to. Available if the
|
|
relation `customer_groups` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A customer group object.
|
|
prices:
|
|
description: >-
|
|
The Money Amounts that are associated with the Price List. Available
|
|
if the relation `prices` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/money_amount'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
product_collection:
|
|
title: Product Collection
|
|
description: Product Collections represents a group of Products that are related.
|
|
x-resourceId: product_collection
|
|
required:
|
|
- title
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The product collection's ID
|
|
example: pcol_01F0YESBFAZ0DV6V831JXWH0BG
|
|
title:
|
|
description: The title that the Product Collection is identified by.
|
|
type: string
|
|
example: Summer Collection
|
|
handle:
|
|
description: >-
|
|
A unique string that identifies the Product Collection - can for
|
|
example be used in slug structures.
|
|
type: string
|
|
example: summer-collection
|
|
products:
|
|
description: >-
|
|
The Products contained in the Product Collection. Available if the
|
|
relation `products` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A product collection object.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
product_option_value:
|
|
title: Product Option Value
|
|
description: >-
|
|
A value given to a Product Variant's option set. Product Variant have a
|
|
Product Option Value for each of the Product Options defined on the
|
|
Product.
|
|
x-resourceId: product_option_value
|
|
required:
|
|
- value
|
|
- option_id
|
|
- variant_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The product option value's ID
|
|
example: optval_01F0YESHR7S6ECD03RF6W12DSJ
|
|
value:
|
|
description: >-
|
|
The value that the Product Variant has defined for the specific
|
|
Product Option (e.g. if the Product Option is "Size" this value
|
|
could be "Small", "Medium" or "Large").
|
|
type: string
|
|
example: large
|
|
option_id:
|
|
description: >-
|
|
The ID of the Product Option that the Product Option Value is
|
|
defined for.
|
|
type: string
|
|
example: opt_01F0YESHQBZVKCEXJ24BS6PCX3
|
|
option:
|
|
description: Available if the relation `option` is expanded.
|
|
$ref: '#/components/schemas/product_option'
|
|
variant_id:
|
|
description: >-
|
|
The ID of the Product Variant that the Product Option Value is
|
|
defined for.
|
|
type: string
|
|
example: variant_01G1G5V2MRX2V3PVSR2WXYPFB6
|
|
variant:
|
|
description: Available if the relation `variant` is expanded.
|
|
$ref: '#/components/schemas/product_variant'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
product_option:
|
|
title: Product Option
|
|
description: >-
|
|
Product Options define properties that may vary between different
|
|
variants of a Product. Common Product Options are "Size" and "Color",
|
|
but Medusa doesn't limit what Product Options that can be defined.
|
|
x-resourceId: product_option
|
|
required:
|
|
- title
|
|
- product_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The product option's ID
|
|
example: opt_01F0YESHQBZVKCEXJ24BS6PCX3
|
|
title:
|
|
description: The title that the Product Option is defined by (e.g. "Size").
|
|
type: string
|
|
example: Size
|
|
values:
|
|
description: >-
|
|
The Product Option Values that are defined for the Product Option.
|
|
Available if the relation `values` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_option_value'
|
|
product_id:
|
|
description: The ID of the Product that the Product Option is defined for.
|
|
type: string
|
|
example: prod_01G1G5V2MBA328390B5AXJ610F
|
|
product:
|
|
description: A product object. Available if the relation `product` is expanded.
|
|
type: object
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
product_tag:
|
|
title: Product Tag
|
|
description: Product Tags can be added to Products for easy filtering and grouping.
|
|
x-resourceId: product_tag
|
|
required:
|
|
- value
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The product tag's ID
|
|
example: ptag_01G8K2MTMG9168F2B70S1TAVK3
|
|
value:
|
|
description: The value that the Product Tag represents
|
|
type: string
|
|
example: Pants
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
product_tax_rate:
|
|
title: Product Tax Rate
|
|
description: >-
|
|
Associates a tax rate with a product to indicate that the product is
|
|
taxed in a certain way
|
|
x-resourceId: product_tax_rate
|
|
required:
|
|
- product_id
|
|
- rate_id
|
|
properties:
|
|
product_id:
|
|
description: The ID of the Product
|
|
type: string
|
|
example: prod_01G1G5V2MBA328390B5AXJ610F
|
|
product:
|
|
description: Available if the relation `product` is expanded.
|
|
$ref: '#/components/schemas/product'
|
|
rate_id:
|
|
description: The ID of the Tax Rate
|
|
type: string
|
|
example: txr_01G8XDBAWKBHHJRKH0AV02KXBR
|
|
tax_rate:
|
|
description: Available if the relation `tax_rate` is expanded.
|
|
$ref: '#/components/schemas/tax_rate'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
product_type_tax_rate:
|
|
title: Product Type Tax Rate
|
|
description: >-
|
|
Associates a tax rate with a product type to indicate that the product
|
|
type is taxed in a certain way
|
|
x-resourceId: product_type_tax_rate
|
|
required:
|
|
- product_type_id
|
|
- rate_id
|
|
properties:
|
|
product_type_id:
|
|
description: The ID of the Product type
|
|
type: string
|
|
example: ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
product_type:
|
|
description: Available if the relation `product_type` is expanded.
|
|
$ref: '#/components/schemas/product_type'
|
|
rate_id:
|
|
description: The id of the Tax Rate
|
|
type: string
|
|
example: txr_01G8XDBAWKBHHJRKH0AV02KXBR
|
|
tax_rate:
|
|
description: Available if the relation `tax_rate` is expanded.
|
|
$ref: '#/components/schemas/tax_rate'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
product_type:
|
|
title: Product Type
|
|
description: >-
|
|
Product Type can be added to Products for filtering and reporting
|
|
purposes.
|
|
x-resourceId: product_type
|
|
required:
|
|
- value
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The product type's ID
|
|
example: ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
value:
|
|
description: The value that the Product Type represents.
|
|
type: string
|
|
example: Clothing
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
product_variant:
|
|
title: Product Variant
|
|
description: >-
|
|
Product Variants represent a Product with a specific set of Product
|
|
Option configurations. The maximum number of Product Variants that a
|
|
Product can have is given by the number of available Product Option
|
|
combinations.
|
|
x-resourceId: product_variant
|
|
required:
|
|
- title
|
|
- product_id
|
|
- inventory_quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The product variant's ID
|
|
example: variant_01G1G5V2MRX2V3PVSR2WXYPFB6
|
|
title:
|
|
description: >-
|
|
A title that can be displayed for easy identification of the Product
|
|
Variant.
|
|
type: string
|
|
example: Small
|
|
product_id:
|
|
description: The ID of the Product that the Product Variant belongs to.
|
|
type: string
|
|
example: prod_01G1G5V2MBA328390B5AXJ610F
|
|
product:
|
|
description: A product object. Available if the relation `product` is expanded.
|
|
type: object
|
|
prices:
|
|
description: >-
|
|
The Money Amounts defined for the Product Variant. Each Money Amount
|
|
represents a price in a given currency or a price in a specific
|
|
Region. Available if the relation `prices` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/money_amount'
|
|
sku:
|
|
description: >-
|
|
The unique stock keeping unit used to identify the Product Variant.
|
|
This will usually be a unqiue identifer for the item that is to be
|
|
shipped, and can be referenced across multiple systems.
|
|
type: string
|
|
example: shirt-123
|
|
barcode:
|
|
description: >-
|
|
A generic field for a GTIN number that can be used to identify the
|
|
Product Variant.
|
|
type: string
|
|
example: null
|
|
ean:
|
|
description: >-
|
|
An EAN barcode number that can be used to identify the Product
|
|
Variant.
|
|
type: string
|
|
example: null
|
|
upc:
|
|
description: >-
|
|
A UPC barcode number that can be used to identify the Product
|
|
Variant.
|
|
type: string
|
|
example: null
|
|
variant_rank:
|
|
description: The ranking of this variant
|
|
type: number
|
|
default: 0
|
|
inventory_quantity:
|
|
description: The current quantity of the item that is stocked.
|
|
type: integer
|
|
example: 100
|
|
allow_backorder:
|
|
description: >-
|
|
Whether the Product Variant should be purchasable when
|
|
`inventory_quantity` is 0.
|
|
type: boolean
|
|
default: false
|
|
manage_inventory:
|
|
description: Whether Medusa should manage inventory for the Product Variant.
|
|
type: boolean
|
|
default: true
|
|
hs_code:
|
|
description: >-
|
|
The Harmonized System code of the Product Variant. May be used by
|
|
Fulfillment Providers to pass customs information to shipping
|
|
carriers.
|
|
type: string
|
|
example: null
|
|
origin_country:
|
|
description: >-
|
|
The country in which the Product Variant was produced. May be used
|
|
by Fulfillment Providers to pass customs information to shipping
|
|
carriers.
|
|
type: string
|
|
example: null
|
|
mid_code:
|
|
description: >-
|
|
The Manufacturers Identification code that identifies the
|
|
manufacturer of the Product Variant. May be used by Fulfillment
|
|
Providers to pass customs information to shipping carriers.
|
|
type: string
|
|
example: null
|
|
material:
|
|
description: >-
|
|
The material and composition that the Product Variant is made of,
|
|
May be used by Fulfillment Providers to pass customs information to
|
|
shipping carriers.
|
|
type: string
|
|
example: null
|
|
weight:
|
|
description: >-
|
|
The weight of the Product Variant. May be used in shipping rate
|
|
calculations.
|
|
type: number
|
|
example: null
|
|
height:
|
|
description: >-
|
|
The height of the Product Variant. May be used in shipping rate
|
|
calculations.
|
|
type: number
|
|
example: null
|
|
width:
|
|
description: >-
|
|
The width of the Product Variant. May be used in shipping rate
|
|
calculations.
|
|
type: number
|
|
example: null
|
|
length:
|
|
description: >-
|
|
The length of the Product Variant. May be used in shipping rate
|
|
calculations.
|
|
type: number
|
|
example: null
|
|
options:
|
|
description: >-
|
|
The Product Option Values specified for the Product Variant.
|
|
Available if the relation `options` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_option_value'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
product:
|
|
title: Product
|
|
description: >-
|
|
Products are a grouping of Product Variants that have common properties
|
|
such as images and descriptions. Products can have multiple options
|
|
which define the properties that Product Variants differ by.
|
|
x-resourceId: product
|
|
required:
|
|
- title
|
|
- profile_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The product's ID
|
|
example: prod_01G1G5V2MBA328390B5AXJ610F
|
|
title:
|
|
description: >-
|
|
A title that can be displayed for easy identification of the
|
|
Product.
|
|
type: string
|
|
example: Medusa Coffee Mug
|
|
subtitle:
|
|
description: >-
|
|
An optional subtitle that can be used to further specify the
|
|
Product.
|
|
type: string
|
|
description:
|
|
description: A short description of the Product.
|
|
type: string
|
|
example: Every programmer's best friend.
|
|
handle:
|
|
description: A unique identifier for the Product (e.g. for slug structure).
|
|
type: string
|
|
example: coffee-mug
|
|
is_giftcard:
|
|
description: >-
|
|
Whether the Product represents a Gift Card. Products that represent
|
|
Gift Cards will automatically generate a redeemable Gift Card code
|
|
once they are purchased.
|
|
type: boolean
|
|
default: false
|
|
status:
|
|
description: The status of the product
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
default: draft
|
|
images:
|
|
description: >-
|
|
Images of the Product. Available if the relation `images` is
|
|
expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/image'
|
|
thumbnail:
|
|
description: A URL to an image file that can be used to identify the Product.
|
|
type: string
|
|
format: uri
|
|
options:
|
|
description: >-
|
|
The Product Options that are defined for the Product. Product
|
|
Variants of the Product will have a unique combination of Product
|
|
Option Values. Available if the relation `options` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_option'
|
|
variants:
|
|
description: >-
|
|
The Product Variants that belong to the Product. Each will have a
|
|
unique combination of Product Option Values. Available if the
|
|
relation `variants` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_variant'
|
|
profile_id:
|
|
description: >-
|
|
The ID of the Shipping Profile that the Product belongs to. Shipping
|
|
Profiles have a set of defined Shipping Options that can be used to
|
|
Fulfill a given set of Products.
|
|
type: string
|
|
example: sp_01G1G5V239ENSZ5MV4JAR737BM
|
|
profile:
|
|
description: Available if the relation `profile` is expanded.
|
|
$ref: '#/components/schemas/shipping_profile'
|
|
weight:
|
|
description: >-
|
|
The weight of the Product Variant. May be used in shipping rate
|
|
calculations.
|
|
type: number
|
|
example: null
|
|
height:
|
|
description: >-
|
|
The height of the Product Variant. May be used in shipping rate
|
|
calculations.
|
|
type: number
|
|
example: null
|
|
width:
|
|
description: >-
|
|
The width of the Product Variant. May be used in shipping rate
|
|
calculations.
|
|
type: number
|
|
example: null
|
|
length:
|
|
description: >-
|
|
The length of the Product Variant. May be used in shipping rate
|
|
calculations.
|
|
type: number
|
|
example: null
|
|
hs_code:
|
|
description: >-
|
|
The Harmonized System code of the Product Variant. May be used by
|
|
Fulfillment Providers to pass customs information to shipping
|
|
carriers.
|
|
type: string
|
|
example: null
|
|
origin_country:
|
|
description: >-
|
|
The country in which the Product Variant was produced. May be used
|
|
by Fulfillment Providers to pass customs information to shipping
|
|
carriers.
|
|
type: string
|
|
example: null
|
|
mid_code:
|
|
description: >-
|
|
The Manufacturers Identification code that identifies the
|
|
manufacturer of the Product Variant. May be used by Fulfillment
|
|
Providers to pass customs information to shipping carriers.
|
|
type: string
|
|
example: null
|
|
material:
|
|
description: >-
|
|
The material and composition that the Product Variant is made of,
|
|
May be used by Fulfillment Providers to pass customs information to
|
|
shipping carriers.
|
|
type: string
|
|
example: null
|
|
collection_id:
|
|
type: string
|
|
description: The Product Collection that the Product belongs to
|
|
example: pcol_01F0YESBFAZ0DV6V831JXWH0BG
|
|
collection:
|
|
description: >-
|
|
A product collection object. Available if the relation `collection`
|
|
is expanded.
|
|
type: object
|
|
type_id:
|
|
type: string
|
|
description: The Product type that the Product belongs to
|
|
example: ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
type:
|
|
description: Available if the relation `type` is expanded.
|
|
$ref: '#/components/schemas/product_type'
|
|
tags:
|
|
description: >-
|
|
The Product Tags assigned to the Product. Available if the relation
|
|
`tags` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/product_tag'
|
|
discountable:
|
|
description: >-
|
|
Whether the Product can be discounted. Discounts will not apply to
|
|
Line Items of this Product when this flag is set to `false`.
|
|
type: boolean
|
|
default: true
|
|
external_id:
|
|
description: The external ID of the product
|
|
type: string
|
|
example: null
|
|
sales_channels:
|
|
description: >-
|
|
The sales channels the product is associated with. Available if the
|
|
relation `sales_channels` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A sales channel object.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
refund:
|
|
title: Refund
|
|
description: >-
|
|
Refund represent an amount of money transfered back to the Customer for
|
|
a given reason. Refunds may occur in relation to Returns, Swaps and
|
|
Claims, but can also be initiated by a store operator.
|
|
x-resourceId: refund
|
|
required:
|
|
- order_id
|
|
- amount
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The refund's ID
|
|
example: ref_01G1G5V27GYX4QXNARRQCW1N8T
|
|
order_id:
|
|
description: The id of the Order that the Refund is related to.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
amount:
|
|
description: The amount that has be refunded to the Customer.
|
|
type: integer
|
|
example: 1000
|
|
note:
|
|
description: An optional note explaining why the amount was refunded.
|
|
type: string
|
|
example: I didn't like it
|
|
reason:
|
|
description: >-
|
|
The reason given for the Refund, will automatically be set when
|
|
processed as part of a Swap, Claim or Return.
|
|
type: string
|
|
enum:
|
|
- discount
|
|
- return
|
|
- swap
|
|
- claim
|
|
- other
|
|
example: return
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of the refund
|
|
in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
region:
|
|
title: Region
|
|
description: >-
|
|
Regions hold settings for how Customers in a given geographical location
|
|
shop. The is, for example, where currencies and tax rates are defined. A
|
|
Region can consist of multiple countries to accomodate common shopping
|
|
settings across countries.
|
|
x-resourceId: region
|
|
required:
|
|
- name
|
|
- currency_code
|
|
- tax_rate
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The cart's ID
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
name:
|
|
description: >-
|
|
The name of the region as displayed to the customer. If the Region
|
|
only has one country it is recommended to write the country name.
|
|
type: string
|
|
example: EU
|
|
currency_code:
|
|
description: The 3 character currency code that the Region uses.
|
|
type: string
|
|
example: usd
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
currency:
|
|
description: Available if the relation `currency` is expanded.
|
|
$ref: '#/components/schemas/currency'
|
|
tax_rate:
|
|
description: The tax rate that should be charged on purchases in the Region.
|
|
type: number
|
|
example: 0
|
|
tax_rates:
|
|
description: >-
|
|
The tax rates that are included in the Region. Available if the
|
|
relation `tax_rates` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/tax_rate'
|
|
tax_code:
|
|
description: >-
|
|
The tax code used on purchases in the Region. This may be used by
|
|
other systems for accounting purposes.
|
|
type: string
|
|
example: null
|
|
gift_cards_taxable:
|
|
description: Whether the gift cards are taxable or not in this region.
|
|
type: boolean
|
|
default: true
|
|
automatic_taxes:
|
|
description: Whether taxes should be automated in this region.
|
|
type: boolean
|
|
default: true
|
|
countries:
|
|
description: >-
|
|
The countries that are included in the Region. Available if the
|
|
relation `countries` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/country'
|
|
tax_provider_id:
|
|
type: string
|
|
description: The ID of the tax provider used in this region
|
|
example: null
|
|
tax_provider:
|
|
description: Available if the relation `tax_provider` is expanded.
|
|
$ref: '#/components/schemas/tax_provider'
|
|
payment_providers:
|
|
description: >-
|
|
The Payment Providers that can be used to process Payments in the
|
|
Region. Available if the relation `payment_providers` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/payment_provider'
|
|
fulfillment_providers:
|
|
description: >-
|
|
The Fulfillment Providers that can be used to fulfill orders in the
|
|
Region. Available if the relation `payment_providers` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/fulfillment_provider'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
return_item:
|
|
title: Return Item
|
|
description: >-
|
|
Correlates a Line Item with a Return, keeping track of the quantity of
|
|
the Line Item that will be returned.
|
|
x-resourceId: return_item
|
|
required:
|
|
- return_id
|
|
- item_id
|
|
properties:
|
|
return_id:
|
|
description: The id of the Return that the Return Item belongs to.
|
|
type: string
|
|
example: ret_01F0YET7XPCMF8RZ0Y151NZV2V
|
|
return_order:
|
|
description: Available if the relation `return_order` is expanded.
|
|
$ref: '#/components/schemas/return'
|
|
item_id:
|
|
description: The id of the Line Item that the Return Item references.
|
|
type: string
|
|
example: item_01G8ZC9GWT6B2GP5FSXRXNFNGN
|
|
item:
|
|
description: Available if the relation `item` is expanded.
|
|
$ref: '#/components/schemas/line_item'
|
|
quantity:
|
|
description: The quantity of the Line Item that is included in the Return.
|
|
type: integer
|
|
example: 1
|
|
is_requested:
|
|
description: >-
|
|
Whether the Return Item was requested initially or received
|
|
unexpectedly in the warehouse.
|
|
type: boolean
|
|
default: true
|
|
requested_quantity:
|
|
description: The quantity that was originally requested to be returned.
|
|
type: integer
|
|
example: 1
|
|
recieved_quantity:
|
|
description: The quantity that was received in the warehouse.
|
|
type: integer
|
|
example: 1
|
|
reason_id:
|
|
description: The ID of the reason for returning the item.
|
|
type: string
|
|
example: rr_01G8X82GCCV2KSQHDBHSSAH5TQ
|
|
reason:
|
|
description: Available if the relation `reason` is expanded.
|
|
$ref: '#/components/schemas/return_reason'
|
|
note:
|
|
description: An optional note with additional details about the Return.
|
|
type: string
|
|
example: I didn't like it.
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
return_reason:
|
|
title: Return Reason
|
|
description: >-
|
|
A Reason for why a given product is returned. A Return Reason can be
|
|
used on Return Items in order to indicate why a Line Item was returned.
|
|
x-resourceId: return_reason
|
|
required:
|
|
- value
|
|
- label
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The cart's ID
|
|
example: rr_01G8X82GCCV2KSQHDBHSSAH5TQ
|
|
description:
|
|
description: A description of the Reason.
|
|
type: string
|
|
example: Items that are damaged
|
|
label:
|
|
description: A text that can be displayed to the Customer as a reason.
|
|
type: string
|
|
example: Damaged goods
|
|
value:
|
|
description: The value to identify the reason by.
|
|
type: string
|
|
example: damaged
|
|
parent_return_reason_id:
|
|
type: string
|
|
description: The ID of the parent reason.
|
|
example: null
|
|
parent_return_reason:
|
|
description: Available if the relation `parent_return_reason` is expanded.
|
|
$ref: '#/components/schemas/return_reason'
|
|
return_reason_children:
|
|
description: Available if the relation `return_reason_children` is expanded.
|
|
$ref: '#/components/schemas/return_reason'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
return:
|
|
title: Return
|
|
description: >-
|
|
Return orders hold information about Line Items that a Customer wishes
|
|
to send back, along with how the items will be returned. Returns can be
|
|
used as part of a Swap.
|
|
x-resourceId: return
|
|
required:
|
|
- refund_amount
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The return's ID
|
|
example: ret_01F0YET7XPCMF8RZ0Y151NZV2V
|
|
status:
|
|
description: Status of the Return.
|
|
type: string
|
|
enum:
|
|
- requested
|
|
- received
|
|
- requires_action
|
|
- canceled
|
|
default: requested
|
|
items:
|
|
description: >-
|
|
The Return Items that will be shipped back to the warehouse.
|
|
Available if the relation `items` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/return_item'
|
|
swap_id:
|
|
description: The ID of the Swap that the Return is a part of.
|
|
type: string
|
|
example: null
|
|
swap:
|
|
description: A swap object. Available if the relation `swap` is expanded.
|
|
type: object
|
|
order_id:
|
|
description: The ID of the Order that the Return is made from.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
claim_order_id:
|
|
description: The ID of the Claim that the Return is a part of.
|
|
type: string
|
|
example: null
|
|
claim_order:
|
|
description: >-
|
|
A claim order object. Available if the relation `claim_order` is
|
|
expanded.
|
|
type: object
|
|
shipping_method:
|
|
description: >-
|
|
The Shipping Method that will be used to send the Return back. Can
|
|
be null if the Customer facilitates the return shipment themselves.
|
|
Available if the relation `shipping_method` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/shipping_method'
|
|
shipping_data:
|
|
description: >-
|
|
Data about the return shipment as provided by the Fulfilment
|
|
Provider that handles the return shipment.
|
|
type: object
|
|
example: {}
|
|
refund_amount:
|
|
description: The amount that should be refunded as a result of the return.
|
|
type: integer
|
|
example: 1000
|
|
no_notification:
|
|
description: >-
|
|
When set to true, no notification will be sent related to this
|
|
return.
|
|
type: boolean
|
|
example: false
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of the return
|
|
in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
received_at:
|
|
description: The date with timezone at which the return was received.
|
|
type: string
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
sales_channel:
|
|
title: Sales Channel
|
|
description: A Sales Channel
|
|
x-resourceId: sales_channel
|
|
required:
|
|
- name
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The sales channel's ID
|
|
example: sc_01G8X9A7ESKAJXG2H0E6F1MW7A
|
|
name:
|
|
description: The name of the sales channel.
|
|
type: string
|
|
example: Market
|
|
description:
|
|
description: The description of the sales channel.
|
|
type: string
|
|
example: Multi-vendor market
|
|
is_disabled:
|
|
description: Specify if the sales channel is enabled or disabled.
|
|
type: boolean
|
|
default: false
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
sales_channel_tax_line:
|
|
title: Sales Channel
|
|
description: A Sales Channel
|
|
x-resourceId: sales_channel_tax_line
|
|
required:
|
|
- shipping_method_id
|
|
- rate
|
|
- name
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The line item tax line's ID
|
|
example: smtl_01G1G5V2DRX1SK6NQQ8VVX4HQ8
|
|
shipping_method_id:
|
|
type: string
|
|
description: The ID of the line item
|
|
example: sm_01F0YET7DR2E7CYVSDHM593QG2
|
|
shipping_method:
|
|
description: Available if the relation `shipping_method` is expanded.
|
|
$ref: '#/components/schemas/shipping_method'
|
|
code:
|
|
description: A code to identify the tax type by
|
|
type: string
|
|
example: tax01
|
|
name:
|
|
description: A human friendly name for the tax
|
|
type: string
|
|
example: Tax Example
|
|
rate:
|
|
description: The numeric rate to charge tax by
|
|
type: number
|
|
example: 10
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
shipping_method:
|
|
title: Shipping Method
|
|
description: >-
|
|
Shipping Methods represent a way in which an Order or Return can be
|
|
shipped. Shipping Methods are built from a Shipping Option, but may
|
|
contain additional details, that can be necessary for the Fulfillment
|
|
Provider to handle the shipment.
|
|
x-resourceId: shipping_method
|
|
required:
|
|
- shipping_option_id
|
|
- price
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The shipping method's ID
|
|
example: sm_01F0YET7DR2E7CYVSDHM593QG2
|
|
shipping_option_id:
|
|
description: >-
|
|
The id of the Shipping Option that the Shipping Method is built
|
|
from.
|
|
type: string
|
|
example: so_01G1G5V27GYX4QXNARRQCW1N8T
|
|
shipping_option:
|
|
description: Available if the relation `shipping_option` is expanded.
|
|
$ref: '#/components/schemas/shipping_option'
|
|
order_id:
|
|
description: The id of the Order that the Shipping Method is used on.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
return_id:
|
|
description: The id of the Return that the Shipping Method is used on.
|
|
type: string
|
|
example: null
|
|
return_order:
|
|
description: >-
|
|
A return object. Available if the relation `return_order` is
|
|
expanded.
|
|
type: object
|
|
swap_id:
|
|
description: The id of the Swap that the Shipping Method is used on.
|
|
type: string
|
|
example: null
|
|
swap:
|
|
description: A swap object. Available if the relation `swap` is expanded.
|
|
type: object
|
|
cart_id:
|
|
description: The id of the Cart that the Shipping Method is used on.
|
|
type: string
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
cart:
|
|
description: A cart object. Available if the relation `cart` is expanded.
|
|
type: object
|
|
claim_order_id:
|
|
description: The id of the Claim that the Shipping Method is used on.
|
|
type: string
|
|
example: null
|
|
claim_order:
|
|
description: >-
|
|
A claim order object. Available if the relation `claim_order` is
|
|
expanded.
|
|
type: object
|
|
tax_lines:
|
|
type: array
|
|
description: Available if the relation `tax_lines` is expanded.
|
|
items:
|
|
$ref: '#/components/schemas/tax_line'
|
|
price:
|
|
description: >-
|
|
The amount to charge for the Shipping Method. The currency of the
|
|
price is defined by the Region that the Order that the Shipping
|
|
Method belongs to is a part of.
|
|
type: integer
|
|
example: 200
|
|
data:
|
|
description: >-
|
|
Additional data that the Fulfillment Provider needs to fulfill the
|
|
shipment. This is used in combination with the Shipping Options
|
|
data, and may contain information such as a drop point id.
|
|
type: object
|
|
example: {}
|
|
shipping_option_requirement:
|
|
title: Shipping Option Requirement
|
|
description: >-
|
|
A requirement that a Cart must satisfy for the Shipping Option to be
|
|
available to the Cart.
|
|
x-resourceId: shipping_option_requirement
|
|
required:
|
|
- shipping_option_id
|
|
- type
|
|
- amount
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The shipping option requirement's ID
|
|
example: sor_01G1G5V29AB4CTNDRFSRWSRKWD
|
|
shipping_option_id:
|
|
description: >-
|
|
The id of the Shipping Option that the hipping option requirement
|
|
belongs to
|
|
type: string
|
|
example: so_01G1G5V27GYX4QXNARRQCW1N8T
|
|
shipping_option:
|
|
description: Available if the relation `shipping_option` is expanded.
|
|
$ref: '#/components/schemas/shipping_option'
|
|
type:
|
|
description: >-
|
|
The type of the requirement, this defines how the value will be
|
|
compared to the Cart's total. `min_subtotal` requirements define the
|
|
minimum subtotal that is needed for the Shipping Option to be
|
|
available, while the `max_subtotal` defines the maximum subtotal
|
|
that the Cart can have for the Shipping Option to be available.
|
|
type: string
|
|
enum:
|
|
- min_subtotal
|
|
- max_subtotal
|
|
example: min_subtotal
|
|
amount:
|
|
description: The amount to compare the Cart subtotal to.
|
|
type: integer
|
|
example: 100
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
shipping_option:
|
|
title: Shipping Option
|
|
description: >-
|
|
Shipping Options represent a way in which an Order or Return can be
|
|
shipped. Shipping Options have an associated Fulfillment Provider that
|
|
will be used when the fulfillment of an Order is initiated. Shipping
|
|
Options themselves cannot be added to Carts, but serve as a template for
|
|
Shipping Methods. This distinction makes it possible to customize
|
|
individual Shipping Methods with additional information.
|
|
x-resourceId: shipping_option
|
|
required:
|
|
- name
|
|
- region_id
|
|
- profile_id
|
|
- provider_id
|
|
- price_type
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The shipping option's ID
|
|
example: so_01G1G5V27GYX4QXNARRQCW1N8T
|
|
name:
|
|
description: >-
|
|
The name given to the Shipping Option - this may be displayed to the
|
|
Customer.
|
|
type: string
|
|
example: PostFake Standard
|
|
region_id:
|
|
type: string
|
|
description: The region's ID
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
region:
|
|
description: A region object. Available if the relation `region` is expanded.
|
|
type: object
|
|
profile_id:
|
|
description: >-
|
|
The ID of the Shipping Profile that the shipping option belongs to.
|
|
Shipping Profiles have a set of defined Shipping Options that can be
|
|
used to Fulfill a given set of Products.
|
|
type: string
|
|
example: sp_01G1G5V239ENSZ5MV4JAR737BM
|
|
profile:
|
|
description: Available if the relation `profile` is expanded.
|
|
$ref: '#/components/schemas/shipping_profile'
|
|
provider_id:
|
|
description: >-
|
|
The id of the Fulfillment Provider, that will be used to process
|
|
Fulfillments from the Shipping Option.
|
|
type: string
|
|
example: manual
|
|
provider:
|
|
description: Available if the relation `provider` is expanded.
|
|
$ref: '#/components/schemas/fulfillment_provider'
|
|
price_type:
|
|
description: >-
|
|
The type of pricing calculation that is used when creatin Shipping
|
|
Methods from the Shipping Option. Can be `flat_rate` for fixed
|
|
prices or `calculated` if the Fulfillment Provider can provide price
|
|
calulations.
|
|
type: string
|
|
enum:
|
|
- flat_rate
|
|
- calculated
|
|
example: flat_rate
|
|
amount:
|
|
description: >-
|
|
The amount to charge for shipping when the Shipping Option price
|
|
type is `flat_rate`.
|
|
type: integer
|
|
example: 200
|
|
is_return:
|
|
description: >-
|
|
Flag to indicate if the Shipping Option can be used for Return
|
|
shipments.
|
|
type: boolean
|
|
default: false
|
|
requirements:
|
|
description: >-
|
|
The requirements that must be satisfied for the Shipping Option to
|
|
be available for a Cart. Available if the relation `requirements` is
|
|
expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/shipping_option_requirement'
|
|
data:
|
|
description: >-
|
|
The data needed for the Fulfillment Provider to identify the
|
|
Shipping Option.
|
|
type: object
|
|
example: {}
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
shipping_profile:
|
|
title: Shipping Profile
|
|
description: >-
|
|
Shipping Profiles have a set of defined Shipping Options that can be
|
|
used to fulfill a given set of Products.
|
|
x-resourceId: shipping_profile
|
|
required:
|
|
- name
|
|
- type
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The shipping profile's ID
|
|
example: sp_01G1G5V239ENSZ5MV4JAR737BM
|
|
name:
|
|
description: >-
|
|
The name given to the Shipping profile - this may be displayed to
|
|
the Customer.
|
|
type: string
|
|
example: Default Shipping Profile
|
|
type:
|
|
description: >-
|
|
The type of the Shipping Profile, may be `default`, `gift_card` or
|
|
`custom`.
|
|
type: string
|
|
enum:
|
|
- default
|
|
- gift_card
|
|
- custom
|
|
example: default
|
|
products:
|
|
description: >-
|
|
The Products that the Shipping Profile defines Shipping Options for.
|
|
Available if the relation `products` is expanded.
|
|
type: array
|
|
items:
|
|
type: object
|
|
description: A product object.
|
|
shipping_options:
|
|
description: >-
|
|
The Shipping Options that can be used to fulfill the Products in the
|
|
Shipping Profile. Available if the relation `shipping_options` is
|
|
expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/shipping_option'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
shipping_tax_rate:
|
|
title: Shipping Tax Rate
|
|
description: >-
|
|
Associates a tax rate with a shipping option to indicate that the
|
|
shipping option is taxed in a certain way
|
|
x-resourceId: shipping_tax_rate
|
|
required:
|
|
- shipping_option_id
|
|
- rate_id
|
|
properties:
|
|
shipping_option_id:
|
|
description: The ID of the Shipping Option
|
|
type: string
|
|
example: so_01G1G5V27GYX4QXNARRQCW1N8T
|
|
shipping_option:
|
|
description: Available if the relation `shipping_option` is expanded.
|
|
$ref: '#/components/schemas/shipping_option'
|
|
rate_id:
|
|
description: The ID of the Tax Rate
|
|
type: string
|
|
example: txr_01G8XDBAWKBHHJRKH0AV02KXBR
|
|
tax_rate:
|
|
description: Available if the relation `tax_rate` is expanded.
|
|
$ref: '#/components/schemas/tax_rate'
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
staged_job:
|
|
title: Staged Job
|
|
description: A staged job resource
|
|
x-resourceId: staged_job
|
|
required:
|
|
- event_name
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The staged job's ID
|
|
example: job_01F0YET7BZTARY9MKN1SJ7AAXF
|
|
event_name:
|
|
description: The name of the event
|
|
type: string
|
|
example: order.placed
|
|
data:
|
|
description: Data necessary for the job
|
|
type: object
|
|
example: {}
|
|
store:
|
|
title: Store
|
|
description: 'Holds settings for the Store, such as name, currencies, etc.'
|
|
x-resourceId: store
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The store's ID
|
|
example: store_01G1G5V21KADXNGH29BJMAJ4B4
|
|
name:
|
|
description: The name of the Store - this may be displayed to the Customer.
|
|
type: string
|
|
example: Medusa Store
|
|
default_currency_code:
|
|
description: The 3 character currency code that is the default of the store.
|
|
type: string
|
|
example: usd
|
|
externalDocs:
|
|
url: 'https://en.wikipedia.org/wiki/ISO_4217#Active_codes'
|
|
description: See a list of codes.
|
|
default_currency:
|
|
description: Available if the relation `default_currency` is expanded.
|
|
$ref: '#/components/schemas/currency'
|
|
currencies:
|
|
description: >-
|
|
The currencies that are enabled for the Store. Available if the
|
|
relation `currencies` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/currency'
|
|
swap_link_template:
|
|
description: >-
|
|
A template to generate Swap links from. Use {{cart_id}} to include
|
|
the Swap's `cart_id` in the link.
|
|
type: string
|
|
example: null
|
|
payment_link_template:
|
|
description: >-
|
|
A template to generate Payment links from. Use {{cart_id}} to
|
|
include the payment's `cart_id` in the link.
|
|
type: string
|
|
example: null
|
|
invite_link_template:
|
|
description: A template to generate Invite links from
|
|
type: string
|
|
example: null
|
|
default_sales_channel_id:
|
|
type: string
|
|
description: The sales channel ID the cart is associated with.
|
|
example: null
|
|
default_sales_channel:
|
|
description: >-
|
|
A sales channel object. Available if the relation
|
|
`default_sales_channel` is expanded.
|
|
type: object
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
swap:
|
|
title: Swap
|
|
description: >-
|
|
Swaps can be created when a Customer wishes to exchange Products that
|
|
they have purchased to different Products. Swaps consist of a Return of
|
|
previously purchased Products and a Fulfillment of new Products, the
|
|
amount paid for the Products being returned will be used towards payment
|
|
for the new Products. In the case where the amount paid for the the
|
|
Products being returned exceed the amount to be paid for the new
|
|
Products, a Refund will be issued for the difference.
|
|
x-resourceId: swap
|
|
required:
|
|
- fulfillment_status
|
|
- payment_status
|
|
- order_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The swap's ID
|
|
example: swap_01F0YET86Y9G92D3YDR9Y6V676
|
|
fulfillment_status:
|
|
description: The status of the Fulfillment of the Swap.
|
|
type: string
|
|
enum:
|
|
- not_fulfilled
|
|
- fulfilled
|
|
- shipped
|
|
- canceled
|
|
- requires_action
|
|
example: not_fulfilled
|
|
payment_status:
|
|
description: >-
|
|
The status of the Payment of the Swap. The payment may either refer
|
|
to the refund of an amount or the authorization of a new amount.
|
|
type: string
|
|
enum:
|
|
- not_paid
|
|
- awaiting
|
|
- captured
|
|
- confirmed
|
|
- canceled
|
|
- difference_refunded
|
|
- partially_refunded
|
|
- refunded
|
|
- requires_action
|
|
example: not_paid
|
|
order_id:
|
|
description: >-
|
|
The ID of the Order where the Line Items to be returned where
|
|
purchased.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: An order object. Available if the relation `order` is expanded.
|
|
type: object
|
|
additional_items:
|
|
description: >-
|
|
The new Line Items to ship to the Customer. Available if the
|
|
relation `additional_items` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/line_item'
|
|
return_order:
|
|
description: >-
|
|
A return order object. The Return that is issued for the return part
|
|
of the Swap. Available if the relation `return_order` is expanded.
|
|
type: object
|
|
fulfillments:
|
|
description: >-
|
|
The Fulfillments used to send the new Line Items. Available if the
|
|
relation `fulfillments` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/fulfillment'
|
|
payment:
|
|
description: >-
|
|
The Payment authorized when the Swap requires an additional amount
|
|
to be charged from the Customer. Available if the relation `payment`
|
|
is expanded.
|
|
$ref: '#/components/schemas/payment'
|
|
difference_due:
|
|
description: >-
|
|
The difference that is paid or refunded as a result of the Swap. May
|
|
be negative when the amount paid for the returned items exceed the
|
|
total of the new Products.
|
|
type: integer
|
|
example: 0
|
|
shipping_address_id:
|
|
description: >-
|
|
The Address to send the new Line Items to - in most cases this will
|
|
be the same as the shipping address on the Order.
|
|
type: string
|
|
example: addr_01G8ZH853YPY9B94857DY91YGW
|
|
shipping_address:
|
|
description: Available if the relation `shipping_address` is expanded.
|
|
$ref: '#/components/schemas/address'
|
|
shipping_methods:
|
|
description: >-
|
|
The Shipping Methods used to fulfill the addtional items purchased.
|
|
Available if the relation `shipping_methods` is expanded.
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/shipping_method'
|
|
cart_id:
|
|
description: The id of the Cart that the Customer will use to confirm the Swap.
|
|
type: string
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
cart:
|
|
description: A cart object. Available if the relation `cart` is expanded.
|
|
type: object
|
|
allow_backorder:
|
|
description: 'If true, swaps can be completed with items out of stock'
|
|
type: boolean
|
|
default: false
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of the swap
|
|
in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
confirmed_at:
|
|
description: >-
|
|
The date with timezone at which the Swap was confirmed by the
|
|
Customer.
|
|
type: string
|
|
format: date-time
|
|
canceled_at:
|
|
description: The date with timezone at which the Swap was canceled.
|
|
type: string
|
|
format: date-time
|
|
no_notification:
|
|
description: 'If set to true, no notification will be sent related to this swap'
|
|
type: boolean
|
|
example: false
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
tax_line:
|
|
title: Tax Line
|
|
description: Line item that specifies an amount of tax to add to a line item.
|
|
x-resourceId: tax_line
|
|
required:
|
|
- rate
|
|
- name
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The tax line's ID
|
|
example: tl_01G1G5V2DRX1SK6NQQ8VVX4HQ8
|
|
code:
|
|
description: A code to identify the tax type by
|
|
type: string
|
|
example: tax01
|
|
name:
|
|
description: A human friendly name for the tax
|
|
type: string
|
|
example: Tax Example
|
|
rate:
|
|
description: The numeric rate to charge tax by
|
|
type: number
|
|
example: 10
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
tax_provider:
|
|
title: Tax Provider
|
|
description: The tax service used to calculate taxes
|
|
x-resourceId: tax_provider
|
|
properties:
|
|
id:
|
|
description: The id of the tax provider as given by the plugin.
|
|
type: string
|
|
example: manual
|
|
is_installed:
|
|
description: >-
|
|
Whether the plugin is installed in the current version. Plugins that
|
|
are no longer installed are not deleted by will have this field set
|
|
to `false`.
|
|
type: boolean
|
|
default: true
|
|
tax_rate:
|
|
title: Tax Rate
|
|
description: >-
|
|
A Tax Rate can be used to associate a certain rate to charge on products
|
|
within a given Region
|
|
x-resourceId: line_item
|
|
required:
|
|
- name
|
|
- region_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The tax rate's ID
|
|
example: txr_01G8XDBAWKBHHJRKH0AV02KXBR
|
|
rate:
|
|
description: The numeric rate to charge
|
|
type: number
|
|
example: 10
|
|
code:
|
|
description: A code to identify the tax type by
|
|
type: string
|
|
example: tax01
|
|
name:
|
|
description: A human friendly name for the tax
|
|
type: string
|
|
example: Tax Example
|
|
region_id:
|
|
type: string
|
|
description: The id of the Region that the rate belongs to
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
region:
|
|
description: A region object. Available if the relation `region` is expanded.
|
|
type: object
|
|
products:
|
|
type: array
|
|
description: >-
|
|
The products that belong to this tax rate. Available if the relation
|
|
`products` is expanded.
|
|
items:
|
|
type: object
|
|
description: A product object.
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
The product types that belong to this tax rate. Available if the
|
|
relation `product_types` is expanded.
|
|
items:
|
|
type: object
|
|
description: A product type object.
|
|
shipping_options:
|
|
type: array
|
|
description: >-
|
|
The shipping options that belong to this tax rate. Available if the
|
|
relation `shipping_options` is expanded.
|
|
items:
|
|
type: object
|
|
description: A shipping option object.
|
|
product_count:
|
|
description: The count of products
|
|
type: integer
|
|
example: null
|
|
product_type_count:
|
|
description: The count of product types
|
|
type: integer
|
|
example: null
|
|
shipping_option_count:
|
|
description: The count of shipping options
|
|
type: integer
|
|
example: null
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
tracking_link:
|
|
title: Tracking Link
|
|
description: >-
|
|
Tracking Link holds information about tracking numbers for a
|
|
Fulfillment. Tracking Links can optionally contain a URL that can be
|
|
visited to see the status of the shipment.
|
|
x-resourceId: tracking_link
|
|
required:
|
|
- tracking_number
|
|
- fulfillment_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The tracking link's ID
|
|
example: tlink_01G8ZH853Y6TFXWPG5EYE81X63
|
|
url:
|
|
description: The URL at which the status of the shipment can be tracked.
|
|
type: string
|
|
format: uri
|
|
tracking_number:
|
|
description: The tracking number given by the shipping carrier.
|
|
type: string
|
|
format: RH370168054CN
|
|
fulfillment_id:
|
|
type: string
|
|
description: The id of the Fulfillment that the Tracking Link references.
|
|
example: ful_01G8ZRTMQCA76TXNAT81KPJZRF
|
|
fulfillment:
|
|
description: Available if the relation `fulfillment` is expanded.
|
|
$ref: '#/components/schemas/fulfillment'
|
|
idempotency_key:
|
|
type: string
|
|
description: >-
|
|
Randomly generated key used to continue the completion of a process
|
|
in case of failure.
|
|
externalDocs:
|
|
url: >-
|
|
https://docs.medusajs.com/advanced/backend/payment/overview#idempotency-key
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|
|
user:
|
|
title: User
|
|
description: Represents a User who can manage store settings.
|
|
x-resourceId: user
|
|
required:
|
|
- email
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The user's ID
|
|
example: usr_01G1G5V26F5TB3GPAPNJ8X1S3V
|
|
email:
|
|
description: The email of the User
|
|
type: string
|
|
format: email
|
|
first_name:
|
|
description: The first name of the User
|
|
type: string
|
|
example: Levi
|
|
last_name:
|
|
description: The last name of the User
|
|
type: string
|
|
example: Bogan
|
|
api_token:
|
|
description: An API token associated with the user.
|
|
type: string
|
|
example: null
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|