行

Get rows for a table

指定されたテーブルの公開済みバージョンの行のセットが返されます。行の結果は絞り込みや並べ替えが可能です。絞り込みや並べ替えのオプションはクエリーパラメーターとしてAPIリクエストに送信されます。例えば、クエリーパラメーター「column1__gt=5&sort=-column1」を追加すると、APIによって「column1」列の値が5より大きい行が「column1」の値の降順で返されます。絞り込みや並べ替えのオプションについて詳しくは、［概要セクション］（https://developers.hubspot.com/docs/api/cms/hubdb#filtering-and-sorting-table-rows）を参照してください。 **注：**このエンドポイントは、テーブルが公開アクセスを許可するように設定されていれば、許可なくアクセスできます。

GET

cms

hubdb

2026-03

tables

{tableIdOrName}

rows

テーブルの行を取得

curl --request GET \
  --url https://api.hubapi.com/cms/hubdb/2026-03/tables/{tableIdOrName}/rows \
  --header 'Authorization: Bearer <token>'

{
  "results": [
    "<unknown>"
  ],
  "total": 123,
  "type": "RANDOM_ACCESS",
  "paging": {
    "next": {
      "offset": 123,
      "link": "<string>"
    }
  }
}

Supported products

Required Scopes

承認

Authorization

string

header

必須

The access token received from the authorization server in the OAuth 2.0 flow.

パスパラメータ

tableIdOrName

string

必須

照会するテーブルのIDまたは名前。

クエリパラメータ

after

string

最後に正常に読み取られたリソースのページ操作カーソルトークンは、より多くの結果を含むページ付きレスポンスのpaging.next.after JSONプロパティーとして返されます。

archived

boolean

アーカイブ済みの行をレスポンスに含めるかどうかを指定します。

limit

integer<int32>

返す結果の最大数。デフォルトは「1000」です。

offset

integer<int32>

結果を返し始める前にスキップする行数。

properties

string[]

全ての列の詳細ではなく必要な列のみが含まれる結果を取得するには、列名を指定してください。

sort

string[]

結果の並べ替えの基準となる列名が指定されます。詳細については、上記の説明を参照してください。

レスポンス

successful operation

Option 1
Option 2

results

any[]

必須

total

integer<int32>

必須

コレクションで使用可能な行の合計数。

type

enum<string>

デフォルト:RANDOM_ACCESS

必須

レスポンスのタイプを示し、デフォルトでは「RANDOM_ACCESS」です。

利用可能なオプション:

RANDOM_ACCESS

paging

object

Show child attributes

最終更新日 2026年4月13日

Delete a table version

Get a table row

⌘I