Accounts Count by CUIT
curl --request GET \
--url http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data.integrationCode": "<string>",
"data.cuit": "<string>",
"data.found": true,
"data.snapshotDate": {},
"data.lastChangedDate": {},
"data.isNew": true,
"data.cbuCount": 123,
"data.cvuCount": 123,
"data.totalAccounts": 123,
"data.cuitDemographics": {},
"data.cuitDemographics.prefix": "<string>",
"data.cuitDemographics.dni": "<string>",
"data.cuitDemographics.contributorType": "<string>",
"data.cuitDemographics.gender": {},
"data.cuitDemographics.cuitValid": true,
"data.cuitDemographics.ageRange": {},
"data.cuitDemographics.ageRangeConfidence": {},
"data.cuitDemographics.probableForeigner": {},
"data.cuitDemographics.foreignerConfidence": {},
"data.cuitDemographics.foreignerEvidence": {}
}API Reference
Accounts Count by CUIT
Get current CBU and CVU account totals for an Argentina CUIT via the gu1 holder intelligence marketplace service β billable per request when priced.
GET
/
integration-services
/
ar_gueno_holder_intelligence_service
/
cuits
/
:cuit
/
accounts-count
Accounts Count by CUIT
curl --request GET \
--url http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data.integrationCode": "<string>",
"data.cuit": "<string>",
"data.found": true,
"data.snapshotDate": {},
"data.lastChangedDate": {},
"data.isNew": true,
"data.cbuCount": 123,
"data.cvuCount": 123,
"data.totalAccounts": 123,
"data.cuitDemographics": {},
"data.cuitDemographics.prefix": "<string>",
"data.cuitDemographics.dni": "<string>",
"data.cuitDemographics.contributorType": "<string>",
"data.cuitDemographics.gender": {},
"data.cuitDemographics.cuitValid": true,
"data.cuitDemographics.ageRange": {},
"data.cuitDemographics.ageRangeConfidence": {},
"data.cuitDemographics.probableForeigner": {},
"data.cuitDemographics.foreignerConfidence": {},
"data.cuitDemographics.foreignerEvidence": {}
}Overview
Returns current CBU and CVU account totals for a holder, plus snapshot metadata. One billable request per successful call when the catalog product has a non-zero price.Endpoint
GET https://api.gu1.ai/api/integration-services/ar_gueno_holder_intelligence_service/cuits/{cuit}/accounts-count
Path parameters
string
required
Argentina CUIT/CUIL β 11 digits, no dashes.
Response
boolean
true on HTTP 200.string
ar_gueno_holder_intelligence_servicestring
Requested CUIT.
string | null
UTC consultation date (
YYYY-MM-DD) on which Gu1 obtained the totals.string | null
Latest date (
YYYY-MM-DD) on which this holderβs CBU/CVU totals changed.boolean
Whether the holder is flagged as new in the latest snapshot.
number
Current CBU account count (non-negative integer).
number
Current CVU account count (non-negative integer).
number
cbuCount + cvuCount.object
Low-confidence estimates derived from CUIT digits (computed at response time; not persisted).
Not proof of age or nationality β do not use as the sole approve/reject criterion.
string
Two-digit CUIT prefix (e.g.
20).string
Eight-digit body embedded in the CUIT.
string
natural_person | legal_entity | other.string | null
Inferred from prefix for natural persons:
male | female | null.boolean
AFIP check-digit validity.
[number, number] | null
Approximate age cohort
[min, max]. Always accompanied by ageRangeConfidence: "low" when present.
null for legal entities, foreigner document ranges (60Mβ69M, 90M+), or malformed DNI.string | null
low when ageRange is present; otherwise null.boolean | null
true for provisional foreigner (60Mβ69M, high confidence) or common foreign-resident (90M+, medium) ranges.
false for other natural-person ranges (low confidence β does not prove Argentine nationality).
null for legal entities / unrecognized types.string | null
low | medium | high | null.string | null
provisional_foreigner_tax_id_range | foreign_resident_dni_range | standard_dni_range | null.Errors
| HTTP | error.code | When |
|---|---|---|
| 404 | CUIT_NOT_FOUND | CUIT not in corpus |
| 402 | INSUFFICIENT_BALANCE | Credits or pack exhausted |
| 503 | SERVICE_UNAVAILABLE | Holder backend unavailable |
| 500 | INTERNAL_ERROR | Unexpected error |
Example
curl -s \
-H "Authorization: Bearer YOUR_API_KEY" \
"https://api.gu1.ai/api/integration-services/ar_gueno_holder_intelligence_service/cuits/20384648798/accounts-count"
{
"success": true,
"data": {
"integrationCode": "ar_gueno_holder_intelligence_service",
"cuit": "20384648798",
"found": true,
"snapshotDate": "2026-06-24",
"lastChangedDate": "2026-06-20",
"isNew": false,
"cbuCount": 3,
"cvuCount": 2,
"totalAccounts": 5,
"cuitDemographics": {
"prefix": "20",
"dni": "38464879",
"contributorType": "natural_person",
"gender": "male",
"cuitValid": true,
"ageRange": [26, 31],
"ageRangeConfidence": "low",
"probableForeigner": false,
"foreignerConfidence": "low",
"foreignerEvidence": "standard_dni_range"
}
}
}
Rules mapping
| API field | Rule field |
|---|---|
cbuCount | services.holder_intelligence.cbu_quantity |
cvuCount | services.holder_intelligence.cvu_quantity |
totalAccounts | services.holder_intelligence.total_accounts |
found | services.holder_intelligence.found |
snapshotDate | services.holder_intelligence.snapshot_date |
cuitDemographics is not exposed under services.holder_intelligence.*. On a CUIT
field, use tax_id_demographics_matches to combine age range and probable foreigner,
or the legacy tax_id_age_* operators. These conditions run locally and do not consume
Holder Intelligence.Was this page helpful?