Get Cursor

Retrieves multiple records from an App by specifying the cursor ID.
Method GET
URL https://{subdomain}.kintone.com/k/v1/records/cursor.json
URL(guest space) https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/records/cursor.json
Authentication Session authenticationAPI Token Authentication , Password Authentication
Content-Type application/json

Permissions

The user or API Token must have permission to view the records.

Request Parameters

Parameter Value Required Description
id String Yes The cursor ID.

Sample Request

JavaScript (using Kintone REST API Request)

curl 

Response Parameters

Parameter Type Description
records Array An array of objects that includes field data of records that match the query.
The response is the same as the response for the Get Records API.
next Boolean

States whether there are more records that can be acquired from the cursor.

  • true: There are still records to be acquired. 
  • false: There are no more records to be acquired.

Run this API again with the same parameters to obtain the next set of records.

The cursor will remain valid until all records have been obtained.

Sample Response

Limitations

  • The Get Cursor API returns records that match the query at the timing when the Add Cursor API is called. However, the Get Cursor API returns the field values of records at the timing the Get Cursor API is called.
  • In the case where new permission settings are applied to the App after a cursor is added, the Get Cursor API may return records that should not match the query with the new permissions. In this case, values within fields with no view permissions cannot be seen in the response.
  • As the field values obtained is dependent on when the Get Cursor API is called, the obtained values from localized fields may vary depending on the API initiator's language settings.
  • There may be cases when the next set of records obtained (when the next parameter is true) is empty, if records are deleted or have new permissions settings applied during the Get Cursor API requests.
  • The cursor will automatically be deleted when it responds false for the next parameter. Any further requests will result in a 404 error response.
Was this article helpful?
0 out of 0 found this helpful
Do you have any questions or issues related to this article?
Please share your views with us in the Community forums!