> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Accounts Count by CUIT

> Current CBU and CVU totals for an Argentina CUIT — billable per request when the product is priced.

## 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

<ParamField path="cuit" type="string" required>
  Argentina CUIT/CUIL — **11 digits**, no dashes.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  `true` on HTTP 200.
</ResponseField>

<ResponseField name="data.integrationCode" type="string">
  `ar_gueno_holder_intelligence_service`
</ResponseField>

<ResponseField name="data.cuit" type="string">
  Requested CUIT.
</ResponseField>

<ResponseField name="data.found" type="boolean">
  Always `true` on HTTP 200 success (use [Exists](/en/api-reference/services/ar-gueno-holder-intelligence/exists) for a non-billable membership check).
</ResponseField>

<ResponseField name="data.snapshotDate" type="string | null">
  Corpus snapshot date (`YYYY-MM-DD`) for the totals.
</ResponseField>

<ResponseField name="data.firstSeen" type="string | null">
  First date the holder appeared in corpus (`YYYY-MM-DD`).
</ResponseField>

<ResponseField name="data.lastSeen" type="string | null">
  Last date the holder was observed (`YYYY-MM-DD`).
</ResponseField>

<ResponseField name="data.isNew" type="boolean">
  Whether the holder is flagged as new in the latest snapshot.
</ResponseField>

<ResponseField name="data.cbuCount" type="number">
  Current CBU account count (non-negative integer).
</ResponseField>

<ResponseField name="data.cvuCount" type="number">
  Current CVU account count (non-negative integer).
</ResponseField>

<ResponseField name="data.totalAccounts" type="number">
  `cbuCount + cvuCount`.
</ResponseField>

## 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

```bash theme={null}
curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.gu1.ai/api/integration-services/ar_gueno_holder_intelligence_service/cuits/20384648798/accounts-count"
```

```json theme={null}
{
  "success": true,
  "data": {
    "integrationCode": "ar_gueno_holder_intelligence_service",
    "cuit": "20384648798",
    "found": true,
    "snapshotDate": "2026-06-24",
    "firstSeen": "2024-01-15",
    "lastSeen": "2026-06-24",
    "isNew": false,
    "cbuCount": 3,
    "cvuCount": 2,
    "totalAccounts": 5
  }
}
```

## 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`  |
