> ## Documentation Index > Fetch the complete documentation index at: https://docs.telnesstech.com/llms.txt > Use this file to discover all available pages before exploring further. # List product catalogs > List all product catalogs with optional text search filtering and pagination. Product catalogs define curated sets of product offerings for specific contexts such as customer segments, regions, or sales channels. ## OpenAPI ````yaml /api-reference/bundled_openapi.json get /product-catalogs 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: /product-catalogs: get: tags: - Product Catalogs summary: List product catalogs description: > List all product catalogs with optional text search filtering and pagination. Product catalogs define curated sets of product offerings for specific contexts such as customer segments, regions, or sales channels. operationId: listProductCatalogs parameters: - in: query name: filter schema: type: string description: Filter by catalog name or ID prefix. - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Cursor' responses: '200': description: A list of product catalogs. content: application/json: schema: type: object required: - items - pagination additionalProperties: false properties: items: type: array items: $ref: '#/components/schemas/ProductCatalogListItem' pagination: $ref: '#/components/schemas/Pagination' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: parameters: Limit: in: query name: limit schema: type: integer minimum: 1 maximum: 1000 default: 100 description: The maximum number of items to return. Cursor: in: query name: cursor schema: type: string description: Opaque pagination token from a previous response's nextCursor. schemas: ProductCatalogListItem: type: object description: > A product catalog defines a curated set of product offerings for a specific context such as customer segment, region, or sales channel. required: - productCatalogId - name - extendsDefault additionalProperties: false properties: productCatalogId: type: string description: Unique identifier for the product catalog. example: f47ac10b-58cc-4372-a567-0e02b2c3d479 name: type: string description: Name of the product catalog. example: US Consumer Catalog description: type: string description: Description of the product catalog. example: Product catalog for US consumer customers extendsDefault: type: boolean description: >- Whether this catalog extends the default product catalog. When true, the catalog inherits all offerings from the default catalog in addition to its own. Pagination: type: object additionalProperties: false properties: nextCursor: type: string nullable: true description: Opaque token for fetching the next page. Null when no more results. 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' TooManyRequests: description: Too many requests have been sent in a given amount of time. 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. ````