You can read an existing record from a table.

See this example.


Use a URL in the following form to invoke the API.

POST{appId}/tables/{tableName}/Action where

  • {appId} specifies the GUID of the AppSheet application. You can obtain the {appId} from the Manage > Integrations > IN pane.
  • {tableName} specifies the name of the table.


The HTTP Body contains:

  1. The Action name “Find"”.
  2. Optional properties such as Locale, Location, and Timezone.
    The Locale is used when validating Date, Time, DateTime, Decimal, Percent, and Price data values. For example, when Locale is "en-US", date values must be entered in MM/DD/YYYY format. When Locale is "en-GB", date values must be entered in DD/MM/YYYY format.
  3. exactly one Row value to be read. The Row value must include the key field values of the record to be read.

"Action": "Edit",
"Properties": {
"Locale": "en-US",
"Location": "47.623098, -122.330184",
"Timezone": "Pacific Standard Time",
"Rows": [
"FirstName": "Jan",
"LastName": "Jones",

API Response Content

The API returns the row in HTTP contents.


  "Rows": [


"_RowNumber": 10,

"FirstName": "Jan",

"LastName": "Jones",

"Age": 33,

"Department": "Accounting",

"Street": "110 Beach Blvd",

"City": "Newport Beach",

"State": "CA",

"Zip": 92661,

"Home Phone": 4257868765,

"Fax": 4253214432,

"Date Hired": "10/31/2014",

"Arrived": "8:15:25",

"Departed": "18:30:33",

"Last Review": "08/31/2017 23:59:59",

"Rating": 0.9950,

"Salary": 3333.45,

"Image": ""




API Response HTTP Status Codes

The API returns the following HTTP status codes. 

  1. 200 Success
  2. 400 Bad Request
    a. The Application Access Key is missing.
    b. The AppId is missing.
    c. The Post body contains invalid data.
  3. 403 Forbidden
    a. The Web API is not enabled for this application.
    b. The Application Access Key is invalid.
  4. 404 Not Found
    a. The application specified by the AppId cannot be found.
  5. 500 Internal Server Error
    a. An unexpected error occurred.

When a Record is Read

  1. The record is retrieved based on the key values you specify.
  2. The record is returned in the HTTP content.

Row Having Key Not Found

See topic "Row Having Key Not Found" here.

Did this answer your question?