---
title: "Count Table Records"
method: GET
path: "/api/v3/data/{baseId}/{tableId}/count"
tags: ["Table Records"]
---

# Count Table Records

`GET /api/v3/data/{baseId}/{tableId}/count`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/data/{baseId}/{tableId}/count`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/data/:baseId/:tableId/count/get.ts> (a function with typed inputs; its response is checked against the schema)

This API endpoint allows you to retrieve the total number of records from a specified table or a view. You can narrow down search results by applying `where` query parameter

## Query parameters

- `where` string

## Headers

- `xc-token` string, required

## Response `200`

OK

- object
  - `count` number

## Other responses

- `400`: BadRequest

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)