v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Reference Tables

List rows

List all rows in a reference table using cursor-based pagination. Pass the page[continuation_token] from the previous response to fetch the next page on the same consistent snapshot. Returns 400 for tables with more than 10,000,000 rows.

get/api/v2/reference-tables/tables/{id}/rows/list

Path parameters

idstring required

Unique identifier of the reference table to list rows from.

Query parameters

page[limit]integer

Number of rows to return per page. Defaults to 100, maximum is 1000.

page[continuation_token]string

Opaque cursor from the previous response's next link. Pass this to retrieve the next page on the same consistent snapshot.

Response

Example response

{
  "data": [
    {
      "attributes": {
        "values": {
          "category": "tor",
          "intention": "suspicious",
          "ip_address": "102.130.113.9"
        }
      },
      "id": "102.130.113.9",
      "type": "row"
    }
  ],
  "links": {
    "first": "/api/v2/reference-tables/tables/00000000-0000-0000-0000-000000000000/rows/list?page%5Blimit%5D=100",
    "self": "/api/v2/reference-tables/tables/00000000-0000-0000-0000-000000000000/rows/list?page%5Bcontinuation_token%5D=eyJzaWQiOjEyMzQ1LCJwayI6ImV4YW1wbGVfcGsifQ%3D%3D&page%5Blimit%5D=100"
  },
  "meta": {
    "page": {
      "next_continuation_token": "eyJzaWQiOjEyMzQ1LCJwayI6ImV4YW1wbGVfcGsifQ=="
    }
  }
}