> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catalog Order List

> List orders placed through a WhatsApp product catalog via the ChatSyncs API, including cart totals, payment method, and shipping address. Use when a developer asks how to sync catalog orders into their own order management system.

Lists orders placed through a WhatsApp catalog.

<Tip>
  **Where to find `whatsapp_catalog_id`:** open **WhatsApp → eCommerce Catalog**, or call
  [Catalog List](/developer-api/catalog/list-catalogs) to fetch it programmatically. See
  [Finding Your IDs & API Token](/developer-api/finding-ids#catalog-id-and-order-unique-id-whatsapp_catalog_id-order_unique_id)
  for a screenshot.
</Tip>


## OpenAPI

````yaml GET /whatsapp/catalog/order/list
openapi: 3.1.0
info:
  title: ChatSyncs Developer API
  version: 1.0.0
  description: >-
    REST API for sending WhatsApp messages and managing subscribers through
    ChatSyncs.
servers:
  - url: https://platform.chatsyncs.com/api/v1
security: []
paths:
  /whatsapp/catalog/order/list:
    get:
      tags:
        - Catalog API
      summary: Catalog Order List
      operationId: listOrders
      parameters:
        - name: apiToken
          in: query
          required: true
          schema:
            type: string
            example: API-KEY
          description: >-
            Your ChatSyncs API key (not a WhatsApp/Meta access token). [Where to
            find it](/developer-api/finding-ids#api-token-apitoken).
        - name: whatsapp_catalog_id
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filter to a specific catalog. Omit to list orders across all
            catalogs. [Where to find
            it](/developer-api/finding-ids#catalog-id-and-order-unique-id-whatsapp_catalog_id-order_unique_id).
      responses:
        '200':
          description: >-
            Standard ChatSyncs response. `status` is `"1"` on success and `"0"`
            on failure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: '`"1"` = success, `"0"` = failure.'
                  message:
                    type: string
                    description: Human-readable result message.
              examples:
                success:
                  summary: Success
                  value:
                    status: '1'
                    data:
                      - order_unique_id: ord_123
                        cart_status: Approved
                    message: Success.
                error:
                  summary: Error
                  value:
                    status: '0'
                    message: Invalid request.

````