BigCommerce

BigCommerce Wishlists API

The Wishlists API from BigCommerce — 2 operation(s) for wishlists.

GitHub OpenAPI

Operations 5

GET /wishlists BigCommerce Get All Wishlists #
POST /wishlists BigCommerce Create a Wishlist #
GET /wishlists/{wishlist_id} BigCommerce Get a Wishlist #
PUT /wishlists/{wishlist_id} BigCommerce Update a Wishlist #
DELETE /wishlists/{wishlist_id} BigCommerce Delete a Wishlist #

Documentation

📖
Documentation
https://developer.bigcommerce.com/
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/abandoned-carts
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/carts
📖
APIReference
https://developer.bigcommerce.com/docs/rest-catalog/brands
📖
APIReference
https://developer.bigcommerce.com/docs/rest-catalog/categories
📖
APIReference
https://developer.bigcommerce.com/docs/rest-catalog/category-trees
📖
APIReference
https://developer.bigcommerce.com/docs/rest-catalog/product-modifiers
📖
APIReference
https://developer.bigcommerce.com/docs/rest-catalog/product-variant-options
📖
APIReference
https://developer.bigcommerce.com/docs/rest-catalog/product-variants
📖
APIReference
https://developer.bigcommerce.com/docs/rest-catalog/products
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/channels
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/checkouts
📖
APIReference
https://developer.bigcommerce.com/docs/rest-content/store-content
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/currencies
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/customers
📖
APIReference
https://developer.bigcommerce.com/docs/rest-content/email-templates
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/geography
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/orders
📖
APIReference
https://developer.bigcommerce.com/docs/rest-content/pages
📖
APIReference
https://developer.bigcommerce.com/docs/rest-payments/tokens
📖
APIReference
https://developer.bigcommerce.com/docs/rest-payments/methods-deprecated
📖
APIReference
https://developer.bigcommerce.com/docs/rest-payments/processing
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/settings
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/shipping-v2
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/channels/site
📖
APIReference
https://developer.bigcommerce.com/docs/rest-management/store-information
📖
APIReference
https://developer.bigcommerce.com/docs/rest-storefront/carts
📖
APIReference
https://developer.bigcommerce.com/docs/rest-storefront/checkouts
📖
APIReference
https://developer.bigcommerce.com/docs/rest-storefront/customers
📖
APIReference
https://developer.bigcommerce.com/docs/rest-storefront/orders
📖
APIReference
https://developer.bigcommerce.com/docs/rest-storefront/subscriptions
📖
APIReference
https://developer.bigcommerce.com/docs/integrations/webhooks
📖
APIReference
https://developer.bigcommerce.com/docs/rest-content/widgets

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bigcommerce/refs/heads/main/openapi/bigcommerce-wishlists-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/bigcommerce/refs/heads/main/asyncapi/bigcommerce-webhooks-asyncapi.yml

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/bigcommerce/refs/heads/main/graphql/bigcommerce-graphql.md

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bigcommerce-wishlists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bigcommerce-wishlists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: BigCommerce Wishlist Wishlists API
  description: 'Create and manage customer wishlists and wishlist items.


    ## Additional Information


    * [Wishlists (Help Center)](https://support.bigcommerce.com/s/article/Wishlists)'
  version: ''
  termsOfService: https://www.bigcommerce.com/terms
  contact:
    name: BigCommerce
    url: https://www.bigcommerce.com
    email: support@bigcommerce.com
servers:
- url: https://api.bigcommerce.com/stores/{store_hash}/v3
  variables:
    store_hash:
      default: store_hash
      description: Permanent ID of the BigCommerce store.
  description: BigCommerce API Gateway
security:
- X-Auth-Token: []
tags:
- name: Wishlists
paths:
  /wishlists:
    get:
      tags:
      - Wishlists
      summary: BigCommerce Get All Wishlists
      description: Returns a list of wishlists. Optional filter parameters can be passed in.
      operationId: getWishlists
      parameters:
      - name: customer_id
        in: query
        description: All wishlists relating to the customer.
        schema:
          type: integer
          format: int32
      - name: page
        in: query
        description: The page number of results per page. 1 is the default and starts from record 0.
        schema:
          type: integer
          format: int32
      - name: limit
        in: query
        description: The numbers of items to return per page. Default is 50 and maximum is 250.
        schema:
          type: integer
          format: int32
      - $ref: '#/components/parameters/Accept'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/wishlist_Full'
                  meta:
                    $ref: '#/components/schemas/metaCollection'
              example:
                data:
                - id: 1
                  customer_id: 4
                  name: My Wish List
                  is_public: false
                  token: 02d55481-13eb-4d1e-9d79-9062b518570d
                  items: []
                - id: 2
                  customer_id: 11
                  name: Christmas
                  is_public: false
                  token: 02d55481-13eb-4d1e-9d79-9062b518570d
                  items:
                  - id: 1
                    product_id: 167
                  - id: 2
                    product_id: 174
                  - id: 3
                    product_id: 184
                - id: 3
                  customer_id: 20
                  name: Birthday
                  is_public: false
                  token: 02d55481-13eb-4d1e-9d79-9062b518570d
                  items:
                  - id: 4
                    product_id: 184
                  - id: 5
                    product_id: 183
                - id: 4
                  customer_id: 20
                  name: Christmas
                  is_public: false
                  token: 02d55481-13eb-4d1e-9d79-9062b518570d
                  items:
                  - id: 6
                    product_id: 201
                - id: 5
                  customer_id: 19
                  name: Wish List
                  is_public: false
                  token: 02d55481-13eb-4d1e-9d79-9062b518570d
                  items:
                  - id: 7
                    product_id: 173
                  - id: 8
                    product_id: 176
                meta:
                  pagination:
                    total: 0
                    count: 5
                    per_page: 50
                    current_page: 1
                    total_pages: 0
        '401':
          description: Authentication information is missing or invalid.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
    post:
      tags:
      - Wishlists
      summary: BigCommerce Create a Wishlist
      description: 'Creates a wishlist and wishlist item. More than one item can be added in the POST.


        **Required Fields**

        * name

        * customer_id'
      operationId: createWishlist
      parameters:
      - $ref: '#/components/parameters/Accept'
      - $ref: '#/components/parameters/ContentType'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/wishlist_Post'
        required: true
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/wishlist_Full'
                  meta:
                    type: object
                    properties: {}
                    additionalProperties: true
                    description: Response metadata.
              example:
                data:
                  id: 30
                  customer_id: 10
                  name: Christmas List
                  is_public: true
                  token: d2d55481-13eb-4d1e-9d79-9062b518570d
                  items:
                  - id: 44
                    product_id: 77
                    variant_id: 1
                  - id: 45
                    product_id: 80
                    variant_id: 1
                  - id: 46
                    product_id: 81
                    variant_id: 1
                  - id: 47
                    product_id: 86
                    variant_id: 1
                  - id: 48
                    product_id: 88
                    variant_id: 1
                meta: {}
        '401':
          description: Authentication information is missing or invalid.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
  /wishlists/{wishlist_id}:
    parameters:
    - $ref: '#/components/parameters/WishlistID'
    - $ref: '#/components/parameters/Accept'
    get:
      tags:
      - Wishlists
      summary: BigCommerce Get a Wishlist
      description: Returns a single wishlist.
      operationId: getWishlist
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/wishlist_Full'
                  meta:
                    type: object
                    properties: {}
                    additionalProperties: true
                    description: Response metadata.
              example:
                data:
                  id: 30
                  customer_id: 10
                  name: Christmas List
                  is_public: true
                  token: d2d55481-13eb-4d1e-9d79-9062b518570d
                  items:
                  - id: 44
                    product_id: 77
                    variant_id: 1
                  - id: 45
                    product_id: 80
                    variant_id: 1
                  - id: 46
                    product_id: 81
                    variant_id: 1
                  - id: 47
                    product_id: 86
                    variant_id: 1
                  - id: 48
                    product_id: 88
                    variant_id: 1
                meta: {}
        '401':
          description: Authentication information is missing or invalid.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
        '404':
          description: Wishlist not found.
          content:
            application/json:
              schema:
                type: object
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
    put:
      tags:
      - Wishlists
      summary: BigCommerce Update a Wishlist
      description: 'Updates a wishlist.


        Use this endpoint to update existing wishlist items, change the wishlistʼs name and whether the wishlist is available publicly. To add or delete a wishlist item, see [Wishlist Items](/docs/rest-management/wishlists/wishlists-items).'
      operationId: updateWishlist
      parameters:
      - $ref: '#/components/parameters/ContentType'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/wishlist_Put'
        required: true
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/wishlist_Full'
                  meta:
                    type: object
                    properties: {}
                    additionalProperties: true
                    description: Response metadata.
              example:
                data:
                  id: 30
                  customer_id: 10
                  name: Christmas List
                  is_public: true
                  token: d2d55481-13eb-4d1e-9d79-9062b518570d
                  items:
                  - id: 44
                    product_id: 77
                    variant_id: 1
                  - id: 45
                    product_id: 80
                    variant_id: 1
                  - id: 46
                    product_id: 81
                    variant_id: 1
                  - id: 47
                    product_id: 86
                    variant_id: 1
                  - id: 48
                    product_id: 88
                    variant_id: 1
                meta: {}
        '401':
          description: Authentication information is missing or invalid.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
    delete:
      tags:
      - Wishlists
      summary: BigCommerce Delete a Wishlist
      description: Deletes a wishlist.
      operationId: deleteWishlist
      responses:
        '204':
          description: ''
          content: {}
        '401':
          description: Authentication information is missing or invalid.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                title: Error
                type: object
                properties:
                  status:
                    type: integer
                    format: int32
                  title:
                    type: string
                  type:
                    type: string
components:
  schemas:
    wishlist_Put:
      title: wishlist_Put
      required:
      - customer_id
      - items
      type: object
      properties:
        customer_id:
          type: integer
          description: The customer ID. A read-only value.
          format: int32
        is_public:
          type: boolean
          description: Whether the wishlist is available to the public.
        name:
          type: string
          description: The title of the wishlist.
        items:
          type: array
          description: Array of wishlist items.
          items:
            title: Wishlist item
            type: object
            properties:
              id:
                type: integer
                description: The ID of the item.
                format: int32
                example: 12
              product_id:
                type: integer
                description: The ID of the product.
                format: int32
                example: 55
              variant_id:
                type: integer
                description: The variant ID of the product.
                format: int32
                example: 22
      x-internal: false
    metaCollection:
      title: metaCollection
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/pagination'
      x-internal: false
    wishlist_Post:
      title: wishlist_Post
      required:
      - customer_id
      type: object
      properties:
        customer_id:
          type: integer
          description: The customer id.
          format: int32
          example: 12
        is_public:
          type: boolean
          description: Whether the wishlist is available to the public.
          example: false
        name:
          type: string
          description: The title of the wishlist.
          example: School Shopping
        items:
          type: array
          description: Array of wishlist items.
          items:
            title: Add item to wishlist
            type: object
            properties:
              product_id:
                type: integer
                description: The ID of the product.
                format: int32
                example: 12
              variant_id:
                type: integer
                description: The variant ID of the product.
                format: int32
                example: 152
      x-internal: false
    pagination:
      title: pagination
      type: object
      properties:
        total:
          type: integer
          description: Total number of items in the result set.
          format: int32
        count:
          type: integer
          description: Total number of items in the collection response.
          format: int32
        per_page:
          type: integer
          description: The amount of items returned in the collection per page, controlled by the limit parameter.
          format: int32
        current_page:
          type: integer
          description: The page you are currently on within the collection.
          format: int32
        total_pages:
          type: integer
          description: The total number of pages in the collection.
          format: int32
      description: Data about the response, including pagination and collection totals.
      x-internal: false
    wishlistItem_Full:
      title: wishlistItem_Full
      type: object
      properties:
        id:
          type: integer
          description: The ID of the item.
          format: int32
          example: 12
        product_id:
          type: integer
          description: The ID of the product.
          format: int32
          example: 55
        variant_id:
          type: integer
          description: The variant ID of the product.
          format: int32
          example: 22
      x-internal: false
    wishlist_Full:
      title: wishlist_Full
      type: object
      properties:
        id:
          type: integer
          description: Wishlist ID, provided after creating a wishlist with a POST.
          format: int32
          example: 30
        customer_id:
          type: integer
          description: The ID the customer to which the wishlist belongs.
          format: int32
          example: 12
        name:
          type: string
          description: The name of the wishlist.
          example: Christmas List
        is_public:
          type: boolean
          description: Whether the wishlist is available to the public.
          example: true
        token:
          type: string
          description: The token of the wishlist. This is created internally within BigCommerce. The wishlist ID is to be used for external apps. Read-Only.
          format: uuid
          example: 02d55481-13eb-4d1e-9d79-9062b518570d
        items:
          type: array
          description: Array of wishlist items.
          items:
            $ref: '#/components/schemas/wishlistItem_Full'
      x-internal: false
  parameters:
    Accept:
      name: Accept
      in: header
      required: true
      description: The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of the response body.
      schema:
        type: string
        default: application/json
    ContentType:
      name: Content-Type
      in: header
      required: true
      description: The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of the request body.
      schema:
        type: string
        default: application/json
    WishlistID:
      name: wishlist_id
      in: path
      description: ID of the Wishlist.
      required: true
      schema:
        type: integer
        format: int32
  securitySchemes:
    X-Auth-Token:
      name: X-Auth-Token
      description: '### OAuth scopes


        | UI Name | Permission | Parameter |

        |:--|:--|:-|

        |  Customers | modify | `store_v2_customers` |

        |  Customers | read-only | `store_v2_customers_read_only` |


        ### Authentication header


        | Header | Argument | Description |

        |:-|:|:|

        | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/docs/start/authentication/api-accounts). |


        ### Further reading


        For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/docs/start/authentication#x-auth-token-header-example-requests).


        For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/docs/start/authentication/api-accounts#oauth-scopes).


        For a list of API status codes, see [API Status Codes](/docs/start/about/status-codes).'
      type: apiKey
      in: header