Mirror of <https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/query-api-v3-get-metadata.html> (Salesforce, Data 360 Query Guide), read 2026-10-23. Salesforce's own page is the authority; this copy exists because that site refuses non-browser readers.

Use the GET /api/v3/query/{queryId}/metadata endpoint of the Data 360 Query API to retrieve the output schema for a completed query without fetching data rows. Use this endpoint to inspect column names, types, and nullability before retrieving a large result set, or to validate query output structure in your integration.

HTTP Method: GET
Format: REST
URI: /api/v3/query/{queryId}/metadata

Parameter	Type	Description
`queryId`	string	Required. The unique identifier of the query returned from `POST /api/v3/query`. Example: `MTAuMjcuMTgxLjE0OTo3NDg0_1cfc8d35`.

Header	Value
`Authorization`	`Bearer {accessToken}`
`Accept`	`application/json` or `application/vnd.apache.arrow.stream`

Field	Description
`metadata`	Object containing column schema information

This example shows a metadata retrieval request and response.

Set Accept: application/vnd.apache.arrow.stream to receive the Arrow schema as a binary IPC stream.

This endpoint returns the schema only and does not return data rows.
Does not support waitFor query parameters.
Does not return query info in response headers.