cURL
curl --request GET \
--url https://api.nohead.io/v1/collections/{collection_id}/records/count \
--header 'Authorization: Bearer <token>'import { Nohead } from "@nohead/sdk"
const nohead = new Nohead()
const result = await nohead.records.count("posts", {
filter: { published_at: { exists: false } },
})
from nohead import Nohead
nohead = Nohead()
result = nohead.records.count("posts", filter={"published_at": {"exists": False}})
require "nohead"
nohead = Nohead::Client.new
result = nohead.records.count("posts", filter: { published_at: { exists: false } })
{
"object": "record_count",
"collection_id": "<string>",
"count": 123
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}Records
Count records
How many records match the filters, which work as in the list.
GET
/
v1
/
collections
/
{collection_id}
/
records
/
count
cURL
curl --request GET \
--url https://api.nohead.io/v1/collections/{collection_id}/records/count \
--header 'Authorization: Bearer <token>'import { Nohead } from "@nohead/sdk"
const nohead = new Nohead()
const result = await nohead.records.count("posts", {
filter: { published_at: { exists: false } },
})
from nohead import Nohead
nohead = Nohead()
result = nohead.records.count("posts", filter={"published_at": {"exists": False}})
require "nohead"
nohead = Nohead::Client.new
result = nohead.records.count("posts", filter: { published_at: { exists: false } })
{
"object": "record_count",
"collection_id": "<string>",
"count": 123
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}Authorizations
Project-scoped API key, e.g. nohead_sk_k7fz0a9c3m2q_<secret>, or
nohead_pk_… for a published-only key. Used by servers, CI, the CLI
and coding agents.
Path Parameters
Collection ID, or the collection slug when authenticating with an API key.
Query Parameters
filter[<key>]=value (equal), or filter[<key>][<operator>]=value;
filters combine with AND. Keys are field keys, published_at,
deleted (true lists soft-deleted records instead) and, in record
lists and counts, created_at and updated_at.
eq,ne: equal, not equal. For fields with several values, "contains" and "does not contain".nematches records with no value.gt,gte,lt,lte: integer, decimal and date fields with one value, and the timestamps.in: any of up to 100 comma-separated values (\,is a comma inside a value,\\a backslash); for fields with several values, "contains any of".exists:truefor records with a value,falsefor those without (andpublished_at: published or not).
Values are parsed per field type ("5" is not the integer 5), but
not held to the field's limits or format (price[lt]=10 works when
max is 5; a slug filter that isn't a slug matches nothing). Dates
take today, and dates with a time now too. A day (YYYY-MM-DD)
given for a date with a time, or a timestamp, covers that day in the
field's time_zone (UTC without one): gte from its start, lte to
its end, eq within it. A date with a time matches the same moment
written with any offset.
Show child attributes
Show child attributes