---
schema_version: "1"
id: df77a95c3a48959813ca97438b7bdebdc8efcc4887882c3d9528374635c1d0c8
title: Query Options Header
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/api-rest/guides/headers/headers-queryoptions.md
canonical_url: https://developer.salesforce.com/docs/platform/api-rest/guide/headers-queryoptions.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 641cee47efc8103e4dc94af18425d06e50a1db375c7c02fb458c63ffa8a2be39
products:
  - REST API Developer Guide
  - Platform Developer Content
---

# Query Options Header

Specifies options used in a query, such as the query results batch size. Use this request header with the Query resource.

## Header Field Name and Values

-   **Field name**: `Sforce-Query-Options`
-   **Field values**:

    -   `batchSize`—A numeric value that specifies the number of records returned for a query request. Child objects count toward the number of records for the batch size. For example, in relationship queries, multiple child objects are returned per parent row returned.

        The default is 2,000; the minimum is 200, and the maximum is 2,000. There is no guarantee that the requested batch size is the actual batch size. Changes are made as necessary to maximize performance.

-   **Example**: `Sforce-Query-Options: batchSize=1000`