# API reference

This section reorganizes the Pinot API surface into broker query APIs, query response formatting, controller admin APIs, controller API examples, and broker gRPC. The goal is to keep the overview light while still documenting the endpoint-level behavior operators and client authors need.

## Reference Map

| Area                    | Use it for                                                         | Source page                                                                                          |
| ----------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| Broker query API        | SQL query submission, broker cursors, and response-store lifecycle | [Broker Query API](https://docs.pinot.apache.org/reference/api-reference/query-api)                  |
| Query response format   | Response fields and cursor payload structure                       | [Query Response Format](https://docs.pinot.apache.org/reference/api-reference/query-response-format) |
| Controller admin API    | Swagger UI walkthrough for cluster and table administration        | [Controller Admin API](https://docs.pinot.apache.org/reference/api-reference/controller-admin-api)   |
| Controller API examples | Endpoint families and representative admin requests                | [Controller API Examples](https://docs.pinot.apache.org/reference/api-reference/controller-api)      |
| Broker gRPC             | gRPC query transport and client configuration                      | [Broker gRPC API](https://docs.pinot.apache.org/reference/api-reference/broker-grpc-api)             |

## What this page covered

* The main Pinot API surfaces and their intended use.
* Which pages in this subtree contain endpoint-level detail.
* Where to go for query, controller, and gRPC reference material.

## Next step

Pick the API family you need, then cross-check the request and response examples against the component you are targeting.

## Related pages

* [Broker Query API](https://docs.pinot.apache.org/reference/api-reference/query-api)
* [Query Response Format](https://docs.pinot.apache.org/reference/api-reference/query-response-format)
* [Controller Admin API](https://docs.pinot.apache.org/reference/api-reference/controller-admin-api)
* [Controller API Examples](https://docs.pinot.apache.org/reference/api-reference/controller-api)
* [Broker gRPC API](https://docs.pinot.apache.org/reference/api-reference/broker-grpc-api)