STOQ - Developer Documentation
  • Getting Your STOQ API Key
  • Back in Stock API
    • List and filter Intents
    • Get a specific Intent
    • Notify a single Intent
    • Notify multiple intents in bulk
  • JavaScript API
  • Preorder Metafields
    • Shop Level Metafields
    • Product Variant Level Metafields
Powered by GitBook
On this page
Export as PDF
  1. Back in Stock API

List and filter Intents

PreviousBack in Stock APINextGet a specific Intent

Last updated 26 days ago

List and filter intents

get
Authorizations
Query parameters
shopify_variant_idintegerOptional

Filter by Shopify Variant ID

shopify_product_idintegerOptional

Filter by Shopify Product ID

emailstringOptional

Filter by customer email

phonestringOptional

Filter by customer phone

start_datestring · dateOptional

Filter by start date (YYYY-MM-DD)

end_datestring · dateOptional

Filter by end date (YYYY-MM-DD)

pageintegerOptional

Page number for pagination

per_pageintegerOptional

Number of items per page

Header parameters
X-Auth-TokenstringRequired

API key for authentication

Responses
200
A paginated list of intents
application/json
400
Bad request
401
Unauthorized
get
GET /api/v1/external/intents HTTP/1.1
Host: app.stoqapp.com
X-Auth-Token: text
Accept: */*
{
  "intents": [
    {
      "id": "text",
      "blocked_at": "2025-06-03T04:34:18.350Z",
      "channel": "text",
      "email": "text",
      "notified_at": "2025-06-03T04:34:18.350Z",
      "optin_confirmed": true,
      "phone": "text",
      "quantity": 1,
      "sent_notifications_count": 1,
      "source": "text",
      "type": "text",
      "unsubscribed_at": "2025-06-03T04:34:18.350Z",
      "created_at": "2025-06-03T04:34:18.350Z",
      "updated_at": "2025-06-03T04:34:18.350Z",
      "customer_id": "text",
      "intent_trigger_id": "text",
      "product_variant_id": "text",
      "shop_id": "text",
      "shopify_inventory_item_id": 1,
      "shopify_market_id": 1,
      "shopify_product_id": 1,
      "shopify_variant_id": 1,
      "customer_name": "text",
      "contact": "text",
      "customer_unsubscribed_at": "2025-06-03T04:34:18.350Z",
      "accepts_marketing": true,
      "notifications_count": 1
    }
  ],
  "meta": {
    "total_count": 1,
    "page": 1,
    "per_page": 1,
    "total_pages": 1
  }
}