---
schema_version: "1"
id: 331403071e96504ab85942e5a003c8fe85fb58b4c3fcce9f108724f99c225927
title: Queries
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/semantic-layer/references/generated-api-specs/queries-operations-2.md
canonical_url: https://developer.salesforce.com/docs/data/semantic-layer/references/queries-operations-2
source_site: developer.salesforce.com
content_type: documentation
content_hash: 6f5e57bb500809a0d84c3325b222391fe4bd5a2b45b9c0002ab89ec65b6f440c
products:
  - Tableau Semantics Layer APIs
  - Data 360 Developer Documentation
---
Queries

# Queries

The Tableau Semantics Query API enables you to execute semantic queries to answer a wide range of business questions.

**Version:** v65.0

## Servers

*   `/services/data/v65.0`

## Operations

### POST postSemanticQueryExecute

`POST /semantic-engine/gateway`

Operation ID: `postSemanticQueryExecute`. Tags: Queries.

Executes a semantic query

#### Request body

Media type: `application/json`. Schema: `SemanticQueryRequest`.

#### Responses

*   **200** Success
    
    Media type: `application/json`. Schema: `SemanticQueryResponse`.
    
*   **400** Bad Request
    
    Media type: `application/json`. Schema: `SemanticQueryErrorResponse`.
    

## Schemas

### SemanticQueryRequest

Input representation for creating Semantic Query

*   `dataspace` (_string_) Data space
*   `source` (_string_) source
*   `structuredSemanticQuery` (_object_) structuredSemanticQuery
*   `semanticModel` (_object_) semanticModel

_Example_

```
{
  "dataspace": "default",
  "source": "source",
  "structuredSemanticQuery": {
    "fields": [
      {
        "expression": {
          "table_field": {
            "name": "Account Name",
            "table_name": "AccountSemanticLayer__dll"
          }
        }
      },
      {
        "expression": {
          "table_field": {
            "name": "Annual Revenue",
            "table_name": "AccountSemanticLayer__dll"
          }
        }
      }
    ],
    "options": {
      "limit_options": {
        "limit": 10
      }
    },
    "semanticModel": {
      "apiName": "SalesSDM",
      "label": "SalesSDM",
      "semanticDataObjects": [
        {
          "apiName": "Sales_SDO",
          "label": "Sales_SDO",
          "dataObjectName": "Sales__dll",
          "dataObjectType": "Dmo",
          "semanticDimensions": [
            {
              "apiName": "Account Name",
              "label": "Account Name",
              "dataType": "Text",
              "dataObjectFieldName": "AccountName__c"
            },
            {
              "apiName": "Annual Revenue",
              "label": "Annual Revenue",
              "dataType": "Number",
              "dataObjectFieldName": "AnnualRevenue__c"
            }
          ]
        }
      ]
    }
  }
}
```

### SemanticQueryResponse

Represents Semantic Engine query output

*   `queryResults` (_object_) Query Results
    *   `queryMetadata` (_object_)
        *   `fields` (_object_) fields in the results table
    *   `queryData` (_object_)
        *   `rows` (_object_) response data
*   `status` (_string_) Status ENUM

_Example_

```
{
  "queryResults": {
    "queryMetadata": {
      "fields": {
        "Account Name": {
          "placeInOrder": 0,
          "type": "VARCHAR"
        },
        "Annual Revenue": {
          "placeInOrder": 1,
          "type": "NUMERIC"
        }
      }
    },
    "queryData": {
      "rows": [
        {
          "values": [
            "Ms. Penny Haley PhD",
            89617
          ]
        },
        {
          "values": [
            "Edwin Day MD",
            59040
          ]
        },
        {
          "values": [
            "Mr. Jim Watkins",
            92956
          ]
        }
      ]
    }
  },
  "status": "SUCCESS"
}
```

### SemanticQueryErrorResponse

Represents Response with an error

*   `errorCode` (_string_) The error code
*   `message` (_string_) The message

_Example_

```
{
  "errorCode": "INVALID_API_INPUT",
  "message": "An error occurred in Semantic Layer. TraceId: bc7c380f3a62d44c06e4f9ed3bfe0516 Status: INVALID_ARGUMENT Error Message: INVALID_ARGUMENT: {\"message\":\"The field ffef does not exist in table AccountSemanticLayer__dll. Queryable fields are: AnnualRevenue__c,Annual Revenue,CreatedDate__c\",\"error_code\":\"USER_ILLEGAL_ARGUMENT_RESOLVE_ENTITY_ERROR\"}"
}
```