Contractual Windows by CUIT
API Reference
Contractual Windows by CUIT
Contractual CBU/CVU change windows (w_1d through w_180d) for an Argentina CUIT β billable per request when priced.
GET
Contractual Windows by CUIT
Overview
Returns contractual lookback windows with CBU/CVU deltas, days with changes, variance, and comparison vs previous window. One billable request per successful call when priced.Endpoint
Path parameters
Argentina CUIT/CUIL β 11 digits, no dashes.
Query parameters
Optional. Return a single window key instead of the full map. Allowed values:
w_1d, w_3d, w_7d, w_14d, w_21d, w_30d, w_90d, w_180d.Optional. Reference calendar date (
YYYY-MM-DD) for the window end. Defaults to latest corpus date when omitted.Response
true on HTTP 200.ar_gueno_holder_intelligence_serviceRequested CUIT.
Reference date for the window set (
YYYY-MM-DD).Present when
?window= filter was applied β echoes the requested key.Map of window keys to metrics objects (or
null when data is unavailable for that window).Each window object:days(number) β window length in dayscbuDelta(number | null) β net CBU change in the windowcvuDelta(number | null) β net CVU change in the windowdaysWithChanges(number | null) β days with any deltavariance(number | null) β variance of daily deltasdiffVsPrev(number | null) β comparison vs previous contractual window
Errors
| HTTP | error.code | When |
|---|---|---|
| 400 | INVALID_WINDOW | Unknown window query value |
| 400 | INVALID_DATE | Malformed date query |
| 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 β all windows
Example β single window
Rules mapping
Rule paths use snake_case underservices.holder_intelligence.windows.{key}.*, for example:
services.holder_intelligence.windows.w_7d.cbu_deltaservices.holder_intelligence.windows.w_7d.days_with_changes