Get deleted items history

GET https://app.ecwid.com/api/v3/{storeId}/{entity}/deleted

Required access scopes

Your app must have the following access scopes to make this request: read_store_profile , read_orders, read_catalog, read_discount_coupons, read_customers, read_reviews

Path params

All path params are required.

Param
Type
Description

storeId

number

Ecwid store ID.

entity

string

Defines which item's history will be received. Must be one of: orders, products, coupons, customers, reviews

Query params

All query params are optional.

Name
Type
Description

from_date

string

Item deletion date lower bound. Supported formats:

  • UNIX timestamp

  • yyyy-MM-dd HH:mm:ss Z

  • yyyy-MM-dd HH:mm:ss

  • yyyy-MM-dd

Examples:

  • 1447804800

  • 2015-04-22 18:48:38 -0500

  • 2015-04-22 (matches 2015-04-22 00:00:00 UTC)

to_date

string

Item deletion date upper bound.

offset

number

Offset from the beginning of the returned items list (for paging). Used when the number of returned items is higher than the limit of a single request.

limit

number

Maximum number of returned items. Default value: 100

Headers

The Authorization header is required.

Header
Format
Description

Authorization

Bearer secret_ab***cd

Access token of the application.

Response JSON

A JSON object with the following fields:

Field
Type
Description

total

number

Total number of found items (might be more than the number of returned items).

count

number

Total number of items returned in the response.

offset

number

Offset from the beginning of the returned items list specified in the request.

limit

number

Maximum number of returned items specified in the request. Maximum allowed value: 100. Default value: 10

items

List of removed items where each "item" contains ID and a deletion date.

removedItem

Field
Type
Description

id

number

Internal item ID that depends on the request. For example, product ID, customer ID, etc.

date

string

Item deletion date.

Last updated

Was this helpful?