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

# List Pay connectors

> List connectors belonging to the authenticated organization, including connectors created by other users in that organization. Set filter[type]=generic to restrict results to the type covered here. Results default to newest created_at first. Use meta.end_cursor as page[after] for the next page, or meta.start_cursor as page[before] for the preceding page. Omit both cursors for the first page; if both are supplied, page[after] takes precedence. Responses omit passwords and tokens.



## OpenAPI

````yaml /openapi/source/external/call-control/pay-connectors.json get /pay_connectors
openapi: 3.1.0
info:
  title: Telnyx Pay Connectors API
  version: 2.0.0
  x-latency-category: responsive
  x-endpoint-cost: light
  description: >-
    Manage generic Pay connectors. This reference covers generic processor
    configuration only. Use a Telnyx API key for these endpoints; config
    authentication applies separately to requests sent to the payment processor.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  contact:
    email: support@telnyx.com
servers:
  - url: https://api.telnyx.com/v2
security:
  - bearerAuth: []
tags:
  - name: Pay Connectors
    description: Generic payment connector configuration.
paths:
  /pay_connectors:
    get:
      tags:
        - Pay Connectors
      summary: List Pay connectors
      description: >-
        List connectors belonging to the authenticated organization, including
        connectors created by other users in that organization. Set
        filter[type]=generic to restrict results to the type covered here.
        Results default to newest created_at first. Use meta.end_cursor as
        page[after] for the next page, or meta.start_cursor as page[before] for
        the preceding page. Omit both cursors for the first page; if both are
        supplied, page[after] takes precedence. Responses omit passwords and
        tokens.
      operationId: listPayConnectors
      parameters:
        - name: page[size]
          in: query
          description: Number of records per page.
          schema:
            type: integer
            minimum: 1
            maximum: 249
            default: 25
        - name: page[after]
          in: query
          description: Opaque cursor from meta.end_cursor.
          schema:
            type: string
        - name: page[before]
          in: query
          description: Opaque cursor from meta.start_cursor.
          schema:
            type: string
        - name: sort
          in: query
          description: >-
            Comma-separated created_at or updated_at fields, optionally prefixed
            with - for descending order.
          schema:
            type: string
            default: '-created_at'
            example: '-created_at'
        - name: filter[name]
          in: query
          description: Exact match on name.
          schema:
            type: string
            example: my-payment-connector
        - name: filter[type]
          in: query
          description: Exact match on type.
          schema:
            type: string
            example: generic
        - name: filter[mode]
          in: query
          description: Exact match on mode.
          schema:
            type: string
            example: test
        - name: filter[created_at][eq]
          in: query
          description: Equal to this created_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[created_at][gt]
          in: query
          description: After this created_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[created_at][gte]
          in: query
          description: At or after this created_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[created_at][lt]
          in: query
          description: Before this created_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[created_at][lte]
          in: query
          description: At or before this created_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[updated_at][eq]
          in: query
          description: Equal to this updated_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[updated_at][gt]
          in: query
          description: After this updated_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[updated_at][gte]
          in: query
          description: At or after this updated_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[updated_at][lt]
          in: query
          description: Before this updated_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
        - name: filter[updated_at][lte]
          in: query
          description: At or before this updated_at timestamp.
          schema:
            type: string
            example: '2026-10-01T00:00:00Z'
      responses:
        '200':
          description: Organization connectors and cursor metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PayConnectorListResponse'
              example:
                data: []
                meta:
                  page_size: 25
                  start_cursor: null
                  end_cursor: null
        '422':
          description: Invalid filter, sort or cursor parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PayConnectorErrors'
              example:
                errors:
                  - code: '10000'
                    title: Invalid request
                    detail: Provided cursor is invalid.
                    source:
                      pointer: /after
components:
  schemas:
    PayConnectorListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PayConnector'
        meta:
          type: object
          description: >-
            Cursor pagination metadata. No total_count, page_count or
            page_number is returned.
          properties:
            page_size:
              type: integer
              description: Page size.
            start_cursor:
              type:
                - string
                - 'null'
              description: Cursor for requesting the preceding page.
            end_cursor:
              type:
                - string
                - 'null'
              description: Cursor for requesting the following page.
    PayConnectorErrors:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
                description: Telnyx error code.
              title:
                type: string
                description: Error title.
              detail:
                type: string
                description: Error detail.
              source:
                type: object
                properties:
                  pointer:
                    type: string
                    description: Invalid field pointer.
    PayConnector:
      type: object
      description: >-
        Organization-owned connector. Examples and config properties here
        describe generic connectors; listing is not restricted to that type
        unless filter[type]=generic is supplied. Passwords and bearer tokens are
        omitted, not masked. Defaults for auth_type and timeout need not appear
        in stored config.
      properties:
        id:
          type: string
          description: Connector identifier.
          format: uuid
        name:
          type: string
          description: Connector name used for retrieval, update, deletion and Pay.
        record_type:
          type: string
          description: Resource type.
          enum:
            - pay_connector
        user_id:
          type: string
          description: Creating user; assigned from authentication, not request input.
        organization_id:
          type: string
          description: >-
            Owning organization; assigned from authentication, not request
            input.
        type:
          type: string
          description: >-
            Connector type; generic is covered by this reference. Other types
            may appear in unfiltered lists.
        mode:
          type: string
          enum:
            - test
            - live
          description: Configured mode.
        config:
          type: object
          description: >-
            Redacted stored configuration. Generic connector fields are shown
            here. Unknown config keys are discarded. Password and token are
            never returned.
          properties:
            endpoint_url:
              type: string
              description: >-
                HTTP or HTTPS processor URL with a host. Use HTTPS to protect
                payment data in transit.
              pattern: ^https?://\S+
              example: https://processor.example.com/pay
            auth_type:
              type: string
              description: >-
                Stored processor authentication selection. Omitted if it was not
                explicitly configured.
              enum:
                - none
                - basic
                - bearer
            username:
              description: >-
                Stored username, when supplied. Required to be a nonblank string
                for basic authentication.
            timeout:
              type: integer
              minimum: 1
              maximum: 4294967295
              description: >-
                Stored processor HTTP timeout in milliseconds. Omitted when no
                timeout was configured; the effective runtime default is 10000.
        created_at:
          type: string
          description: Creation time.
          format: date-time
        updated_at:
          type: string
          description: Last update time.
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Telnyx API key, not the processor bearer token.

````