Skip to main content
GET
/
v2
/
extractions
/
{id}
/
tables
/
{tableKey}
/
rows
curl -X GET https://api.tableflow.com/v2/extractions/uT2bJNWN75YPU95r/tables/line_items/rows?offset=0&limit=100 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "pagination": {
    "offset": 0,
    "limit": 100,
    "total": 3,
    "next_offset": null,
    "filter": "all"
  },
  "rows": [
    {
      "index": 0,
      "values": {
        "description": "Ergonomic Office Chair",
        "quantity": "1",
        "unit_price": "249.99",
        "amount": "249.99"
      },
      "validations": {}
    },
    {
      "index": 1,
      "values": {
        "description": "Wireless Keyboard",
        "quantity": "2",
        "unit_price": "59.95",
        "amount": "119.90"
      },
      "validations": {}
    },
    {
      "index": 2,
      "values": {
        "description": "27-inch Monitor",
        "quantity": "2",
        "unit_price": "329.99",
        "amount": "659.98"
      },
      "validations": {}
    }
  ]
}
Retrieves paginated rows from a specific table in an extraction. This endpoint is useful for accessing large tables efficiently.

​
Usage Notes

  • Use pagination to retrieve rows from large tables
  • Row indexes are 0-based, meaning the first row has an index of 0
  • When no offset or limit is provided, defaults to offset 0 and limit 100
  • Multiple filters can be combined using comma-separated values (e.g., filter=error,warn)

​
Request

​
id
string
required
The ID of the extraction.
​
tableKey
string
required
The key of the table to retrieve rows from.
​
offset
integer
default:"0"
The number of rows to skip. Minimum value is 0.
​
limit
integer
default:"100"
The maximum number of rows to return. Minimum value is 1, maximum value is 1000.
​
filter
string
default:"all"
Filter rows by status or validation state. Supports comma-separated values for multiple filters.
  • all - Return all rows (default)
  • valid - Rows that pass all validations
  • invalid - Rows that fail at least one validation
  • error - Rows with error-severity validations
  • warn - Rows with warning-severity validations
  • info - Rows with info-severity validations
​
column_validations
string
Filter to only return rows that have validations in specific columns. Provide column keys as comma-separated values (e.g., column_validations=unit_price,quantity). Only rows with validation issues in any of the specified columns will be returned.
curl -X GET https://api.tableflow.com/v2/extractions/uT2bJNWN75YPU95r/tables/line_items/rows?offset=0&limit=100 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
pagination
object
Pagination information.
​
rows
array
Array of table rows.
{
  "pagination": {
    "offset": 0,
    "limit": 100,
    "total": 3,
    "next_offset": null,
    "filter": "all"
  },
  "rows": [
    {
      "index": 0,
      "values": {
        "description": "Ergonomic Office Chair",
        "quantity": "1",
        "unit_price": "249.99",
        "amount": "249.99"
      },
      "validations": {}
    },
    {
      "index": 1,
      "values": {
        "description": "Wireless Keyboard",
        "quantity": "2",
        "unit_price": "59.95",
        "amount": "119.90"
      },
      "validations": {}
    },
    {
      "index": 2,
      "values": {
        "description": "27-inch Monitor",
        "quantity": "2",
        "unit_price": "329.99",
        "amount": "659.98"
      },
      "validations": {}
    }
  ]
}

​
Error Responses

​
error
string
Error message describing what went wrong.
{
  "error": "The parameter 'filter' contains invalid value: unknown"
}