---
schema_version: "1"
id: ec6d83e5f88648b4d3d70ffd2d7175c791e5b6712fae11888f0ac57c9ec1fe08
title: SOQLResult
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_tooling/tooling_api_objects_soqlresult.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_soqlresult.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 2242d1192e482e9cd8eee322282d702ab13fc4f8ee9ebaf7a0e38db3196ee127
description: A complex type that represents the result of a SOQL query in an ApexExecutionOverlayResult object. Available from API version 28.0 or later.
---
# SOQLResult

A complex type that represents the result of a SOQL query in an ApexExecutionOverlayResult object. Available from API version 28.0 or later.

## Fields

| Field | Details |
| --- | --- |
| queryError | 
Type

string

Description

The error text returned if the execution was unsuccessful.



 |
| queryMetadata | 

Type

QueryResultMetadata

Description

The structured result returned from a successful execution.

QueryResultMetadata includes the following fields:

- columnMetadata
- entityName
- groupBy
- idSelected
- keyPrefix





 |
| queryResult | 

Type

array of MapValue

Description

MapValue contains an array of MapEntry, which contains the following fields:

- keyDisplayValue
- value (reference to StateValue)





 |

## Usage

Overlay SOQL on checkpoints to capture structured debugging information. If your SOQL query may return more than one record when dealing with complex types, select only one row. For example, you can use a LIMIT=1 clause in your SOQL query, or you can list rows for the user and have them select the row to inspect.