---
title: "List Pay connectors"
method: GET
path: "/pay_connectors"
tags: ["Pay Connectors"]
---

# List Pay connectors

`GET /pay_connectors`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/pay_connectors`
- Auth: HTTP bearer

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.

## Query parameters

- `page[size]` integer
- `page[after]` string
- `page[before]` string
- `sort` string
- `filter[name]` string
- `filter[type]` string
- `filter[mode]` string
- `filter[created_at][eq]` string
- `filter[created_at][gt]` string
- `filter[created_at][gte]` string
- `filter[created_at][lt]` string
- `filter[created_at][lte]` string
- `filter[updated_at][eq]` string
- `filter[updated_at][gt]` string
- `filter[updated_at][gte]` string
- `filter[updated_at][lt]` string
- `filter[updated_at][lte]` string

## Response `200`

Organization connectors and cursor metadata.

- PayConnectorListResponse
  - `data` PayConnector[]
    - `id` string, uuid: Connector identifier.
    - `name` string: Connector name used for retrieval, update, deletion and Pay.
    - `record_type` 'pay_connector': Resource type.
    - `user_id` string: Creating user; assigned from authentication, not request input.
    - `organization_id` string: Owning organization; assigned from authentication, not request input.
    - `type` string: Connector type; generic is covered by this reference. Other types may appear in unfiltered lists.
    - `mode` 'test' | 'live': Configured mode.
    - `config` object: Redacted stored configuration. Generic connector fields are shown here. Unknown config keys are discarded. Password and token are never returned.
      - `endpoint_url` string: HTTP or HTTPS processor URL with a host. Use HTTPS to protect payment data in transit.
      - `auth_type` 'none' | 'basic' | 'bearer': Stored processor authentication selection. Omitted if it was not explicitly configured.
      - `username` unknown
      - `timeout` integer: Stored processor HTTP timeout in milliseconds. Omitted when no timeout was configured; the effective runtime default is 10000.
    - `created_at` string, date-time: Creation time.
    - `updated_at` string, date-time: Last update time.
  - `meta` object: Cursor pagination metadata. No total_count, page_count or page_number is returned.
    - `page_size` integer: Page size.
    - `start_cursor` string, nullable: Cursor for requesting the preceding page.
    - `end_cursor` string, nullable: Cursor for requesting the following page.

## Other responses

- `422`: Invalid filter, sort or cursor parameters.

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-23** `05f96b352898`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/pay_connectors/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)