Get table

Read a table with its fields and saved views. You need field ids to write cells, choice ids to fill choice fields, and a view id to list records.

GET/v1/w/{workspace}/tables/{tableId}

Path parameters

workspacestringrequired

Your workspace’s address name.

tableIdstringrequired

The table, from List bases.

Response

tableobjectrequired

fieldsobject[]required

viewsobject[]required

Details

Read a table, fields and saved views visible to you. Gallery options include coverFieldId, coverFit and cardSize. Other people’s personal views are omitted. Read app instructions for full field and view options.

Since 2026-12. Errors are listed in Errors.

cURL

curl "https://api.olamma.sh/v1/w/your-workspace/tables/{tableId}" \
  -H "Authorization: Bearer $OLAMMA_KEY"

Response 200

{
  "table": {
    "id": "<string>",
    "baseId": "<string>",
    "name": "<string>",
    "rowCount": 123,
    "primaryFieldId": "<string>"
  },
  "fields": [
    {
      "id": "<string>",
      "tableId": "<string>",
      "name": "<string>",
      "type": "<string>",
      "options": {},
      "position": 123
    }
  ],
  "views": [
    {
      "id": "<string>",
      "tableId": "<string>",
      "name": "<string>",
      "type": "<string>",
      "config": {},
      "version": "<string>"
    }
  ]
}