Rows

Get rows for a table

Changed on

Returns a set of rows in the published version of the specified table. Row results can be filtered and sorted. Filtering and sorting options will be sent as query parameters to the API request. For example, by adding the query parameters column1__gt=5&sort=-column1, API returns the rows with values for column column1 greater than 5 and in the descending order of column1 values. Refer to the overview section for detailed filtering and sorting options. Note: This endpoint can be accessed without any authentication, if the table is set to be allowed for public access.

get/cms/hubdb/2026-03/tables/{tableIdOrName}/rows

Request

  • Base URL
    https://api.hubapi.com
  • Auth
    • OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopeshubdb
    • or OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopeshubdb.rows.read

Path parameters

tableIdOrNamestring required

The unique identifier or name of the table to retrieve rows from.

Query parameters

afterstring

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

archivedboolean

Whether to return only results that have been archived.

limitinteger

The maximum number of results to display per page.

offsetinteger

The number of rows to skip before starting to collect the result set.

propertiesstring[]

An array of property names to include in the response.

sortstring[]

An array of property names to sort the results by.

Response

successful operation

OR

Changes

    • info

      the security scope hubdb was added to the endpoint's security scheme oauth2

    • info

      the security scope hubdb.rows.read was removed from the endpoint's security scheme oauth2

    • info

      the security scope hubdb was added to the endpoint's security scheme oauth2

    • info

      the security scope hubdb.rows.read was removed from the endpoint's security scheme oauth2