Skip to main content
System StatusContact Support
VersionOne Community

findin Query Parameter

Used in conjunction with the find parameter, findin specifies the attributes to check for the find substring. The findin parameter is optional. If omitted, a base set of attributes will be searched. This free text search is relatively expensive for VersionOne, so when the exact contents of a field should be matched, use the where parameter instead.

rest-1 URL Syntax

In rest-1.v1/Data and rest-1.oauth.v1/Data, the findin parameter is a URL query parameter. The findin parameter can be a single attribute or a set of comma separated attributes. The following shows how the findin is expressed in the query:

<Server Base URI>/rest.v1/Data/Story?sel=Name,Number&find=Ticket&findin=Name

The following shows how the findin parameter is used to search within multiple attributes:

<Server Base URI>/rest.v1/Data/Story?sel=Name,Number&find=Ticket&findin=Name,Description

query.v1 Syntax

In query.v1 and query.legacy.v1, the findin parameter is expressed as an array of attribute definitions.

YAML

from: Story
select:
  - Name
  - Number
find: Ticket
findin:
  - Name

JSON

{
  "from": "Story",
  "select":
    [
      "Name",
      "Number"
    ],
  "find": "Ticket",
  "findin":
    [
      "Name"
    ]
}
  • Was this article helpful?