Items

An Item in Swish belongs to a List and references a Shopify product/variant.

get

Authorizations

Swish API keybearer

HTTPRequired

Query parameters

pagestringOptional

The page cursor

limitnumberOptional

Number of lists/items to return

Default: 50

querystringOptional

Item search query

Example: product:123,456 tag:saved-from-cart,saved-from-page

Responses

200

Returns all items as paginated response

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

get

/items

HTTPcURLJavaScriptPython

GET /api/2025-04/items HTTP/1.1
Host: swish.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "pageInfo": {
    "next": "YWZ0ZXI6NjdhNjFkNTU2MWU0ZjlkZTMwMmMwMmEx",
    "previous": "YmVmb3JlOjY3YTYxZDU1NjFlNGY5ZGUzMDJjMDJhMQ=="
  },
  "data": [
    {
      "id": "67a61d5561e4f9de302c02a1",
      "productId": 123,
      "variantId": 456,
      "quantity": 1,
      "createdAt": "2025-01-01T10:00:00.000Z",
      "updatedAt": "2025-01-01T10:00:00.000Z"
    }
  ]
}

post

Authorizations

Swish API keybearer

HTTPRequired

Body

application/json

productIdnumberRequired

The Shopify ID of the product

Example: 123

variantIdnumberOptional

The Shopify ID of the variant

Example: 456

quantitynumberOptional

The quantity of the item

Default: 1Example: 1

tagsstring[]Optional

Tags associated with the item (must contain only lowercase letters, numbers, hyphens or underscores)

Example: ["saved-from-cart"]

Responses

201

The item has been successfully created.

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

post

/items

HTTPcURLJavaScriptPython

POST /api/2025-04/items HTTP/1.1
Host: swish.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "productId": 123,
  "variantId": 456,
  "quantity": 1,
  "tags": [
    "saved-from-cart"
  ]
}

{
  "data": {
    "id": "67a61d5561e4f9de302c02a1",
    "productId": 123,
    "variantId": 456,
    "quantity": 1,
    "createdAt": "2025-01-01T10:00:00.000Z",
    "updatedAt": "2025-01-01T10:00:00.000Z"
  }
}

delete

Authorizations

Swish API keybearer

HTTPRequired

Body

application/json

itemIdsstring[]Required

The list of item IDs to delete

Example: ["507f1f77bcf86cd799439011","507f1f77bcf86cd799439022"]

Responses

204

The items have been successfully deleted.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

delete

/items

HTTPcURLJavaScriptPython

DELETE /api/2025-04/items HTTP/1.1
Host: swish.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "itemIds": [
    "507f1f77bcf86cd799439011",
    "507f1f77bcf86cd799439022"
  ]
}

No content

patch

Authorizations

Swish API keybearer

HTTPRequired

Path parameters

itemIdstringRequired

The ID of the item

Example: 67a61d5561e4f9de302c02a1

Body

application/json

productIdnumberOptional

The Shopify ID of the product

Example: 123

variantIdnumberOptional

The Shopify ID of the variant

Example: 456

quantitynumberOptional

The quantity of the item

Default: 1Example: 2

Responses

200

The item has been successfully updated.

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

patch

/items/{itemId}

HTTPcURLJavaScriptPython

PATCH /api/2025-04/items/{itemId} HTTP/1.1
Host: swish.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "productId": 123,
  "variantId": 456,
  "quantity": 2
}

{
  "data": {
    "id": "67a61d5561e4f9de302c02a1",
    "productId": 123,
    "variantId": 456,
    "quantity": 1,
    "createdAt": "2025-01-01T10:00:00.000Z",
    "updatedAt": "2025-01-01T10:00:00.000Z"
  }
}

delete

Authorizations

Swish API keybearer

HTTPRequired

Path parameters

itemIdstringRequired

The ID of the item

Example: 67a61d5561e4f9de302c02a1

Responses

204

The item has been successfully deleted.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

delete

/items/{itemId}

HTTPcURLJavaScriptPython

DELETE /api/2025-04/items/{itemId} HTTP/1.1
Host: swish.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

get

Authorizations

Swish API keybearer

HTTPRequired

Path parameters

itemIdstringRequired

The ID of the item

Example: 67a61d5561e4f9de302c02a1

Responses

200

The item has been successfully found.

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

get

/items/{itemId}

HTTPcURLJavaScriptPython

GET /api/2025-04/items/{itemId} HTTP/1.1
Host: swish.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": {
    "id": "67a61d5561e4f9de302c02a1",
    "productId": 123,
    "variantId": 456,
    "quantity": 1,
    "createdAt": "2025-01-01T10:00:00.000Z",
    "updatedAt": "2025-01-01T10:00:00.000Z",
    "listIds": [
      "text"
    ]
  }
}

put

Authorizations

Swish API keybearer

HTTPRequired

Path parameters

itemIdstringRequired

The ID of the item

Example: 67a61d5561e4f9de302c02a1

Body

application/json

listIdsstring[]Required

The ID of the item to set the lists for

Example: ["67e2704d3c49af2fef03e054","67e2704d3c49af2fef03e054"]

Responses

200

The item has been successfully been added to the lists.

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

put

/items/{itemId}/lists

HTTPcURLJavaScriptPython

PUT /api/2025-04/items/{itemId}/lists HTTP/1.1
Host: swish.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "listIds": [
    "67e2704d3c49af2fef03e054",
    "67e2704d3c49af2fef03e054"
  ]
}

{
  "data": {
    "id": "67a61d5561e4f9de302c02a1",
    "productId": 123,
    "variantId": 456,
    "quantity": 1,
    "createdAt": "2025-01-01T10:00:00.000Z",
    "updatedAt": "2025-01-01T10:00:00.000Z",
    "listIds": [
      "text"
    ]
  }
}