Get SQL Query Metadata
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
waitForquery parameters. - Does not return query info in response headers.