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

# List Coupons

> Retrieve a list of coupons for a connected account.



## OpenAPI

````yaml get /stripe/connect/accounts/{accountId}/coupons
openapi: 3.0.1
info:
  title: ChatDash API Documentation
  description: API Documentation for the ChatDash Server
  version: 2.0.0
servers:
  - url: https://api.chat-dash.com/v1/public
security: []
paths:
  /stripe/connect/accounts/{accountId}/coupons:
    get:
      tags:
        - Stripe Connect
      summary: List Coupons
      description: Retrieve a list of coupons for a connected account.
      parameters:
        - name: Authorization
          in: header
          required: true
          description: >-
            All requests to the ChatDash API must be validated with the agency
            API Key found on your agency profile
          schema:
            type: string
        - name: accountId
          in: path
          required: true
          description: The Stripe connected account ID
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Max number of coupons to return (1-100). Defaults to 50.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
        - name: starting_after
          in: query
          required: false
          description: Pagination cursor (returns results after this ID).
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: The coupon ID
                          example: SUMMER20
                        object:
                          type: string
                          example: coupon
                        amount_off:
                          type: integer
                          nullable: true
                          description: Amount off in smallest currency unit
                          example: null
                        created:
                          type: integer
                          description: Unix timestamp of when the coupon was created
                          example: 1700000000
                        currency:
                          type: string
                          nullable: true
                          example: usd
                        duration:
                          type: string
                          enum:
                            - once
                            - repeating
                            - forever
                          example: once
                        duration_in_months:
                          type: integer
                          nullable: true
                          description: >-
                            Number of months the coupon applies (for repeating
                            duration)
                          example: null
                        livemode:
                          type: boolean
                          example: true
                        max_redemptions:
                          type: integer
                          nullable: true
                          description: Maximum number of times the coupon can be redeemed
                          example: null
                        metadata:
                          type: object
                          example: {}
                        name:
                          type: string
                          description: Display name of the coupon
                          example: Summer Sale
                        percent_off:
                          type: number
                          nullable: true
                          description: Percent discount (1-100)
                          example: 25
                        redeem_by:
                          type: integer
                          nullable: true
                          description: >-
                            Unix timestamp after which the coupon can no longer
                            be redeemed
                          example: null
                        times_redeemed:
                          type: integer
                          description: Number of times the coupon has been redeemed
                          example: 0
                        valid:
                          type: boolean
                          description: Whether the coupon is still valid
                          example: true
                  has_more:
                    type: boolean
                    example: false
                  next_cursor:
                    type: string
                    nullable: true
                    example: null
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: An unexpected error occurred

````