Skip to main content
GET
/
integration-services
/
ar_gueno_holder_intelligence_service
/
cuits
/
:cuit
/
metrics
Custom Metrics by CUIT
curl --request GET \
  --url http://api.gu1.ai/integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/metrics \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data.complete": true,
  "data.lookbackDays": 123,
  "data.referenceDate": "<string>",
  "data.windowStart": "<string>",
  "data.windowEnd": "<string>",
  "data.metrics": {}
}

​
Overview

Returns custom incremental metrics for a calendar lookback ending on a reference date: deltas, % change, daily variance, and acceleration when enough history exists. One billable request per successful call when priced.

​
Endpoint

GET https://api.gu1.ai/api/integration-services/ar_gueno_holder_intelligence_service/cuits/{cuit}/metrics

​
Path parameters

​
cuit
string
required
Argentina CUIT/CUIL — 11 digits, no dashes.

​
Query parameters

​
lookback
integer
required
Calendar days in the window (1–180, inclusive).
​
date
string
Optional. Inclusive window end (YYYY-MM-DD). Defaults to latest corpus date when omitted.

​
Success response (HTTP 200)

​
success
boolean
true
​
data.complete
boolean
Always true on success.
​
data.lookbackDays
number
Echo of requested lookback.
​
data.referenceDate
string
Inclusive window end (YYYY-MM-DD).
​
data.windowStart
string
Window start date (YYYY-MM-DD).
​
data.windowEnd
string
Window end date (YYYY-MM-DD), same as reference date.
​
data.metrics
object
  • cbuTotalStart, cbuTotalEnd, cvuTotalStart, cvuTotalEnd (numbers)
  • cbuDelta, cvuDelta (numbers)
  • cbuPctChange, cvuPctChange (number | null)
  • daysWithChanges (number)
  • cbuDailyDeltaVariance, cvuDailyDeltaVariance (number | null)
  • cbuAcceleration, cvuAcceleration, totalAcceleration (number | null)
  • accelerationAvailable (boolean) — when false, acceleration fields are null

​
Incomplete window (HTTP 422)

When incremental state cannot satisfy the lookback, the API returns success: false with a partial data payload:
error.codeMeaning
INCOMPLETE_WINDOWMissing daily snapshots in the requested range (missingDates may be listed)
NO_INCREMENTAL_STATENo incremental history for this CUIT
Example: 
{
  "success": false,
  "error": {
    "code": "INCOMPLETE_WINDOW",
    "message": "Incremental window incomplete for the requested lookback"
  },
  "data": {
    "integrationCode": "ar_gueno_holder_intelligence_service",
    "cuit": "20384648798",
    "complete": false,
    "error": "incomplete_window",
    "lookbackDays": 30,
    "referenceDate": "2026-06-24",
    "windowStart": "2026-05-26",
    "windowEnd": "2026-06-24",
    "missingDates": ["2026-05-27"]
  }
}

​
Other errors

HTTPerror.codeWhen
400INVALID_LOOKBACKlookback missing or outside 1–180
400INVALID_DATEMalformed date
404CUIT_NOT_FOUNDCUIT not in corpus
402INSUFFICIENT_BALANCECredits or pack exhausted
503SERVICE_UNAVAILABLEHolder backend unavailable
500INTERNAL_ERRORUnexpected error

​
Example

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.gu1.ai/api/integration-services/ar_gueno_holder_intelligence_service/cuits/20384648798/metrics?lookback=7&date=2026-06-24"

{
  "success": true,
  "data": {
    "integrationCode": "ar_gueno_holder_intelligence_service",
    "cuit": "20384648798",
    "complete": true,
    "referenceDate": "2026-06-24",
    "lookbackDays": 7,
    "windowStart": "2026-06-18",
    "windowEnd": "2026-06-24",
    "metrics": {
      "cbuTotalStart": 2,
      "cbuTotalEnd": 3,
      "cvuTotalStart": 1,
      "cvuTotalEnd": 2,
      "cbuDelta": 1,
      "cvuDelta": 1,
      "cbuPctChange": 50.0,
      "cvuPctChange": 100.0,
      "daysWithChanges": 2,
      "cbuDailyDeltaVariance": 0.1,
      "cvuDailyDeltaVariance": 0.05,
      "cbuAcceleration": 0.5,
      "cvuAcceleration": 0.3,
      "totalAcceleration": 0.8,
      "accelerationAvailable": true
    }
  }
}

​
Rules engine

Metrics conditions require holderIntelligenceLookbackDays (1–180) on the rule condition.
API / block fieldRule field (examples)
metrics.cbuAccelerationservices.holder_intelligence.metrics.cbu_acceleration
metrics.cbuPctChangeservices.holder_intelligence.metrics.cbu_pct_change
metrics.totalAccelerationservices.holder_intelligence.metrics.total_acceleration
completeservices.holder_intelligence.metrics.complete
Transaction rules: the reference date defaults to transactedAt converted to Argentina calendar date unless you set holderIntelligenceReferenceDateField on the condition. See Rules conditions.