---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# getKeys

# getKeys {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Query the targeted table by example values and return a comma delimited
`sys_id` list.

## Input fields

Any field value in the targeted table.

## Output fields

A SOAP response element sys_id that contains a comma delimited list of
[Unique record identifier (sys_id)](https://www.servicenow.com/docs/access?context=c_UniqueRecordIdentifier&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) values.

## Sample SOAP messages

Sample SOAP request  

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:inc="http://www.service-now.com/incident">
       <soapenv:Header/>
       <soapenv:Body>
          <inc:getKeys>
             <category>hardware</category>
          </inc:getKeys>
       </soapenv:Body>
    </soapenv:Envelope>

Sample SOAP response  

    <soapenv:Envelope xmlns:inc="http://www.service-now.com/incident" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
       <soapenv:Header/>
       <soapenv:Body>
          <getKeysResponse>
             <sys_id>46e18c0fa9fe19810066a0083f76bd56,46e57642a9fe1981000b96a5dca501ff,46f1784ba9fe19810018aa27fbb23482</sys_id>
             <count>7</count>
          </getKeysResponse>
       </soapenv:Body>
    </soapenv:Envelope>

## Language-specific sample messages

For language-specific getKeys samples, refer to the following
topics:

[Perl SOAP::Lite](https://servicenow-prod.fluidtopics.net/rdDW1aMCNRRHetDvntc5sg "Examples demonstrating an integration with a Perl web services client.")

[Java Apache Axis2](https://servicenow-prod.fluidtopics.net/Oj9gDMXXLJHLXIp~_lxQoA "An example of an Axis Client program that calls the getKeys function to query all incidents where the category is Hardware.")

[Python](https://servicenow-prod.fluidtopics.net/AQTKUsK2Oth5IFEC0cvZYw#c_PythonWebServicesClientExamples__getKeys)