Description

Query object data based on specified conditions and return only a single record.

Request Specification

HTTP Method: POST + application/json

Request Path: https://${Cloud Domain}/cgi/crm/custom/v2/data/findOne?thirdTraceId=${Random String}

Request Headers: Refer to Common Parameters

Request Parameters

Parameter	Type	Required	Description
data	Map	Yes	Data map
dataObjectApiName	String	Yes	Object API name
search_query_info	Map	Yes	Query conditions
field_projection	List	Yes	Fields to include in response. Returns all fields if empty. Calculated fields, statistical fields, and reference fields won't be computed in real-time if specified

Request Example

{
  "data": {
    "search_query_info": {},
    "dataObjectApiName": "",
    "field_projection": []
  }
}

Response Parameters

Parameter	Type	Description
traceId	string	Unique request ID
errorDescription	string	Error description
errorMessage	string	Error message
errorCode	Int	Error codes reference

Response Example

{
  "traceId": "E-O.827xxxxxx",
  "errorDescription": "success",
  "errorMessage": "OK",
  "errorCode": 0
}

Notes

• Do not use the message field in the response for logical judgments, as errorMessage may change.