Independently review calculated mortgage terms and cost evidence

POST/originations/{origin}/disclosures/{disclosure}/review

Path parameters

originstringRequired

disclosurestringRequired

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

approvebooleanRequired

reasonstringRequired

Returns

200 OK

decisionobject or nullOptional

4 child attributes

actorstringRequired

approvebooleanRequired

atstring · date-timeRequired

reasonstringRequired

deliveriesarray of objectsRequired

7 child attributes

consent_sha256stringOptional

evidence_sha256stringRequired

methodstringRequired

In_person, mail, electronic

partystringRequired

provider_listobject or nullOptional

2 child attributes

revision_idstringRequired

sha256stringRequired

received_atstring · date-time or nullOptional

sent_atstring · date-timeRequired

issueobject or nullOptional

7 child attributes

actorstringRequired

atstring · date-timeRequired

provider_listobject or nullOptional

3 child attributes

revision_idstringRequired

sha256stringRequired

templatestringRequired

retain_throughstring · dateRequired

A business date, YYYY-MM-DD

revision_idstringRequired

sha256stringRequired

templatestringRequired

revisionobjectRequired

13 child attributes

calculationobjectRequired

14 child attributes

amount_financed_amountintegerRequired

aprstringRequired

apr_lowerstringRequired

apr_upperstringRequired

cash_to_close_amountintegerRequired

closing_costs_amountintegerRequired

finance_charge_amountintegerRequired

five_year_principal_amountintegerRequired

five_year_total_amountintegerRequired

origination_amountintegerRequired

paymentsarray of objectsRequired

5 child attributes

amountintegerRequired

balance_amountintegerRequired

datestring · dateRequired

A business date, YYYY-MM-DD

interest_amountintegerRequired

principal_amountintegerRequired

tipstringRequired

total_interest_amountintegerRequired

total_payments_amountintegerRequired

changeobject or nullOptional

5 child attributes

affected_cost_idsarray of stringsRequired

evidence_sha256stringRequired

kindstringRequired

known_atstring · date-timeRequired

reasonstringRequired

costsarray of objectsRequired

19 child attributes

affiliatebooleanRequired

amountintegerRequired

bona_fide_reasonablebooleanRequired

can_shopbooleanRequired

categorystringRequired

evidence_sha256stringRequired

idstringRequired

insurer_choice_disclosedbooleanRequired

labelstringRequired

on_provider_listbooleanRequired

paid_before_amountintegerRequired

paid_before_atstring · date-time or nullOptional

paid_bystringRequired

Borrower, seller, other

payeestringRequired

prepaid_monthsintegerOptional

recording_deed_amountintegerOptional

recording_mortgage_amountintegerOptional

requiredbooleanRequired

shoppedboolean or nullOptional

created_atstring · date-timeRequired

idstringRequired

kindstringRequired

makerstringRequired

numberintegerRequired

origination_idstringRequired

previous_idstringOptional

provider_listobject or nullOptional

2 child attributes

reuseobject or nullOptional

2 child attributes

revision_idstringRequired

sha256stringRequired

servicesarray of objectsOptional

3 child attributes

cost_idstringRequired

estimated_provider_idstringRequired

providersarray of objectsRequired

provider_selectionsarray of objectsOptional

6 child attributes

cost_idstringRequired

evidence_sha256stringRequired

listobjectRequired

2 child attributes

revision_idstringRequired

sha256stringRequired

providerobjectRequired

9 child attributes

addressstringRequired

affiliatedboolean or nullOptional

evidence_sha256stringRequired

idstringRequired

in_businessboolean or nullOptional

namestringRequired

phonestringRequired

serves_propertyboolean or nullOptional

verified_atstring · date-timeRequired

selected_atstring · date-timeRequired

selected_bystringRequired

termsobjectRequired

51 child attributes

annual_home_insurance_amountintegerRequired

annual_other_property_cost_amountintegerRequired

annual_property_tax_amountintegerRequired

assumableboolean or nullOptional

These facts require independent confirmation against the note and applicable state law.

borrower_mailing_addressstringRequired

buyer_brokerobject or nullOptional

9 child attributes

addressstringRequired

emailstringRequired

license_idstringOptional

namestringRequired

nmls_idstringOptional

personstringRequired

person_license_idstringOptional

person_nmls_idstringOptional

phonestringRequired

consummation_datestring · dateRequired

A business date, YYYY-MM-DD

contract_sha256stringRequired

deficiency_protectionboolean or nullOptional

deposit_amountintegerRequired

deposit_holderstringRequired

escrow_adjustment_amountintegerRequired

escrow_declinedbooleanRequired

escrow_linesarray of objectsRequired

3 child attributes

kindstringRequired

monthly_amountintegerRequired

monthsintegerRequired

escrow_monthly_amountintegerRequired

escrow_waiver_fee_amountintegerRequired

estimate_expires_atstring · date-timeRequired

featuresarray of stringsRequired

first_payment_datestring · dateRequired

A business date, YYYY-MM-DD

funding_datestring · dateRequired

A business date, YYYY-MM-DD

grace_daysintegerRequired

initial_escrow_amountintegerRequired

insurance_escrowedbooleanRequired

late_fee_amountintegerRequired

lender_contactobjectRequired

9 child attributes

addressstringRequired

emailstringRequired

license_idstringOptional

namestringRequired

nmls_idstringOptional

personstringRequired

person_license_idstringOptional

person_nmls_idstringOptional

phonestringRequired

lender_credit_amountintegerRequired

mortgage_brokerobject or nullOptional

9 child attributes

addressstringRequired

emailstringRequired

license_idstringOptional

namestringRequired

nmls_idstringOptional

personstringRequired

person_license_idstringOptional

person_nmls_idstringOptional

phonestringRequired

other_escrowedbooleanRequired

other_property_cost_labelstringRequired

partial_paymentsstringRequired

partiesarray of stringsRequired

principal_amountintegerRequired

profilestringRequired

property_addressstringRequired

property_value_amountintegerRequired

property_value_basisstringRequired

purposestringRequired

rate_bpsintegerRequired

rate_lock_expires_atstring · date-time or nullOptional

rate_lockedboolean or nullOptional

sale_price_amountintegerRequired

seller_addressstringRequired

seller_brokerobject or nullOptional

9 child attributes

addressstringRequired

emailstringRequired

license_idstringOptional

namestringRequired

nmls_idstringOptional

personstringRequired

person_license_idstringOptional

person_nmls_idstringOptional

phonestringRequired

seller_credit_amountintegerRequired

seller_namestringRequired

servicingstringRequired

settlement_agentobjectRequired

9 child attributes

addressstringRequired

emailstringRequired

license_idstringOptional

namestringRequired

nmls_idstringOptional

personstringRequired

person_license_idstringOptional

person_nmls_idstringOptional

phonestringRequired

settlement_file_numberstringRequired

statestringRequired

tax_escrowedbooleanRequired

term_monthsintegerRequired

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/originations/{origin}/disclosures/{disclosure}/review' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "approve": false,
    "reason": "string"
  }'

Response200

{
  "decision": {
    "actor": "string",
    "approve": false,
    "at": "2026-09-17T14:30:00Z",
    "reason": "string"
  },
  "deliveries": [
    {
      "consent_sha256": "string",
      "evidence_sha256": "string",
      "method": "string",
      "party": "string",
      "provider_list": {
        "revision_id": "string",
        "sha256": "string"
      },
      "received_at": "2026-09-17T14:30:00Z",
      "sent_at": "2026-09-17T14:30:00Z"
    }
  ],
  "issue": {
    "actor": "string",
    "at": "2026-09-17T14:30:00Z",
    "provider_list": {
      "revision_id": "string",
      "sha256": "string",
      "template": "string"
    },
    "retain_through": "2026-09-17",
    "revision_id": "string",
    "sha256": "string",
    "template": "string"
  },
  "revision": {
    "calculation": {
      "amount_financed_amount": 10000,
      "apr": "string",
      "apr_lower": "string",
      "apr_upper": "string",
      "cash_to_close_amount": 10000,
      "closing_costs_amount": 10000,
      "finance_charge_amount": 10000,
      "five_year_principal_amount": 10000,
      "five_year_total_amount": 10000,
      "origination_amount": 10000,
      "payments": [
        {}
      ],
      "tip": "string",
      "total_interest_amount": 10000,
      "total_payments_amount": 10000
    },
    "change": {
      "affected_cost_ids": [
        "string"
      ],
      "evidence_sha256": "string",
      "kind": "string",
      "known_at": "2026-09-17T14:30:00Z",
      "reason": "string"
    },
    "costs": [
      {
        "affiliate": false,
        "amount": 10000,
        "bona_fide_reasonable": false,
        "can_shop": false,
        "category": "string",
        "evidence_sha256": "string",
        "id": "string",
        "insurer_choice_disclosed": false,
        "label": "string",
        "on_provider_list": false,
        "paid_before_amount": 10000,
        "paid_before_at": "2026-09-17T14:30:00Z",
        "paid_by": "string",
        "payee": "string",
        "prepaid_months": 0,
        "recording_deed_amount": 10000,
        "recording_mortgage_amount": 10000,
        "required": false,
        "shopped": false
      }
    ],
    "created_at": "2026-09-17T14:30:00Z",
    "id": "string",
    "kind": "string",
    "maker": "string",
    "number": 0,
    "origination_id": "string",
    "previous_id": "string",
    "provider_list": {
      "reuse": {
        "revision_id": "string",
        "sha256": "string"
      },
      "services": [
        {}
      ]
    },
    "provider_selections": [
      {
        "cost_id": "string",
        "evidence_sha256": "string",
        "list": {},
        "provider": {},
        "selected_at": "2026-09-17T14:30:00Z",
        "selected_by": "string"
      }
    ],
    "terms": {
      "annual_home_insurance_amount": 10000,
      "annual_other_property_cost_amount": 10000,
      "annual_property_tax_amount": 10000,
      "assumable": false,
      "borrower_mailing_address": "string",
      "buyer_broker": {
        "address": "string",
        "email": "string",
        "license_id": "string",
        "name": "string",
        "nmls_id": "string",
        "person": "string",
        "person_license_id": "string",
        "person_nmls_id": "string",
        "phone": "string"
      },
      "consummation_date": "2026-09-17",
      "contract_sha256": "string",
      "deficiency_protection": false,
      "deposit_amount": 10000,
      "deposit_holder": "string",
      "escrow_adjustment_amount": 10000,
      "escrow_declined": false,
      "escrow_lines": [
        {}
      ],
      "escrow_monthly_amount": 10000,
      "escrow_waiver_fee_amount": 10000,
      "estimate_expires_at": "2026-09-17T14:30:00Z",
      "features": [
        "string"
      ],
      "first_payment_date": "2026-09-17",
      "funding_date": "2026-09-17",
      "grace_days": 0,
      "initial_escrow_amount": 10000,
      "insurance_escrowed": false,
      "late_fee_amount": 10000,
      "lender_contact": {
        "address": "string",
        "email": "string",
        "license_id": "string",
        "name": "string",
        "nmls_id": "string",
        "person": "string",
        "person_license_id": "string",
        "person_nmls_id": "string",
        "phone": "string"
      },
      "lender_credit_amount": 10000,
      "mortgage_broker": {
        "address": "string",
        "email": "string",
        "license_id": "string",
        "name": "string",
        "nmls_id": "string",
        "person": "string",
        "person_license_id": "string",
        "person_nmls_id": "string",
        "phone": "string"
      },
      "other_escrowed": false,
      "other_property_cost_label": "string",
      "partial_payments": "string",
      "parties": [
        "string"
      ],
      "principal_amount": 10000,
      "profile": "string",
      "property_address": "string",
      "property_value_amount": 10000,
      "property_value_basis": "string",
      "purpose": "string",
      "rate_bps": 0,
      "rate_lock_expires_at": "2026-09-17T14:30:00Z",
      "rate_locked": false,
      "sale_price_amount": 10000,
      "seller_address": "string",
      "seller_broker": {
        "address": "string",
        "email": "string",
        "license_id": "string",
        "name": "string",
        "nmls_id": "string",
        "person": "string",
        "person_license_id": "string",
        "person_nmls_id": "string",
        "phone": "string"
      },
      "seller_credit_amount": 10000,
      "seller_name": "string",
      "servicing": "string",
      "settlement_agent": {
        "address": "string",
        "email": "string",
        "license_id": "string",
        "name": "string",
        "nmls_id": "string",
        "person": "string",
        "person_license_id": "string",
        "person_nmls_id": "string",
        "phone": "string"
      },
      "settlement_file_number": "string",
      "state": "string",
      "tax_escrowed": false,
      "term_months": 0
    }
  }
}