---
title: Asynchronous queries in Segmentation API - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/asynchronous-queries-in-segmentation-api'
  md: 'https://shopify.dev/changelog/asynchronous-queries-in-segmentation-api.md'
metadata:
  effectiveApiVersion: 2023-01
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: true
  createdAt: '2022-12-06T16:39:36-05:00'
  postedAt: '2023-01-01T00:00:00-05:00'
  updatedAt: '2024-12-13T17:24:36-05:00'
  effectiveAt: '2023-01-01T00:00:00-05:00'
---

January 1, 2023

Tags:

* Action Required
* API
* 2023-01

# Asynchronous queries in Segmentation API

Starting in January 2023, on the 2023-01 API release, some queries could be processed and returned asynchronously based on complexity and the amount of shop data. Most queries will continue to be evaluated synchronously. This breaking change allows you to build the best possible user experience as we introduce more complex filters in Segmentation. Async queries should revolve within 5 seconds but some queries might take up to 1-2 minutes or even longer.

To get up to date, make sure you are handling responses returning an error code because the query must be processed asynchronously. You can follow our [migration guide](https://shopify.dev/apps/marketing/customer-segments/async-queries).

Learn more about building for asynchronous queries in our [developer documentation](https://shopify.dev/apps/marketing/customer-segments/manage#query-a-list-of-segment-members) or visit our [API forum for questions](https://community.shopify.com/c/shopify-apis-and-sdks/segmentation-api-now-available/m-p/1465812?shpxid=e26c566f-6B4A-47DC-DF03-62FBBA559D90).