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

# Account List

> List the stores a buyer has a connected login at, and whether each still signs in (`failed` once the store would not). Never returns a username or a password. The buyer goes in the body, not the URL, so their email stays out of URL logs.



## OpenAPI

````yaml /v1/api-reference/openapi.documented.json post /account/list
openapi: 3.1.0
info:
  title: Henry Labs API
  version: 1.18.0
  description: Playground for Henry Labs API endpoints
  contact:
    name: Henry Labs API Support
    email: support@henrylabs.ai
servers:
  - url: https://api.henrylabs.ai/v1
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Product
    description: Product search, details, and data enrichment
  - name: Cart
    description: Universal user shopping cart management
  - name: Orders
    description: Order management post purchase
  - name: Merchants
    description: Merchant information and status
  - name: Card
    description: Card tokenization and management
  - name: Account
    description: Buyers' own logins at stores that check out on customers' own accounts
paths:
  /account/list:
    post:
      tags:
        - Account
      summary: Account List
      description: >-
        List the stores a buyer has a connected login at, and whether each still
        signs in (`failed` once the store would not). Never returns a username
        or a password. The buyer goes in the body, not the URL, so their email
        stays out of URL logs.
      operationId: accountList
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/accountListInput'
      responses:
        '200':
          description: The buyer's connected logins
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/accountListResponse'
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  status:
                    type: string
                  message:
                    type: string
                required:
                  - success
                  - status
                  - message
                additionalProperties: false
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  status:
                    type: string
                  message:
                    type: string
                required:
                  - success
                  - status
                  - message
                additionalProperties: false
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import HenrySDK from '@henrylabs/sdk';


            const client = new HenrySDK({
              apiKey: process.env['HENRY_SDK_API_KEY'], // This is the default and can be omitted
            });


            const accounts = await client.account.list({ buyerEmail:
            'jane@example.com' });


            console.log(accounts.data);
components:
  schemas:
    accountListInput:
      type: object
      properties:
        buyerEmail:
          type: string
          format: email
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
          description: The buyer whose connected logins to list.
          example: jane@example.com
      required:
        - buyerEmail
    accountListResponse:
      type: object
      properties:
        success:
          type: boolean
        status:
          type: string
        message:
          type: string
        data:
          type: object
          properties:
            accounts:
              type: array
              items:
                $ref: '#/components/schemas/connectedAccount'
              description: The buyer's connected logins, newest first.
          required:
            - accounts
          additionalProperties: false
      required:
        - success
        - status
        - message
        - data
      additionalProperties: false
    connectedAccount:
      type: object
      properties:
        merchantHost:
          type: string
          description: The store the login is for.
          example: uniqlo.com
        buyerEmail:
          type: string
          description: The buyer the login belongs to, lowercased.
          example: jane@example.com
        status:
          type: string
          enum:
            - connected
            - failed
            - disconnected
          description: >-
            `connected`: purchases for this buyer at this store sign in with it.
            `failed`: the store would not sign in with it (the password was
            rejected, the account is locked, or the store asked for a check only
            the buyer can complete), so purchases there are refused until you
            connect the login again. `disconnected`: it was removed and erased,
            and is no longer used.
          example: connected
        connectedAt:
          type: string
          description: When the login was first connected (ISO 8601).
          example: '2026-11-12T23:00:00.000Z'
      required:
        - merchantHost
        - buyerEmail
        - status
        - connectedAt
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.