Get Blueprints Records Count

Purpose

To get the number of records currently present inside a specific Blueprint in your Zoho CRM organization.

Endpoints

  • GET /settings/blueprints/{blueprint_ID}/actions/records_count

Request Details

Request URL

{api-domain}/crm/{version}/settings/blueprints/{blueprint_ID}/actions/records_count

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

ZohoCRM.settings.blueprint.ALL
(or)
ZohoCRM.settings.blueprint.READ

Parameters

  • blueprint_id string, mandatory

    Specify the ID of the blueprint.

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/blueprints/5843104000004358046/actions/records_count"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-X GET

Response JSON

The blueprints JSON array consists of the record count details for the specific Blueprint in your Zoho CRM organization. This includes the key record_count:

  • records_countInteger

    Represents the number of records currently present inside the Blueprint.

Possible Errors

  • INVALID_DATAHTTP 400

    The blueprint ID given seems to be invalid.
    Resolution: Specify a valid blueprint ID.

  • OAUTH_SCOPE_MISMATCHHTTP 401

    Unauthorized access due to invalid scope.
    Resolution: Generate a new access token with appropriate scope.

  • AUTHENTICATION_FAILUREHTTP 401

    Authentication failed.
    Resolution: Pass a valid OAuth access token in the Authorization header.

  • NO_PERMISSIONHTTP 403

    No permission to access this resource.
    Resolution: Ensure that the user has the required permission to manage workflow-related resources.

  • INVALID_URL_PATTERNHTTP 404

    The request URL specified is incorrect.
    Resolution: Verify the API endpoint URL.

  • INTERNAL_ERRORHTTP 500

    Unexpected server error.
    Resolution: Contact Zoho support.

Sample Response

Copied{
    "blueprints": [
        {
            "records_count": 2
        }
    ]
}