---
title: "system.kafka.pollTopic"
description: "Returns a list of records from the specified topic."
---

# system.kafka.pollTopic

> Returns a list of records from the specified topic.

This function is used in **Python Scripting**.

## Description
## Client Permission Restrictions
This scripting function has no [Client Permission](ignition-modules\vision\vision-project-properties\vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax
`system.kafka.pollTopic(connector, topic, groupId, [options], sizeCutoff, timeoutMs)`

### Parameters

| Type | Parameter | Description |
|---|---|---|
| String | `connector` | The name of the Kafka connector. |
| String | `topic` | The name of the Kafka topic. |
| String | `groupId` | The unique string of the consumer group the consumer belongs to. |
| Dictionary | `options` | Custom options specific to the consumer, with key value string pairs. Optional. |
| Integer | `sizeCutoff` |  The total record count allowed before polling will be stopped. |
| Long | `timeoutMs` |  The amount of time in milliseconds before polling will be stopped. |
    
### Returns
**List** - A list of records from the specified topic.
    
### Scope
Gateway

## Code Examples
```python title="Example #1"
# Returns a list of records from the specified topic.

system.kafka.pollTopic("MyKafkaConnector", "MyKafkaTopic", "consumer-group-one")
```