Retrieve user information from an application. These data entities are returned in JSON format. This information may be filtered using the optional parameters provided.

The following operators are supported in the filter parameter, from highest to lowest precedence.

  • is null, is not null (postfix)
  • not, ! (prefix)
  • >, >=, <, <= (infix)
  • =, != (infix)
  • and (infix)
  • or (infix)
Note. Previous releases of this call included the contains operator. This operator has been removed because its behavior was counterintuitive. If you use this operator now, you will get a 485 error.

For the filter parameter, String values specified by operators must be surrounded by single quotes. Integer values work either with or without single quotes. If used with email, only a full email address can be used (for example, `fsmith@example.com). You cannot filter on a domain (for example,example.com`).

Refer to the Registration Error Codes section for details on error codes.

Important: Querying Large Datasets

When using the entity.find endpoint to iterate over large sets of data (> 100,000), queries should be optimized using natural database sorting by sorting on the id attribute. This has two benefits:

  • Records created between when the time iteration begins and when the time iteration ends are included in the results.
  • Efficient and consistent performance querying and loading for each page of results.

The following tips will help you optimize your queries:

  • Use the attributes parameter to limit the number of attributes returned for each record to minimize the size of the HTTP payload.
  • Experiment with the max_results parameter to optimize for responses under 10 seconds.
  • Include the timeout parameter (up to 60 seconds) if, and only if, you are unable to keep responses under 10 seconds using the max_results parameter.

See the article Managing User Data for a sample Python script that returns each record created since January 1, 2016.This endpoint includes the following methods:

  • POST



This endpoint supports both Basic authentication (recommended) and janrain-signed authentication.

How to Create an Authentication String

Base URL

The base URL for this endpoint is your Janrain Capture domain; for example:


Your Capture domains (also known as Registration domains) can be found in the Janrain Console on the Manage Application page:


Example: Sort to see the most recently-updated data first


Example: Find users with a birthday

filter="birthday is not null"

Example: Find users who identify as "male"


Example: Adding more than one condition to a filter

filter="gender='male' and birthday>'2012-06-13 18:02:56.012122 +0000'"

Example: Retrieve data for specific attributes

Here is an example of returning data from Capture using entity.find, selectively returning only data for the displayName and email attributes.

curl -X POST -H "Authorization: Basic aW1fYV...NfbXk="\
    --data-urlencode type_name=user\
    --data-urlencode attributes='["displayName", "email"]' \
      Running this command in Postman

Example Response

  "result_count": 6,
  "stat": "ok",
  "results": [
      "displayName": "ian",
      "email": "ian@example.com"
      "displayName": "Rex",
      "email": "rex@example.com"
      "displayName": "sam",
      "email": "smann@example.com"
      "displayName": "alex",
      "email": "alex@example.com"
      "displayName": "john.j",
      "email": "jj@example.com"
      "displayName": "daniel",
      "email": "daniel@example.com"

Authorized Clients

  • owner 
  • direct_access 
  • direct_read_access

Query Parameters

Parameter Type Required Description
type_name string Yes Name of the entityType.
filter string Expression used to filter the result. By default, all records are returned.
max_results string Integer value between 1 and 1000, inclusive, specifying the maximum number of records to be returned. The default value is 100.
sort_on string JSON array of attributes used to specify the sort order. By default, results are sorted in ascending order. To sort in descending order, place a minus sign (-) directly in front of the appropriate attribute. For example:
attributes string JSON array of attributes to be returned. By default, all attributes and attribute values are returned.