List entries

v1.0.0

Lists entries in a given list, with the option to filter and sort results.

Required scopes: list_entry:read, list_configuration:read.

Input

{
  "type": "object",
  "properties": {
    "filter": {
      "type": "object",
      "description": "An object used to filter results to a subset of results. Cannot be used together with `filter_view_id`. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting)."
    },
    "filter_view_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of a saved view on this object or list. When set, results are filtered using that view's filter configuration. Cannot be used together with `filter`. Note: sorts, limits, and offsets are applied independently and are not taken from the view. All attributes are returned regardless of which attributes are visible in the view."
    },
    "limit": {
      "type": "number",
      "description": "The maximum number of results to return. Defaults to 500. See the [full guide to pagination here](/rest-api/guides/pagination)."
    },
    "list": {
      "type": "string",
      "description": "A UUID or slug to identify the list to retrieve entries from."
    },
    "offset": {
      "type": "number",
      "description": "The number of results to skip over before returning. Defaults to 0. See the [full guide to pagination here](/rest-api/guides/pagination)."
    },
    "sorts": {
      "type": "array",
      "description": "An object used to sort results. See the [full guide to filtering and sorting here](/rest-api/guides/filtering-and-sorting).",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "list"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "Success",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "parent_record_id",
          "parent_object",
          "created_at",
          "entry_values"
        ],
        "properties": {
          "created_at": {
            "type": "string",
            "description": "When this entry was created."
          },
          "entry_values": {
            "type": "object",
            "description": "A list of attribute values for the list entry (not attribute values for its parent record)."
          },
          "id": {
            "type": "object",
            "required": [
              "workspace_id",
              "list_id",
              "entry_id"
            ],
            "properties": {
              "entry_id": {
                "type": "string",
                "format": "uuid",
                "description": "A UUID identifying this entry."
              },
              "list_id": {
                "type": "string",
                "format": "uuid",
                "description": "A UUID identifying the list this entry is in."
              },
              "workspace_id": {
                "type": "string",
                "format": "uuid",
                "description": "A UUID identifying the workspace this entry belongs to."
              }
            }
          },
          "parent_object": {
            "type": "string",
            "description": "A UUID or slug identifying the object that the parent record belongs to."
          },
          "parent_record_id": {
            "type": "string",
            "format": "uuid",
            "description": "A UUID identifying the record that is parent of the list entry."
          }
        }
      }
    }
  }
}