POST /api/v2/query

Use the POST endpoint of Query API V2 to make the first request with the SQL query. The POST endpoint returns data along with batchId for the next batch.

HTTP Method: POST
Availability: Data Cloud v2.0, Salesforce 54.0
format: REST
URI: /api/v2/query

The request body must contain a JSON object with these fields:

Field Name	Field Type	Description
sql	string	The SQL query to execute. Must be a valid ANSI standard SQL query.

The response includes:

data: Array of record objects containing the requested data
startTime: ISO 8601 timestamp indicating when the query started executing
endTime: ISO 8601 timestamp indicating when the query finished executing
rowCount: Number of rows returned by the query
queryId: Unique identifier for the query
nextBatchId: Identifier for the next batch of results
done: boolean indicating if all results have been returned
metadata: Object containing metadata about the fields in the result set

The metadata object contains information about each field on the result set:

Field Name	Field Type	Description
type	string	SQL data type of the field
placeInOrder	integer	Position of the field on the result set
typeCode	integer	Numeric code representing the SQL data type

The maximum number of rows returned is 49,999
Use the done flag to determine if more results are available
When done is false, use the nextBatchId to retrieve the next set of records
The API supports ANSI standard SQL queries
All queries are executed synchronously
The API supports cursor-based pagination via nextBatchId
You must fetch the complete result set within one hour
The time interval between batch calls must not exceed three minutes