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

# List Paywint Cards

> Returns a list of Payee's Paywint Cards issued by the user.

This endpoint retrieves all paywint card requests created by the issuing account,
including associated card details when available.

For approved paywint card requests, the last 4 digits of the card number are provided
in the response, with leading `**` to mask the full number. Example: `**1234`.

Each record includes:

- Payee's paywint card request information
- Current status
- Initial funded amount
- Payee details
- Linked card details (if approved)



## OpenAPI

````yaml GET /api/user-api/card/payee/pw-card/issued
openapi: 3.1.0
info:
  title: paywint
  version: 0.1.0
servers:
  - url: https://api.sandbox.paywint.com
  - url: https://api.paywint.com
security: []
paths:
  /api/user-api/card/payee/pw-card/issued:
    get:
      tags:
        - Developer API card
      summary: List issued Paywint Cards for Payee
      description: >-
        Returns a list of Payee's Paywint Cards issued by the user.


        This endpoint retrieves all paywint card requests created by the issuing
        account,

        including associated card details when available.


        For approved paywint card requests, the last 4 digits of the card number
        are provided

        in the response, with leading `**` to mask the full number. Example:
        `**1234`.


        Each record includes:


        - Payee's paywint card request information

        - Current status

        - Initial funded amount

        - Payee details

        - Linked card details (if approved)
      operationId: list_issued_paywint_cards_api_user_api_card_payee_pw_card_issued_get
      parameters:
        - name: X-Api-Key
          in: header
          required: true
          schema:
            type: string
            description: >-
              Your API Key (UUID format). Required to identify and authorize
              each request
            title: X-Api-Key
          description: >-
            Your API Key (UUID format). Required to identify and authorize each
            request
        - name: X-Api-Secret
          in: header
          required: true
          schema:
            type: string
            description: >-
              Secret associated with your API Key. Used for authenticating
              requests. Keep this secure.
            title: X-Api-Secret
          description: >-
            Secret associated with your API Key. Used for authenticating
            requests. Keep this secure.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ExternalListResponse_ExternalIssuedPaywintGiftCardRead_
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ExternalListResponse_ExternalIssuedPaywintGiftCardRead_:
      properties:
        success:
          type: boolean
          title: Success
          description: Indicates whether the request was processed successfully.
          default: true
          example: true
        status_code:
          anyOf:
            - type: integer
            - type: 'null'
          title: Status Code
          description: HTTP status code representing the result of the request.
          default: 200
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
          description: Short, human-readable message describing the outcome of the request.
          default: Success
        records:
          anyOf:
            - items:
                $ref: '#/components/schemas/ExternalIssuedPaywintGiftCardRead'
              type: array
            - type: 'null'
          title: Records
          description: List of result items returned for the current page.
        totalRecords:
          anyOf:
            - type: integer
            - type: 'null'
          title: Totalrecords
          description: >-
            Total number of matching records in the database, useful for
            paginating the full dataset.
          default: 0
        queryGeneratedTime:
          anyOf:
            - type: integer
            - type: 'null'
          title: Querygeneratedtime
          description: >-
            Unix timestamp (in seconds) indicating when this response was
            generated.
          default: 1778161546
      type: object
      title: ExternalListResponse[ExternalIssuedPaywintGiftCardRead]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ExternalIssuedPaywintGiftCardRead:
      properties:
        payee_id:
          type: string
          format: uuid
          title: Payee Id
          description: >-
            The unique identifier of the payee associated with this Paywint Card
            request.
          example: c9b1f3b2-8d9a-4f1b-a9e5-6a77f0b12345
        request_id:
          type: string
          format: uuid
          title: Request Id
          description: Unique identifier for the Paywint Card request.
          example: f24a8e7c-7f2b-4f39-bc5d-98e01a123456
        card_nick_name:
          type: string
          title: Card Nick Name
          description: The nickname assigned to the Paywint Card.
          example: Employee Performance Bonus
        amount:
          type: number
          title: Amount
          description: The initial funded amount loaded onto the Paywint Card in USD.
          example: 150
        status:
          $ref: '#/components/schemas/CardApprovalStatus'
          description: >-
            Current lifecycle status of the card request. Possible values are
            `pending`, `approved`, `rejected`, or `issued`.
          example: approved
        payee_card_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Payee Card Id
          description: >-
            Unique Identifier for the Payee's Paywint Card. This is only
            provider for approved card requests.
          example: f24a8e7c-7f2b-4f39-bc5d-98e01a123456
        card_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Card Number
          description: >-
            The last 4 digits of the issued Paywint Card, with leading `**` to
            mask the full number. This is only provided for approved card
            requests.
          example: '**5426'
        first_name:
          type: string
          title: First Name
          description: First name on the Paywint Card.
          example: Michael
        last_name:
          type: string
          title: Last Name
          description: Last name on the Paywint Card.
          example: Anderson
        address_line:
          type: string
          title: Address Line
          description: Billing address line from the payee’s default address.
          example: 742 Evergreen Terrace
        city:
          type: string
          title: City
          description: Billing city of the payee.
          example: Austin
        state:
          type: string
          title: State
          description: Billing state or region of the payee.
          example: TX
        zip:
          type: string
          title: Zip
          description: Billing ZIP or postal code of the payee.
          example: '78701'
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
          description: Billing country (ISO 3166-1 alpha-2 format).
          example: US
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Timestamp in ISO 8601 UTC format when the card request was created.
          example: '2026-02-12T10:15:30Z'
      type: object
      title: ExternalIssuedPaywintGiftCardRead
      example:
        address_line: 742 Evergreen Terrace
        amount: 150
        card_nick_name: Employee Performance Bonus
        card_number: '**5426'
        city: Austin
        country: US
        created_at: '2026-02-12T10:15:30Z'
        first_name: Michael
        last_name: Anderson
        payee_card_id: f24a8e7c-7f2b-4f39-bc5d-98e01a123456
        payee_id: c9b1f3b2-8d9a-4f1b-a9e5-6a77f0b12345
        request_id: f24a8e7c-7f2b-4f39-bc5d-98e01a123456
        state: TX
        status: approved
        zip: '78701'
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    CardApprovalStatus:
      type: string
      enum:
        - initiated
        - payment_processing
        - payment_failed
        - pending
        - approved
        - activating
        - auto_approved
        - rejected
      title: CardApprovalStatus

````