Count

Get the amount of records in a collection.

PreviousChange Responsibility NextDelete

Last updated 2 years ago

Was this helpful?

Count

Get the amount of records in a collection.

When you want to display how many records your collection has without displaying them. You can pass filter and paging parameters to filter records upfront and get the amount of filtered records.

You register employees from when to when s/he wants to travel, in which country, and you can attach documents related to the business trip. You can use our templates or create collections and taxonomies manually by following our instructions.

Prerequisites:

Create Employees collection and other related taxonomies from the template. See instructions here.
Create a collection of "Business Trips." You can do it manually or just copy-paste JSON and UI schemas into CodeMash Dashboard. See instructions here. The schema itself can be found here.

Let's say you have some records inserted in the "Business Trips" collection.

Let's get all the amount of records in the collection.

curl -X 'GET' \
  'https://api.codemash.io/v2/db/business-trips/count' \
  -H 'Authorization: Bearer ***' \
  -H 'X-CM-ProjectId: e1aa5e3b-f16d-4f43-a315-2d89f7633dc3' \
  -H 'Accept: application/json'

IRepository<BusinessTrip> Trips { get; set; }

var amount = await Trips.CountAsync();

Console.WriteLine(amount); // 15

Please remember you need to initialize Repo first to avoid getting a NullReference exception. See how you can do that by following this link.

Let's filter some records by date ranges.

Let's find business trips that will start in 10 days. We store the "From" data field in CodeMash as a date field, which converts at the end as a UNIX timestamp. See more about the Date field.

#!/bin/bash

FROM=`date -d "+10 days" +%s`

curl -X 'POST' \
  'https://api.codemash.io/v2/db/business-trips/count' \
  -H 'Authorization: Bearer ***' \
  -H 'X-CM-ProjectId: e1aa5e3b-f16d-4f43-a315-2d89f7633dc3' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "filter": "{ from : { $gte : '$FROM'  }}" }'

We can pass the date range as well to find out trips from the last 30 days.

#!/bin/bash

FROM=`date -d "-30 days" +%s`
TO=`date +%s`

curl -X 'POST' \
  'https://api.codemash.io/v2/db/business-trips/count' \
  -H 'Authorization: Bearer ***' \
  -H 'X-CM-ProjectId: e1aa5e3b-f16d-4f43-a315-2d89f7633dc3' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "filter": "{ from : { $gt : '$FROM' }, to: { $lt: '$TO' }}"  }'

See more examples of how you can leverage filters

Let's find business trips that will start in 10 days. We store the "From" data field in CodeMash as a date field, which converts at the end as a UNIX timestamp. See more about the Date field.

IRepository<BusinessTrip> Trips { get; set; }

var from = DateTime.Now.AddDays(+10).ToUnixTimeMs();
var tripsIn10Days = await Trips.CountAsync(x => x.From > from);

Console.WriteLine(tripsIn10Days); // 7

We can pass the date range as well to find out trips from the last 30 days

IRepository<BusinessTrip> Trips { get; set; }

var from = DateTime.Now.AddDays(-30).ToUnixTimeMs();
var to =DateTime.Now.ToUnixTimeMs();

var recentTrips = await Trips.CountAsync(x => x.From > from && x.To <= to);

Console.WriteLine(recentTrips); // 24

The filter can be:

Valid JSON (MQL - MongoDB query language)
Expression<Func<T,bool>>
FilterDefinition<T>

See more examples of how you can leverage filters in .NET

And last one example. Let's find all employee business trips that are planned for the future.

We assume that:

We have a country we are interested in - taxonomy term Id. E.g., We can fetch all terms from the taxonomy called countries and find the term Id of France.
We have an employee Id - employee
We have a date from, the Unix time

curl -X 'POST' \
  'https://api.codemash.io/v2/db/business-trips/count' \
  -H 'Authorization: Bearer ***' \
  -H 'X-CM-ProjectId: e1aa5e3b-f16d-4f43-a315-2d89f7633dc3' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "filter": "{ from : { $gte : 1730969827000  }}"}'

We assume that:

We have a country we are interested in - taxonomy term Id. E.g., We can fetch all terms from the taxonomy called countries and find the term Id of France.
We have an employee Id - employee
We have a date from, e.g., DateTime.Now converted to the Unix time in milliseconds

IRepository<BusinessTrip> Trips { get; set; }

var f = Builders<BusinessTrip>.Filter;

var from = f.Gte(x => x.From, from);
var inCountry = f.Eq(x => x.CountryId, country);
var withEmployee = 
      f.ElemMatch(x => x.Employees, x => x.EmployeeId == employee);

var tripsCount = 
      await Trips.CountAsync(from & inCountry & withEmployee);

So in the example above, we found the number of future trips of one particular employee to one country.

Visit our GitHub repo to see more examples:

.NET

Try out our API:

With any REST client

GET

POST

PreviousChange Responsibility NextDelete

Last updated 2 years ago

Was this helpful?

When you want to display how many records your collection has without displaying them. You can pass filter and paging parameters to filter records upfront and get the amount of filtered records.

Prerequisites:

Create Employees collection and other related taxonomies from the template. See instructions here.
Create a collection of "Business Trips." You can do it manually or just copy-paste JSON and UI schemas into CodeMash Dashboard. See instructions here. The schema itself can be found here.

Let's say you have some records inserted in the "Business Trips" collection.

Let's get all the amount of records in the collection.

curl -X 'GET' \
  'https://api.codemash.io/v2/db/business-trips/count' \
  -H 'Authorization: Bearer ***' \
  -H 'X-CM-ProjectId: e1aa5e3b-f16d-4f43-a315-2d89f7633dc3' \
  -H 'Accept: application/json'

IRepository<BusinessTrip> Trips { get; set; }

var amount = await Trips.CountAsync();

Console.WriteLine(amount); // 15

Please remember you need to initialize Repo first to avoid getting a NullReference exception. See how you can do that by following this link.

Let's filter some records by date ranges.

Let's find business trips that will start in 10 days. We store the "From" data field in CodeMash as a date field, which converts at the end as a UNIX timestamp. See more about the Date field.

#!/bin/bash

FROM=`date -d "+10 days" +%s`

curl -X 'POST' \
  'https://api.codemash.io/v2/db/business-trips/count' \
  -H 'Authorization: Bearer ***' \
  -H 'X-CM-ProjectId: e1aa5e3b-f16d-4f43-a315-2d89f7633dc3' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "filter": "{ from : { $gte : '$FROM'  }}" }'

We can pass the date range as well to find out trips from the last 30 days.

#!/bin/bash

FROM=`date -d "-30 days" +%s`
TO=`date +%s`

curl -X 'POST' \
  'https://api.codemash.io/v2/db/business-trips/count' \
  -H 'Authorization: Bearer ***' \
  -H 'X-CM-ProjectId: e1aa5e3b-f16d-4f43-a315-2d89f7633dc3' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "filter": "{ from : { $gt : '$FROM' }, to: { $lt: '$TO' }}"  }'

See more examples of how you can leverage filters

Let's find business trips that will start in 10 days. We store the "From" data field in CodeMash as a date field, which converts at the end as a UNIX timestamp. See more about the Date field.

IRepository<BusinessTrip> Trips { get; set; }

var from = DateTime.Now.AddDays(+10).ToUnixTimeMs();
var tripsIn10Days = await Trips.CountAsync(x => x.From > from);

Console.WriteLine(tripsIn10Days); // 7

We can pass the date range as well to find out trips from the last 30 days

IRepository<BusinessTrip> Trips { get; set; }

var from = DateTime.Now.AddDays(-30).ToUnixTimeMs();
var to =DateTime.Now.ToUnixTimeMs();

var recentTrips = await Trips.CountAsync(x => x.From > from && x.To <= to);

Console.WriteLine(recentTrips); // 24

The filter can be:

Valid JSON (MQL - MongoDB query language)
Expression<Func<T,bool>>
FilterDefinition<T>

See more examples of how you can leverage filters in .NET

And last one example. Let's find all employee business trips that are planned for the future.

We assume that:

We have a country we are interested in - taxonomy term Id. E.g., We can fetch all terms from the taxonomy called countries and find the term Id of France.
We have an employee Id - employee
We have a date from, the Unix time

curl -X 'POST' \
  'https://api.codemash.io/v2/db/business-trips/count' \
  -H 'Authorization: Bearer ***' \
  -H 'X-CM-ProjectId: e1aa5e3b-f16d-4f43-a315-2d89f7633dc3' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "filter": "{ from : { $gte : 1730969827000  }}"}'

We assume that:

We have a country we are interested in - taxonomy term Id. E.g., We can fetch all terms from the taxonomy called countries and find the term Id of France.
We have an employee Id - employee
We have a date from, e.g., DateTime.Now converted to the Unix time in milliseconds

IRepository<BusinessTrip> Trips { get; set; }

var f = Builders<BusinessTrip>.Filter;

var from = f.Gte(x => x.From, from);
var inCountry = f.Eq(x => x.CountryId, country);
var withEmployee = 
      f.ElemMatch(x => x.Employees, x => x.EmployeeId == employee);

var tripsCount = 
      await Trips.CountAsync(from & inCountry & withEmployee);

So in the example above, we found the number of future trips of one particular employee to one country.

Visit our GitHub repo to see more examples:

.NET

Try out our API:

With any REST client

GET

POST

[Count] - Get the amount of records in a collection.

get

Sometimes it's useful to have the capability to get records amount in the collection without calling the find function. You can pass filter and paging parameters to filter records upfront and get the amount of filtered records. https://docs.codemash.io/api/database/collections/count

Authorizations

Path parameters

CollectionNameanyrequired

Collection name - unique, lowercased, collection name without whitespace. E.g., if your collection title you have entered in the CodeMash dashboard is "Business Trips" then collection name would be "business-trips".

versionanyrequired

The CodeMash API version used to fetch data from the API. If not specified, the last version will be used. E.g.: v2

Query parameters

Filteranyoptional

Filter cannot be passed as query string, use POST method instead.

Limitanyoptional

A limit on the number of objects to be returned, between 1 and 100.

Skipanyoptional

The number of records to skip before counting

Header parameters

Acceptanyrequired

Accept Header

X-CM-Clusteranyoptional

API key of your cluster. Can be passed in a header as X-CM-Cluster.

X-CM-ProjectIdanyrequired

ID of your project. Can be passed in a header as X-CM-ProjectId.

CultureCodeanyoptional

Specify culture code when your response from the API should be localised. E.g.: en

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.codemash.io//{version}/db/{CollectionName}/count' \
  --header 'Authorization: YOUR_API_KEY'

200

{
  "response_status": {
    "error_code": "text",
    "message": "text",
    "stack_trace": "text",
    "errors": [
      {
        "error_code": "text",
        "field_name": "text",
        "message": "text",
        "meta": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "meta": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "result": 1
}

Success

[Count] - Get the amount of records in a collection.

post

Authorizations

Path parameters

CollectionNameanyrequired

versionanyrequired

The CodeMash API version used to fetch data from the API. If not specified, the last version will be used. E.g.: v2

Header parameters

Acceptanyrequired

Accept Header

X-CM-Clusteranyoptional

API key of your cluster. Can be passed in a header as X-CM-Cluster.

X-CM-ProjectIdanyrequired

ID of your project. Can be passed in a header as X-CM-ProjectId.

CultureCodeanyoptional

Specify culture code when your response from the API should be localised. E.g.: en

Body

Filterstringoptional

A query (in JSON format) that specifies which records to count

Limitintegeroptional

A limit on the number of objects to be returned, between 1 and 100.

Skipintegeroptional

The number of records to skip before counting

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.codemash.io//{version}/db/{CollectionName}/count' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'Filter=text&Limit=1&Skip=1'

200

{
  "response_status": {
    "error_code": "text",
    "message": "text",
    "stack_trace": "text",
    "errors": [
      {
        "error_code": "text",
        "field_name": "text",
        "message": "text",
        "meta": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "meta": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "result": 1
}

Success