Cancellation Requests

Reject cancellation request

post

Reject a specific cancellation request.

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
chevron-right
200

Cancellation request rejected successfully

application/json
post
/api/v1/cancellation_requests/{id}/reject/

Retrieve cancellation request

get

Retrieve a specific cancellation request by ID.

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
chevron-right
200

Cancellation request retrieved successfully

application/json
get
/api/v1/cancellation_requests/{id}

Retrieve detailed cancellation request

get

Retrieve a specific cancellation request by ID with detailed information.

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
chevron-right
200

Detailed cancellation request retrieved successfully

application/json
get
/api/v1/cancellation_requests/{id}/detailed/

Get tags of an Cancellation Request

get

Retrieve tags associated with a specific Cancellation Request by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
chevron-right
200

Tags retrieved successfully

application/json
Responsestring[]Example: tag1
get
/api/v1/cancellation_requests/{id}/get_tags/

Add tags to an Cancellation Request

post

Add tags to a specific Cancellation Request by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
keystringRequired

Tag key to add to the object.

Responses
chevron-right
200

Tags added successfully

No content

post
/api/v1/cancellation_requests/{id}/add_tag/

No content

Add multiple tags to an Cancellation Request

post

Add multiple tags to a specific Cancellation Request by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
keysstring[]Required

List of tag keys to add to the objects.

Responses
chevron-right
200

Tags added successfully

No content

post
/api/v1/cancellation_requests/{id}/bulk_add_tag/

No content

Remove tags to an Cancellation Request

post

Remove tags to a specific Cancellation Request by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
keystringRequired

Tag key to add to the object.

Responses
chevron-right
200

Tags removed successfully

No content

post
/api/v1/cancellation_requests/{id}/remove_tag/

No content

Remove multiple tags to an Cancellation Request

post

Remove multiple tags to a specific Cancellation Request by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
keysstring[]Required

List of tag keys to add to the objects.

Responses
chevron-right
200

Tags removed successfully

No content

post
/api/v1/cancellation_requests/{id}/bulk_remove_tags/

No content

List cancellation requests with tag filtering

get

List all cancellation requests with the ability to filter by tags and other parameters. 'key' parameter is required in query param or body.

Authorizations
AuthorizationstringRequired
Body
keystringOptional

Tag to filter cancellation requests by.

Responses
chevron-right
200

cancellation requests successfully listed

application/json
get
/api/v1/cancellation_requests/filter_by_tag/

List cancellation requests with tag exclusion filtering

get

List all cancellation requests with the ability to exclude by tags and other parameters. 'key' parameter is required in query param or body.

Authorizations
AuthorizationstringRequired
Body
keystringOptional

Tag to filter cancellation requests by.

Responses
chevron-right
200

cancellation requests successfully listed

application/json
get
/api/v1/cancellation_requests/exclude_by_tag/

Bulk add tags to cancellation requests

post

Bulk add tags to cancellation requests.

Authorizations
AuthorizationstringRequired
Body
objsinteger[]Required

List of object IDs to which tags will be added.

keysstring[]Required

List of tag keys to add to the objects.

Responses
chevron-right
200

Successfully added tags to cancellation requests

No content

post
/api/v1/cancellation_requests/bulk_add_tags/

No content

Bulk remove tags from cancellation requests

post

Bulk remove tags from cancellation requests.

Authorizations
AuthorizationstringRequired
Body
objsinteger[]Required

List of object IDs to which tags will be added.

keysstring[]Required

List of tag keys to add to the objects.

Responses
chevron-right
200

Successfully removed tags from cancellation requests

No content

post
/api/v1/cancellation_requests/bulk_remove_tags_with_many_instances/

No content

List cancellation requests

get

Retrieve a paginated list of all cancellation requests with filtering support.

Authorizations
AuthorizationstringRequired
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
created_datestring · date-timeOptional

Filter by creation date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: created_date__gt=2024-01-01T00:00:00Z
modified_datestring · date-timeOptional

Filter by modification date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: modified_date__lt=2024-01-01T00:00:00Z
uuidstringOptional

Filter by UUID.

Example: 123e4567-e89b-12d3-a456-426614174000
pkintegerOptional

Filters by primary key

pk__gtstringOptional

Filter by primary key greater than a specific value.

pk__gteintegerOptional

Filters by primary key greater than or equal to the given value

pk__ltintegerOptional

Filters by primary key less than the given value

pk__lteintegerOptional

Filters by primary key less than or equal to the given value

pk__ininteger[]Optional

Filter by multiple primary key values (comma-separated list of integers)

cancellation_typestring · enumOptional

Filter by cancellation type

Possible values:
statusstring · enumOptional

Status of the cancellation request.

Example: rejectedPossible values:
numberstringOptional

Order number (case-insensitive)

date_placedstring · date-timeOptional

Order number (case-insensitive)

skustringOptional

Product SKU (case-insensitive)

channelintegerOptional

ID of the channel the customer belongs to

Example: 5
customer_first_namestringOptional

Customer's first name (case-insensitive)

customer_last_namestringOptional

Customer's last name (case-insensitive)

customer_emailstring · emailOptional

Customer's email (case-insensitive)

order_idintegerOptional

Order ID

cancellation_plan_statusstring · enumOptional

Status of the cancellation plan

Example: waitingPossible values:
easy_return_codestringOptional

Easy return code (case-insensitive)

tracking_numberstringOptional

Tracking number (case-insensitive)

currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
order_item__shipping_option_group__shipping_option_slugstringOptional

Filter by shipping option slug (case-insensitive)

order_itemintegerOptional

Filter by order item ID.

reasonintegerOptional

Filter by cancellation reason ID

descriptionstringOptional

Filter by product description.

ibanstringOptional

Filter by IBAN

holder_namestringOptional

Filter by holder name

easy_returnintegerOptional

Filter by easy return ID

quantityintegerOptional

Filter by quantity

fully_refund_as_loyalty_moneybooleanOptional

Filter by fully refund as loyalty money flag

Responses
chevron-right
200

A paginated list of cancellation requests.

application/json
get
/api/v1/cancellation_requests/

Create cancellation request

post

Create a new cancellation request for an order item.

Authorizations
AuthorizationstringRequired
Body
order_itemintegerRequired

Related order item ID

Example: 1
reasonintegerRequired

Related cancellation reason ID

Example: 1
descriptionstring | nullableOptional

Description of the cancellation request

cancellation_typestring · enumRequired

Type of cancellation

Example: cancelPossible values:
ibanstring | nullableOptional

IBAN for refund

holder_namestring | nullableOptional

Name of the account holder

quantityinteger | nullableOptional

Quantity of items to be cancelled

Responses
post
/api/v1/cancellation_requests/

List detailed cancellation requests

get

Retrieve a paginated list of cancellation requests with detailed information. Use export_format parameter to get a different set of fields optimized for data export purposes.

Authorizations
AuthorizationstringRequired
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
export_formatstring · enumOptional

Export format for the report

Default: csvPossible values:
created_datestring · date-timeOptional

Filter by creation date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: created_date__gt=2024-01-01T00:00:00Z
modified_datestring · date-timeOptional

Filter by modification date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: modified_date__lt=2024-01-01T00:00:00Z
pkintegerOptional

Filters by primary key

pk__gtstringOptional

Filter by primary key greater than a specific value.

pk__gteintegerOptional

Filters by primary key greater than or equal to the given value

pk__ltintegerOptional

Filters by primary key less than the given value

pk__lteintegerOptional

Filters by primary key less than or equal to the given value

pk__ininteger[]Optional

Filter by multiple primary key values (comma-separated list of integers)

cancellation_typestring · enumOptional

Filter by cancellation type

Possible values:
statusstring · enumOptional

Status of the cancellation request.

Example: rejectedPossible values:
numberstringOptional

Order number (case-insensitive)

date_placedstring · date-timeOptional

Order number (case-insensitive)

skustringOptional

Product SKU (case-insensitive)

channelintegerOptional

ID of the channel the customer belongs to

Example: 5
customer_first_namestringOptional

Customer's first name (case-insensitive)

customer_last_namestringOptional

Customer's last name (case-insensitive)

customer_emailstring · emailOptional

Customer's email (case-insensitive)

order_idintegerOptional

Order ID

cancellation_plan_statusstring · enumOptional

Status of the cancellation plan

Example: waitingPossible values:
easy_return_codestringOptional

Easy return code (case-insensitive)

tracking_numberstringOptional

Tracking number (case-insensitive)

currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
order_item__shipping_option_group__shipping_option_slugstringOptional

Filter by shipping option slug (case-insensitive)

order_itemintegerOptional

Filter by order item ID.

reasonintegerOptional

Filter by cancellation reason ID

descriptionstringOptional

Filter by product description.

ibanstringOptional

Filter by IBAN

holder_namestringOptional

Filter by holder name

easy_returnintegerOptional

Filter by easy return ID

quantityintegerOptional

Filter by quantity

fully_refund_as_loyalty_moneybooleanOptional

Filter by fully refund as loyalty money flag

Responses
chevron-right
200

A paginated list of detailed cancellation requests.

application/json
get
/api/v1/cancellation_requests/detailed/

Update cancellation request

put

Update an existing cancellation request.

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
statusstring · enumOptional

Status of the cancellation request.

Example: waitingPossible values:
descriptionstring | nullableOptional

Description of the cancellation request

ibanstring | nullableOptional

IBAN for refund

holder_namestring | nullableOptional

Name of the account holder

cancellation_typestring · enumOptional

Type of cancellation

Example: cancelPossible values:
quantityinteger | nullableOptional

Quantity of items to be cancelled

fully_refund_as_loyalty_moneybooleanOptional

Flag to indicate if the refund should be processed as loyalty money

Default: false
reasonintegerOptional

Related cancellation reason ID

Example: 1
order_itemintegerOptional

Related order item ID

Example: 1
Responses
chevron-right
200

Cancellation request updated successfully.

application/json
put
/api/v1/cancellation_requests/{id}/

Partially update cancellation request

patch

Partially update an existing cancellation request.

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
statusstring · enumOptional

Status of the cancellation request.

Example: waitingPossible values:
descriptionstring | nullableOptional

Description of the cancellation request

ibanstring | nullableOptional

IBAN for refund

holder_namestring | nullableOptional

Name of the account holder

cancellation_typestring · enumOptional

Type of cancellation

Example: cancelPossible values:
quantityinteger | nullableOptional

Quantity of items to be cancelled

fully_refund_as_loyalty_moneybooleanOptional

Flag to indicate if the refund should be processed as loyalty money

Default: false
reasonintegerOptional

Related cancellation reason ID

Example: 1
order_itemintegerOptional

Related order item ID

Example: 1
Responses
chevron-right
200

Cancellation request partially updated successfully.

application/json
patch
/api/v1/cancellation_requests/{id}/

Last updated

Was this helpful?