> ## 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.

# Get Paywint Card

> Fetches a specific Payee's Paywint Card request by its unique request ID.

This endpoint retrieves the details of a specific paywint card request issued by the authenticated account,
including associated card details when available (for approved requests).

If the paywint card has been approved, the last 4 digits of the card number will be included (masked with leading `**`).

Parameters:
- `request_id`: The unique identifier for the Paywint Card request to fetch.

Returns:
- Full details of the requested paywint card, including status, linked card information (if applicable), and other related details.



## OpenAPI

````yaml GET /api/user-api/card/payee/pw-card/issued/{request_id}
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/{request_id}:
    get:
      tags:
        - Developer API card
      summary: Get issued Paywint Card request
      description: >-
        Fetches a specific Payee's Paywint Card request by its unique request
        ID.


        This endpoint retrieves the details of a specific paywint card request
        issued by the authenticated account,

        including associated card details when available (for approved
        requests).


        If the paywint card has been approved, the last 4 digits of the card
        number will be included (masked with leading `**`).


        Parameters:

        - `request_id`: The unique identifier for the Paywint Card request to
        fetch.


        Returns:

        - Full details of the requested paywint card, including status, linked
        card information (if applicable), and other related details.
      operationId: >-
        get_issued_paywint_card_api_user_api_card_payee_pw_card_issued__request_id__get
      parameters:
        - name: request_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: >-
              The unique identifier for the specific Paywint Card request. This
              ID is assigned when the paywint card request is created, and can
              be used to retrieve details of an issued or pending request.
            title: Request Id
          description: >-
            The unique identifier for the specific Paywint Card request. This ID
            is assigned when the paywint card request is created, and can be
            used to retrieve details of an issued or pending request.
          example: f47ac10b-9b8e-4a3e-91d2-0e02b2c3d479
        - 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/CommonResponse_ExternalIssuedPaywintGiftCardRead_
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CommonResponse_ExternalIssuedPaywintGiftCardRead_:
      properties:
        success:
          type: boolean
          title: Success
          description: Indicates whether the request was processed successfully.
          default: true
          example: true
        message:
          type: string
          title: Message
          description: >-
            A short, human-readable message describing the result of the
            request.
          default: Success
          example: Operation completed.
        data:
          anyOf:
            - $ref: '#/components/schemas/ExternalIssuedPaywintGiftCardRead'
            - type: 'null'
          description: The main response payload, if applicable
        queryGeneratedTime:
          anyOf:
            - type: number
            - type: 'null'
          title: Querygeneratedtime
          description: >-
            The Unix timestamp (in seconds) indicating when the response was
            generated.
          default: 1778161546.973489
          example: 1718006400
      type: object
      title: CommonResponse[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

````