> For the complete documentation index, see [llms.txt](https://yutax.gitbook.io/developer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yutax.gitbook.io/developer/api-reference/models.md).

# Models

## The ErrorResponse object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"string","description":"Código de error"},"message":{"type":"string","description":"Mensaje legible (cuando aplique)"}}}}}}
```

## The CurrencyCode object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"CurrencyCode":{"type":"string","description":"Si no viene, default USD","enum":["USD","EUR","GBP","DOP","CUP","MLC","OTHER"]}}}}
```

## The Catalogs object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"Catalogs":{"type":"object","description":"Catálogos (IDs ↔ name/code) según tu SQL","properties":{"account_type_catalog":{"type":"array","items":{"$ref":"#/components/schemas/AccountTypeCatalogItem"}},"account_status_catalog":{"type":"array","items":{"$ref":"#/components/schemas/AccountStatusCatalogItem"}},"responsibility_id_catalogo":{"type":"array","items":{"$ref":"#/components/schemas/ResponsibilityCatalogItem"}},"chargeback_tx_type_catalog":{"type":"array","items":{"$ref":"#/components/schemas/ChargebackTxTypeCatalogItem"}},"chargeoff_reason_catalog":{"type":"array","items":{"$ref":"#/components/schemas/ChargeoffReasonCatalogItem"}}}},"AccountTypeCatalogItem":{"type":"object","additionalProperties":false,"required":["account_type_id","name"],"properties":{"account_type_id":{"type":"integer"},"name":{"type":"string","enum":["debit","credit","wallet","saving","loan","store","subscription"]}}},"AccountStatusCatalogItem":{"type":"object","additionalProperties":false,"required":["status_id","name"],"properties":{"status_id":{"type":"integer"},"name":{"type":"string","enum":["open","closed","pending","inactive","suspended","blocked"]}}},"ResponsibilityCatalogItem":{"type":"object","additionalProperties":false,"required":["responsibility_id","name"],"properties":{"responsibility_id":{"type":"integer","enum":[1,2,3]},"name":{"type":"string","enum":["Individual","Authorized User","Business"]}}},"ChargebackTxTypeCatalogItem":{"type":"object","additionalProperties":false,"required":["id","code","name"],"properties":{"id":{"type":"integer"},"code":{"type":"string","enum":["DEPOSIT","P2P_TRANSFER","CARD_PURCHASE","ECOMMERCE","IN_STORE","WALLET_TRANSFER","ATM_WITHDRAWAL","DIGITAL_GOODS","SERVICES","CRYPTO","BNPL","OTHER"]},"name":{"type":"string"}}},"ChargeoffReasonCatalogItem":{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"integer"},"name":{"type":"string","enum":["fraud","non_payment","other"]}}}}}}
```

## The AccountTypeCatalogItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"AccountTypeCatalogItem":{"type":"object","additionalProperties":false,"required":["account_type_id","name"],"properties":{"account_type_id":{"type":"integer"},"name":{"type":"string","enum":["debit","credit","wallet","saving","loan","store","subscription"]}}}}}}
```

## The AccountStatusCatalogItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"AccountStatusCatalogItem":{"type":"object","additionalProperties":false,"required":["status_id","name"],"properties":{"status_id":{"type":"integer"},"name":{"type":"string","enum":["open","closed","pending","inactive","suspended","blocked"]}}}}}}
```

## The ResponsibilityCatalogItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ResponsibilityCatalogItem":{"type":"object","additionalProperties":false,"required":["responsibility_id","name"],"properties":{"responsibility_id":{"type":"integer","enum":[1,2,3]},"name":{"type":"string","enum":["Individual","Authorized User","Business"]}}}}}}
```

## The ChargebackTxTypeCatalogItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ChargebackTxTypeCatalogItem":{"type":"object","additionalProperties":false,"required":["id","code","name"],"properties":{"id":{"type":"integer"},"code":{"type":"string","enum":["DEPOSIT","P2P_TRANSFER","CARD_PURCHASE","ECOMMERCE","IN_STORE","WALLET_TRANSFER","ATM_WITHDRAWAL","DIGITAL_GOODS","SERVICES","CRYPTO","BNPL","OTHER"]},"name":{"type":"string"}}}}}}
```

## The ChargeoffReasonCatalogItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ChargeoffReasonCatalogItem":{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"integer"},"name":{"type":"string","enum":["fraud","non_payment","other"]}}}}}}
```

## The InquiriesRequest object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"InquiriesRequest":{"type":"object","additionalProperties":false,"required":["type","use_case","fullname","email","phone","ci"],"properties":{"type":{"type":"string","enum":["soft","hard"],"description":"Pull type"},"use_case":{"type":"string","maxLength":500,"description":"Código del inquiry purpose (debe existir en inquiry_purpose_catalog)"},"fullname":{"type":"string","maxLength":500,"description":"Nombre provisto por el cliente"},"phone":{"type":"string","maxLength":50},"email":{"type":"string","maxLength":160},"ci":{"type":"string","maxLength":20},"ip":{"type":"string","maxLength":60,"description":"IP opcional"}}}}}}
```

## The InquiriesMeta object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"InquiriesMeta":{"type":"object","additionalProperties":false,"required":["pull_type","use_case","generated_at"],"properties":{"pull_type":{"type":"string","enum":["soft","hard"]},"use_case":{"type":"string"},"generated_at":{"type":"string","format":"date-time"}}}}}}
```

## The IdentityBlock object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"IdentityBlock":{"type":"object","additionalProperties":false,"required":["status","full_name","query_name","match_confidence"],"properties":{"status":{"type":"string","enum":["match","verify","insufficient"]},"full_name":{"type":"string"},"query_name":{"type":"string"},"match_confidence":{"type":"number","format":"float","description":"Score/porcentaje (según tu name_match)"}}}}}}
```

## The ContactSignalPhone object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ContactSignalPhone":{"type":"object","additionalProperties":false,"required":["number","status"],"properties":{"number":{"type":"string","description":"Teléfono normalizado o como venga"},"status":{"type":"string","enum":["match","provided","unknown"]}}}}}}
```

## The ContactSignalEmail object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ContactSignalEmail":{"type":"object","additionalProperties":false,"required":["email","status"],"properties":{"email":{"type":"string"},"status":{"type":"string","enum":["match","provided","unknown"]}}}}}}
```

## The ContactSignals object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ContactSignals":{"type":"object","additionalProperties":false,"required":["phones","emails"],"properties":{"phones":{"type":"array","items":{"$ref":"#/components/schemas/ContactSignalPhone"}},"emails":{"type":"array","items":{"$ref":"#/components/schemas/ContactSignalEmail"}}}},"ContactSignalPhone":{"type":"object","additionalProperties":false,"required":["number","status"],"properties":{"number":{"type":"string","description":"Teléfono normalizado o como venga"},"status":{"type":"string","enum":["match","provided","unknown"]}}},"ContactSignalEmail":{"type":"object","additionalProperties":false,"required":["email","status"],"properties":{"email":{"type":"string"},"status":{"type":"string","enum":["match","provided","unknown"]}}}}}}
```

## The FraudSignals object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"FraudSignals":{"type":"object","additionalProperties":false,"required":["fraud_alert"],"properties":{"fraud_alert":{"type":"object","additionalProperties":false,"required":["present"],"properties":{"present":{"type":"boolean"}}}}}}}}
```

## The CreditSnapshot object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"CreditSnapshot":{"type":"object","additionalProperties":false,"required":["score","score_range","risk_level","negative_indicator_present"],"properties":{"score":{"type":"integer"},"score_range":{"type":"object","additionalProperties":false,"required":["min","max"],"properties":{"min":{"type":"integer"},"max":{"type":"integer"}}},"risk_level":{"type":"string","description":"Nivel según tu bucket"},"negative_indicator_present":{"type":"boolean","description":"true si bucket.max < 400 (según tu lógica)"}}}}}}
```

## The InquiriesResponseSoft object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"InquiriesResponseSoft":{"type":"object","additionalProperties":false,"required":["meta","identity","contact_signals","fraud_signals","credit_snapshot"],"properties":{"meta":{"$ref":"#/components/schemas/InquiriesMeta"},"identity":{"$ref":"#/components/schemas/IdentityBlock"},"contact_signals":{"$ref":"#/components/schemas/ContactSignals"},"fraud_signals":{"$ref":"#/components/schemas/FraudSignals"},"credit_snapshot":{"$ref":"#/components/schemas/CreditSnapshot"}}},"InquiriesMeta":{"type":"object","additionalProperties":false,"required":["pull_type","use_case","generated_at"],"properties":{"pull_type":{"type":"string","enum":["soft","hard"]},"use_case":{"type":"string"},"generated_at":{"type":"string","format":"date-time"}}},"IdentityBlock":{"type":"object","additionalProperties":false,"required":["status","full_name","query_name","match_confidence"],"properties":{"status":{"type":"string","enum":["match","verify","insufficient"]},"full_name":{"type":"string"},"query_name":{"type":"string"},"match_confidence":{"type":"number","format":"float","description":"Score/porcentaje (según tu name_match)"}}},"ContactSignals":{"type":"object","additionalProperties":false,"required":["phones","emails"],"properties":{"phones":{"type":"array","items":{"$ref":"#/components/schemas/ContactSignalPhone"}},"emails":{"type":"array","items":{"$ref":"#/components/schemas/ContactSignalEmail"}}}},"ContactSignalPhone":{"type":"object","additionalProperties":false,"required":["number","status"],"properties":{"number":{"type":"string","description":"Teléfono normalizado o como venga"},"status":{"type":"string","enum":["match","provided","unknown"]}}},"ContactSignalEmail":{"type":"object","additionalProperties":false,"required":["email","status"],"properties":{"email":{"type":"string"},"status":{"type":"string","enum":["match","provided","unknown"]}}},"FraudSignals":{"type":"object","additionalProperties":false,"required":["fraud_alert"],"properties":{"fraud_alert":{"type":"object","additionalProperties":false,"required":["present"],"properties":{"present":{"type":"boolean"}}}}},"CreditSnapshot":{"type":"object","additionalProperties":false,"required":["score","score_range","risk_level","negative_indicator_present"],"properties":{"score":{"type":"integer"},"score_range":{"type":"object","additionalProperties":false,"required":["min","max"],"properties":{"min":{"type":"integer"},"max":{"type":"integer"}}},"risk_level":{"type":"string","description":"Nivel según tu bucket"},"negative_indicator_present":{"type":"boolean","description":"true si bucket.max < 400 (según tu lógica)"}}}}}}
```

## The InquiriesAccountItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"InquiriesAccountItem":{"type":"object","additionalProperties":false,"required":["report_id","type","status"],"properties":{"report_id":{"type":"integer"},"type":{"type":"string","enum":["debit","credit","wallet","saving","loan","store","subscription","unknown"]},"status":{"type":"string","enum":["open","closed","pending","inactive","suspended","blocked","unknown"]}}}}}}
```

## The NegativeChargebackItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"NegativeChargebackItem":{"type":"object","additionalProperties":false,"required":["chargeback_id","transaction_type","amount","posting_date","notes"],"properties":{"chargeback_id":{"type":"integer"},"transaction_type":{"type":"string","description":"El server lo manda en lowercase del code (ej- p2p_transfer)"},"amount":{"type":"object","additionalProperties":false,"required":["value","currency"],"properties":{"value":{"type":"number","format":"float"},"currency":{"$ref":"#/components/schemas/CurrencyCode"}}},"posting_date":{"type":"string","description":"DateTime string"},"notes":{"type":"string"}}},"CurrencyCode":{"type":"string","description":"Si no viene, default USD","enum":["USD","EUR","GBP","DOP","CUP","MLC","OTHER"]}}}}
```

## The NegativeChargeoffItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"NegativeChargeoffItem":{"type":"object","additionalProperties":false,"required":["chargeoff_id","original_amount","open_date","posting_date","chargeoff_reason","notes"],"properties":{"chargeoff_id":{"type":"integer"},"original_amount":{"type":"object","additionalProperties":false,"required":["value","currency"],"properties":{"value":{"type":"number","format":"float"},"currency":{"$ref":"#/components/schemas/CurrencyCode"}}},"open_date":{"type":"string","nullable":true},"posting_date":{"type":"string"},"chargeoff_reason":{"type":"string","enum":["fraud","non_payment","other"]},"notes":{"type":"string"}}},"CurrencyCode":{"type":"string","description":"Si no viene, default USD","enum":["USD","EUR","GBP","DOP","CUP","MLC","OTHER"]}}}}
```

## The InquiriesHistoryItem object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"InquiriesHistoryItem":{"type":"object","additionalProperties":false,"required":["inquiry_id","business_name","type","inquiry_purpose","date"],"properties":{"inquiry_id":{"type":"integer"},"business_name":{"type":"string"},"type":{"type":"string","enum":["HARD"]},"inquiry_purpose":{"type":"string"},"date":{"type":"string","format":"date"}}}}}}
```

## The InquiriesResponseHard object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"InquiriesResponseHard":{"allOf":[{"$ref":"#/components/schemas/InquiriesResponseSoft"},{"type":"object","additionalProperties":false,"required":["accounts","negative_items","inquiries"],"properties":{"accounts":{"type":"object","additionalProperties":false,"required":["count","oldest_account_date","items"],"properties":{"count":{"type":"integer"},"oldest_account_date":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/InquiriesAccountItem"}}}},"negative_items":{"type":"object","additionalProperties":false,"required":["counts","chargebacks","chargeoffs"],"properties":{"counts":{"type":"object","additionalProperties":false,"required":["chargebacks","chargeoffs"],"properties":{"chargebacks":{"type":"integer"},"chargeoffs":{"type":"integer"}}},"chargebacks":{"type":"array","items":{"$ref":"#/components/schemas/NegativeChargebackItem"}},"chargeoffs":{"type":"array","items":{"$ref":"#/components/schemas/NegativeChargeoffItem"}}}},"inquiries":{"type":"array","items":{"$ref":"#/components/schemas/InquiriesHistoryItem"}}}}]},"InquiriesResponseSoft":{"type":"object","additionalProperties":false,"required":["meta","identity","contact_signals","fraud_signals","credit_snapshot"],"properties":{"meta":{"$ref":"#/components/schemas/InquiriesMeta"},"identity":{"$ref":"#/components/schemas/IdentityBlock"},"contact_signals":{"$ref":"#/components/schemas/ContactSignals"},"fraud_signals":{"$ref":"#/components/schemas/FraudSignals"},"credit_snapshot":{"$ref":"#/components/schemas/CreditSnapshot"}}},"InquiriesMeta":{"type":"object","additionalProperties":false,"required":["pull_type","use_case","generated_at"],"properties":{"pull_type":{"type":"string","enum":["soft","hard"]},"use_case":{"type":"string"},"generated_at":{"type":"string","format":"date-time"}}},"IdentityBlock":{"type":"object","additionalProperties":false,"required":["status","full_name","query_name","match_confidence"],"properties":{"status":{"type":"string","enum":["match","verify","insufficient"]},"full_name":{"type":"string"},"query_name":{"type":"string"},"match_confidence":{"type":"number","format":"float","description":"Score/porcentaje (según tu name_match)"}}},"ContactSignals":{"type":"object","additionalProperties":false,"required":["phones","emails"],"properties":{"phones":{"type":"array","items":{"$ref":"#/components/schemas/ContactSignalPhone"}},"emails":{"type":"array","items":{"$ref":"#/components/schemas/ContactSignalEmail"}}}},"ContactSignalPhone":{"type":"object","additionalProperties":false,"required":["number","status"],"properties":{"number":{"type":"string","description":"Teléfono normalizado o como venga"},"status":{"type":"string","enum":["match","provided","unknown"]}}},"ContactSignalEmail":{"type":"object","additionalProperties":false,"required":["email","status"],"properties":{"email":{"type":"string"},"status":{"type":"string","enum":["match","provided","unknown"]}}},"FraudSignals":{"type":"object","additionalProperties":false,"required":["fraud_alert"],"properties":{"fraud_alert":{"type":"object","additionalProperties":false,"required":["present"],"properties":{"present":{"type":"boolean"}}}}},"CreditSnapshot":{"type":"object","additionalProperties":false,"required":["score","score_range","risk_level","negative_indicator_present"],"properties":{"score":{"type":"integer"},"score_range":{"type":"object","additionalProperties":false,"required":["min","max"],"properties":{"min":{"type":"integer"},"max":{"type":"integer"}}},"risk_level":{"type":"string","description":"Nivel según tu bucket"},"negative_indicator_present":{"type":"boolean","description":"true si bucket.max < 400 (según tu lógica)"}}},"InquiriesAccountItem":{"type":"object","additionalProperties":false,"required":["report_id","type","status"],"properties":{"report_id":{"type":"integer"},"type":{"type":"string","enum":["debit","credit","wallet","saving","loan","store","subscription","unknown"]},"status":{"type":"string","enum":["open","closed","pending","inactive","suspended","blocked","unknown"]}}},"NegativeChargebackItem":{"type":"object","additionalProperties":false,"required":["chargeback_id","transaction_type","amount","posting_date","notes"],"properties":{"chargeback_id":{"type":"integer"},"transaction_type":{"type":"string","description":"El server lo manda en lowercase del code (ej- p2p_transfer)"},"amount":{"type":"object","additionalProperties":false,"required":["value","currency"],"properties":{"value":{"type":"number","format":"float"},"currency":{"$ref":"#/components/schemas/CurrencyCode"}}},"posting_date":{"type":"string","description":"DateTime string"},"notes":{"type":"string"}}},"CurrencyCode":{"type":"string","description":"Si no viene, default USD","enum":["USD","EUR","GBP","DOP","CUP","MLC","OTHER"]},"NegativeChargeoffItem":{"type":"object","additionalProperties":false,"required":["chargeoff_id","original_amount","open_date","posting_date","chargeoff_reason","notes"],"properties":{"chargeoff_id":{"type":"integer"},"original_amount":{"type":"object","additionalProperties":false,"required":["value","currency"],"properties":{"value":{"type":"number","format":"float"},"currency":{"$ref":"#/components/schemas/CurrencyCode"}}},"open_date":{"type":"string","nullable":true},"posting_date":{"type":"string"},"chargeoff_reason":{"type":"string","enum":["fraud","non_payment","other"]},"notes":{"type":"string"}}},"InquiriesHistoryItem":{"type":"object","additionalProperties":false,"required":["inquiry_id","business_name","type","inquiry_purpose","date"],"properties":{"inquiry_id":{"type":"integer"},"business_name":{"type":"string"},"type":{"type":"string","enum":["HARD"]},"inquiry_purpose":{"type":"string"},"date":{"type":"string","format":"date"}}}}}}
```

## The AccountsCreateRequest object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"AccountsCreateRequest":{"type":"object","additionalProperties":false,"required":["account_id","fullname","account_name","account_type_id","responsibility_id","open_date","status_id"],"anyOf":[{"required":["email"]},{"required":["phone"]}],"properties":{"account_id":{"type":"string","maxLength":80},"fullname":{"type":"string","maxLength":150},"account_name":{"type":"string","maxLength":160},"ci":{"type":"string","maxLength":50},"email":{"type":"string","maxLength":190,"description":"Requerido si phone vacío (regla- email o phone)"},"phone":{"type":"string","maxLength":40,"description":"Requerido si email vacío (regla- email o phone)"},"account_type_id":{"type":"integer","enum":[1,2,3,4,5,6,7],"description":"Tipo de cuenta.\n1=debit, 2=credit, 3=wallet, 4=saving, 5=loan, 6=store, 7=subscription\n"},"responsibility_id":{"type":"integer","enum":[1,2,3],"description":"responsibility_id (catálogo):\n1=Individual, 2=Authorized User, 3=Business\n"},"open_date":{"type":"string","description":"YYYY-MM-DD"},"status_id":{"type":"integer","enum":[1,2,3,4,5,6],"description":"status_id (catálogo):\n1=open, 2=closed, 3=pending, 4=inactive, 5=suspended, 6=blocked\n"},"address":{"type":"string","maxLength":255},"account_amount":{"type":"string","nullable":true,"description":"Decimal como string (para MySQL)"},"notes":{"type":"string","maxLength":2000}}}}}}
```

## The AccountsCreateResponse object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"AccountsCreateResponse":{"type":"object","additionalProperties":false,"required":["ok","mode","business_id","updated_at"],"properties":{"ok":{"type":"boolean"},"mode":{"type":"string","enum":["single"]},"business_id":{"type":"integer"},"report_id":{"type":"integer","nullable":true,"description":"ID autoincrement (report_id) asignado/actualizado"},"updated_at":{"type":"string"}}}}}}
```

## The AccountsBulkRequest object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"AccountsBulkRequest":{"type":"object","additionalProperties":false,"required":["mode","columns","rows"],"properties":{"mode":{"type":"string","enum":["upsert"]},"columns":{"type":"array","items":{"type":"string"},"description":"Columnas permitidas: account_id, fullname, ci, email, phone, address, account_name, account_type_id, account_amount, responsibility_id, open_date, status_id, notes\n"},"rows":{"type":"array","items":{"type":"array","items":{}},"description":"Array de filas, cada fila debe tener el mismo largo que columns"}}}}}}
```

## The AccountsBulkResponse object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"AccountsBulkResponse":{"type":"object","additionalProperties":false,"required":["ok","mode","gzip_required","business_id","received_rows","processed_rows","failed_rows","chunk_size","max_rows","updated_at","results","errors"],"properties":{"ok":{"type":"boolean"},"mode":{"type":"string","enum":["bulk"]},"gzip_required":{"type":"boolean"},"business_id":{"type":"integer"},"received_rows":{"type":"integer"},"processed_rows":{"type":"integer"},"failed_rows":{"type":"integer"},"chunk_size":{"type":"integer"},"max_rows":{"type":"integer"},"updated_at":{"type":"string"},"results":{"type":"array","description":"Tabla [account_id, report_id] con header como primer row","items":{"type":"array","items":{}}},"errors":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}
```

## The AccountsBulkNdjsonResponse object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"AccountsBulkNdjsonResponse":{"type":"object","additionalProperties":false,"required":["ok","time","mode","gzip_required","business_id","received_rows","processed_rows","failed_rows","chunk_size","max_rows","updated_at","results","errors"],"properties":{"ok":{"type":"boolean"},"mode":{"type":"string","enum":["bulk_ndjson"]},"gzip_required":{"type":"boolean"},"business_id":{"type":"integer"},"received_rows":{"type":"integer"},"processed_rows":{"type":"integer"},"failed_rows":{"type":"integer"},"chunk_size":{"type":"integer"},"max_rows":{"type":"integer"},"updated_at":{"type":"string"},"results":{"type":"array","items":{"type":"array","items":{}}},"errors":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}
```

## The ChargebackCreateRequest object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ChargebackCreateRequest":{"type":"object","additionalProperties":false,"required":["fullname","user_report_id","user_account_id","original_transaction_id","transaction_date","posting_date","transaction_amount","transaction_currency","transaction_type_code"],"allOf":[{"anyOf":[{"required":["email"]},{"required":["phone"]}]},{"anyOf":[{"required":["user_report_id"]},{"required":["user_account_id"]}]}],"properties":{"fullname":{"type":"string","maxLength":150},"ci":{"type":"string","maxLength":50},"email":{"type":"string","maxLength":190,"description":"Requerido si phone vacío (regla - email or phone)"},"phone":{"type":"string","maxLength":40,"description":"Requerido si type vacío (regla - email or phone)"},"address":{"type":"string","maxLength":255},"user_report_id":{"type":"integer","nullable":true,"description":"Offender por report_id (alternativa a user_account_id)"},"user_account_id":{"type":"integer","nullable":true,"description":"Offender por account_id (alternativa a user_report_id)"},"user_victim_report_id":{"type":"integer","nullable":true,"description":"Victim por report_id (alternativa a user_victim_account_id)"},"user_victim_account_id":{"type":"integer","nullable":true,"description":"Victim por account_id (alternativa a user_victim_report_id)"},"original_transaction_id":{"type":"string","maxLength":100},"transaction_date":{"type":"string","description":"YYYY-MM-DD o YYYY-MM-DD HH:MM:SS"},"posting_date":{"type":"string","description":"YYYY-MM-DD o YYYY-MM-DD HH:MM:SS"},"transaction_amount":{"type":"string","description":"Decimal como string"},"transaction_currency":{"$ref":"#/components/schemas/CurrencyCode"},"transaction_type_code":{"type":"string","enum":["DEPOSIT","P2P_TRANSFER","CARD_PURCHASE","ECOMMERCE","IN_STORE","WALLET_TRANSFER","ATM_WITHDRAWAL","DIGITAL_GOODS","SERVICES","CRYPTO","BNPL","OTHER"],"description":"CODE del catálogo chargeback_tx_type_catalog.\nEj: P2P_TRANSFER = \"P2P Transfer\"\n"},"notes":{"type":"string","maxLength":5000}}},"CurrencyCode":{"type":"string","description":"Si no viene, default USD","enum":["USD","EUR","GBP","DOP","CUP","MLC","OTHER"]}}}}
```

## The ChargebackCreateResponse object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ChargebackCreateResponse":{"type":"object","additionalProperties":false,"required":["ok","chargeback_id","business_id","created_at","transaction_type","allowed_currencies"],"properties":{"ok":{"type":"boolean"},"chargeback_id":{"type":"integer"},"business_id":{"type":"integer"},"created_at":{"type":"string"},"transaction_type":{"type":"object","additionalProperties":false,"required":["code","id"],"properties":{"code":{"type":"string"},"id":{"type":"integer"}}},"allowed_currencies":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyCode"}}}},"CurrencyCode":{"type":"string","description":"Si no viene, default USD","enum":["USD","EUR","GBP","DOP","CUP","MLC","OTHER"]}}}}
```

## The ChargeoffCreateRequest object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ChargeoffCreateRequest":{"type":"object","additionalProperties":false,"required":["user_report_id","user_account_id","chargeoff_amount","chargeoff_reason_id","posting_date"],"properties":{"user_report_id":{"type":"integer","nullable":true,"description":"Requerido si ni viene user_account_id"},"user_account_id":{"type":"integer","nullable":true,"description":"Requerido si ni viene user_report_id"},"chargeoff_amount":{"type":"string","description":"Decimal como string"},"chargeoff_reason_id":{"type":"integer","enum":[1,2,3],"description":"chargeoff_reason_id (catálogo): \n1=fraud, 2=non_payment, 3=other\n"},"amount_currency":{"$ref":"#/components/schemas/CurrencyCode","description":"Si no viene, default USD"},"posting_date":{"type":"string","description":"YYYY-MM-DD o YYYY-MM-DD HH:MM:SS"},"notes":{"type":"string","maxLength":5000}}},"CurrencyCode":{"type":"string","description":"Si no viene, default USD","enum":["USD","EUR","GBP","DOP","CUP","MLC","OTHER"]}}}}
```

## The ChargeoffCreateResponse object

```json
{"openapi":"3.0.3","info":{"title":"Yutax API","version":"1.0.0"},"components":{"schemas":{"ChargeoffCreateResponse":{"type":"object","additionalProperties":false,"required":["ok","chargeoff_id","business_id","created_at","data","allowed_currencies"],"properties":{"ok":{"type":"boolean"},"chargeoff_id":{"type":"integer"},"business_id":{"type":"integer"},"created_at":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["account_report_id","chargeoff_amount","amount_currency","chargeoff_reason_id","chargeoff_reason_name","posting_date","notes"],"properties":{"account_report_id":{"type":"integer"},"chargeoff_amount":{"type":"number","format":"float"},"amount_currency":{"$ref":"#/components/schemas/CurrencyCode"},"chargeoff_reason_id":{"type":"integer"},"chargeoff_reason_name":{"type":"string","enum":["fraud","non_payment","other"]},"posting_date":{"type":"string","nullable":true},"notes":{"type":"string"}}},"allowed_currencies":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyCode"}}}},"CurrencyCode":{"type":"string","description":"Si no viene, default USD","enum":["USD","EUR","GBP","DOP","CUP","MLC","OTHER"]}}}}
```