conduktor.io ↗

Kafka ReadShareGroupStateSummary Response Wire Format v1 — Binary Protocol Layout

What is ReadShareGroupStateSummary?

Reads only the epoch and start offset without fetching full delivery state, for lightweight coordination checks. The coordinator uses this to quickly verify state consistency without the overhead of a full ReadShareGroupState, particularly during startup and failover.

Related Errors

CLUSTER_AUTHORIZATION_FAILED · COORDINATOR_NOT_AVAILABLE

Wire Diagram

Response Header · flexible
message_size int32 · 4B
correlation_id int32 · 4B
tagged var
ReadShareGroupStateSummaryResponse v1
Results array
tagged var
TopicId uuid · 16B
Partitions array
tagged var
Partition int32 · 4B
ErrorCode int16 · 2B
ErrorMessage? string (compact)
StateEpoch int32 · 4B
LeaderEpoch int32 · 4B
StartOffset int64 · 8B
DeliveryCompleteCount int32 · 4B
tagged var

Schema & Example

Schema
{
  "Results": [{
      "TopicId": uuid,
      "Partitions": [{
          "Partition": int32,
          "ErrorCode": int16,
          "ErrorMessage": string?,
          "StateEpoch": int32,
          "LeaderEpoch": int32,
          "StartOffset": int64,
          "DeliveryCompleteCount": int32
      }]
  }]
}
Example
{
  "Results": [{
      "TopicId": "550e8400-e29b-41d4-a716-446655440000",
      "Partitions": [{
          "Partition": 0,
          "ErrorCode": 0,
          "ErrorMessage": null,
          "StateEpoch": 12,
          "LeaderEpoch": 17,
          "StartOffset": 150382,
          "DeliveryCompleteCount": 10
      }]
  }]
}