> ## Documentation Index
> Fetch the complete documentation index at: https://telnesstech-a0a16404.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List payment profiles for customer

> List saved payment profiles for the customer.



## OpenAPI

````yaml /api-reference/bundled_openapi.json get /payment-profiles
openapi: 3.1.0
info:
  title: Telness Tech Connect
  version: 2.0.0-alpha
  description: >
    Telness Tech Connect API provides all you need to own your user's
    connectivity experience.


    Go back to [Telnesstech.com](https://telnesstech.com)
servers:
  - url: https://apiv2.example.com
    description: Connect API URL for your domain
security:
  - apiKey: []
  - bearerAuth: []
    apiKey: []
tags:
  - name: Auth
    description: Authenticate users and obtain access tokens.
  - name: Users
    description: Manage users.
  - name: Customers
    description: Manage customers.
  - name: Subscriptions
    description: Manage subscriptions and subscription.
  - name: Subscription Addons
    description: Manage subscription addons.
  - name: Subscription Usage
    description: Get subscription usage.
  - name: Subscribers
    description: Manage subscribers.
  - name: Licenses
    description: Manage licenses.
  - name: Product Offerings
    description: Browse product offerings.
  - name: Product Catalogs
    description: Browse product catalogs.
  - name: Product Discounts
    description: Discounts and promotions.
  - name: Orders
    description: Manage orders and line items.
  - name: Payment Intents
    description: >-
      Inspect payment intents, the money collected over card rails for orders
      and renewals.
  - name: Payment Links
    description: Create and manage payment links for orders and invoices.
  - name: Payment Sessions
    description: Create and manage payment sessions for orders.
  - name: Payment Profiles
    description: Manage customer payment profiles and methods.
  - name: Payment Profile Sessions
    description: Create sessions for setting up payment profiles.
  - name: Signing sessions
    description: Handle contract signing sessions for postpaid orders.
  - name: Porting
    description: Manage number porting for subscriptions.
  - name: Taxes
    description: Calculate taxes for products and line items.
  - name: Invoices
    description: Manage invoices and invoice items.
  - name: Tools
    description: >-
      Tools for address validation, number porting, device info, and network
      coverage.
  - name: Inventory
    description: Manage phone number inventory, SIM cards, and reservations.
  - name: Workflows
    description: Dynamic processing of customer journeys and events.
paths:
  /payment-profiles:
    get:
      tags:
        - Payment Profiles
      summary: List payment profiles for customer
      description: List saved payment profiles for the customer.
      operationId: listPaymentProfiles
      parameters:
        - name: customerId
          in: query
          required: true
          description: Filter profiles for a specific customer.
          schema:
            type: string
          example: d0e1f2a3-b4c5-6789-0123-ef0123456789
      responses:
        '200':
          description: Payment profiles retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                additionalProperties: false
                properties:
                  items:
                    type: array
                    description: List of saved payment profiles.
                    items:
                      $ref: '#/components/schemas/EmbeddedPaymentProfile'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    EmbeddedPaymentProfile:
      type: object
      description: >-
        A saved payment method with only the details needed to display it in a
        list, without billing information.
      required:
        - paymentProfileId
        - type
        - status
        - createdAt
      additionalProperties: false
      properties:
        paymentProfileId:
          type: string
          description: Unique identifier for this payment profile.
          example: f6a7b8c9-d0e1-2345-6789-abcdef012345
        paymentProvider:
          $ref: '#/components/schemas/PaymentProvider'
        type:
          $ref: '#/components/schemas/PaymentMethodType'
          description: Type of payment method.
          example: CARD
        status:
          $ref: '#/components/schemas/PaymentProfileStatus'
          description: Current status of the payment profile.
          example: ACTIVE
        displayName:
          type: string
          description: >
            Human-readable name for the payment method, safe to show to the
            customer:

            - Card: "Visa ending in 4242"

            - SEPA: "Bank account ending in 3000"

            - Swish: "Swish +46701234567"
          example: Visa ending in 4242
        isDefault:
          type: boolean
          description: Whether this is the customer's default payment profile.
          example: true
        expiresAt:
          type: string
          format: date
          x-ogen-type: telnesstech.com/apiv2/apiv2types.Date
          description: When this payment profile expires (for cards).
          example: '2025-12-31'
        createdAt:
          type: string
          format: date-time
          description: When this payment profile was created.
          example: '2024-01-15T10:00:00Z'
    PaymentProvider:
      type: string
      description: Payment service provider that processes the transaction.
      enum:
        - STRIPE
        - BILLOGRAM
      example: STRIPE
    PaymentMethodType:
      type: string
      description: >
        The kind of payment method, as reported by the payment provider. This is
        an

        open set of provider-defined values (for example "CARD", "SEPA_DEBIT",
        "SWISH",

        "VIPPS", "KLARNA", "PAYPAL") rather than a fixed enumeration, so new
        method

        types can appear without an API change.
      example: CARD
    PaymentProfileStatus:
      type: string
      description: Status of a saved payment profile.
      enum:
        - ACTIVE
        - INACTIVE
        - EXPIRED
        - REQUIRES_ACTION
    Error:
      type: object
      required:
        - message
        - code
      properties:
        message:
          type: string
          description: A human-readable message providing more details about the error.
        code:
          type: string
          description: A machine-readable code for the error.
        details:
          type: array
          description: Additional details about the error.
          items:
            type: object
            required:
              - message
              - code
            properties:
              message:
                type: string
                description: >-
                  A human-readable message providing more details about the
                  error.
              code:
                type: string
                description: A machine-readable code for the specific detail.
              property:
                type: string
                description: The property or field related to the error.
              suggestion:
                $ref: '#/components/schemas/Any'
                description: >
                  A suggested value for the particular property.


                  For example, this may be set when validating an address with
                  an alias, suggesting the expected value by the operator.
        hint:
          type: string
          description: A hint to help resolve the error.
    Any:
      oneOf:
        - type: string
        - type: number
        - type: boolean
        - type: object
          additionalProperties: true
        - type: array
  responses:
    BadRequest:
      description: The request was malformed or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication is required to access this resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Access to this resource is forbidden.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: An unexpected error occurred on the server.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >
        An API key that grants access to the Connect API. You can create and
        manage API keys in the portal.
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Bearer authentication with JWT tokens is used to authenticate users.


        Do note that a valid API keys is also required to access the Connect API
        to prove that requests are made by a trusted party.


        Requests with a JWT token is scoped to the permissions of the user the
        token belongs to, regardless of the API key used.

````

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