tools

determine_dependent

Determine whether ONE candidate person is the taxpayer's § 152 dependent — qualifying child or qualifying relative, including multiple-support agreements and the divorced-parents release — as a proof-backed yes/no with citations. Feed the result into calculate_tax's credits group (qualifyingChildren / otherDependents).

post/v1/tools/determine_dependent

Request

  • Base URL: https://opentax.invaro.ai
  • URL: https://opentax.invaro.ai/v1/tools/determine_dependent
  • Auth: one of:
    • HTTP bearer
    • none

Headers

X-OpenTax-Return-Idstring

Your identifier for the taxpayer-year this call belongs to; the billing unit. Stored hashed.

Request body

depRelationshipChildboolean

Candidate is the taxpayer's child, stepchild, foster child, sibling, step-sibling, or a descendant of any of them (§ 152(c)(2)).

depIsFullTimeStudentboolean

Candidate was a full-time student for at least 5 months (§ 152(f)(2)).

depPermanentlyDisabledboolean

Candidate is permanently and totally disabled (§ 152(c)(3)(B)).

depYoungerThanTaxpayerboolean

Candidate is younger than the taxpayer (§ 152(c)(3)(A)).

depLivedWithTaxpayerOverHalfYearboolean

Candidate had the same principal residence as the taxpayer for more than half the year (§ 152(c)(1)(B)).

depProvidedOwnSupportOverHalfboolean

Candidate provided more than half of their own support (§ 152(c)(1)(D)).

depFilesJointReturnboolean

Candidate files a joint return with a spouse (other than a refund-only claim) (§ 152(c)(1)(E)).

depRelationshipRelativeboolean

Candidate bears a § 152(d)(2) relationship to the taxpayer (parent, grandparent, sibling, in-law, etc.) or lived in the household all year.

taxpayerProvidedOverHalfSupportboolean

The taxpayer provided more than half of the candidate's support (§ 152(d)(1)(C)).

depIsQualifyingChildOfAnotherboolean

Candidate is the qualifying child of the taxpayer or any other taxpayer (§ 152(d)(1)(D)).

hasMultipleSupportAgreementboolean

A § 152(d)(3) multiple-support agreement is in place for the candidate: the group together provided over half the support, no one person provided over half, each member could otherwise claim the candidate, and every other over-10% contributor signed a Form 2120 waiver.

taxpayerProvidedOver10PercentSupportboolean

The taxpayer contributed over 10 percent of the candidate's support (§ 152(d)(3)(D) — the support test under a multiple-support agreement).

depDivorcedParentsRuleboolean

§ 152(e) applies to the candidate child: the parents are divorced, separated, or lived apart the last 6 months of the year; the child received over half their support from the parents and was in their custody over half the year.

taxpayerIsCustodialParentboolean

The taxpayer is the custodial parent (the parent with whom the child resided the greater number of nights, § 152(e)(4)(A)).

custodialParentReleasedClaimboolean

The custodial parent signed a written declaration (Form 8332) releasing the claim to the child for this year (§ 152(e)(2)).

targetstring

rule to derive (default: us.federal.dependent.is_dependent). Other targets: us.federal.dependent.qualifying_child, us.federal.dependent.qualifying_relative

asOfstring

REQUIRED for computation: the law-in-force date — use the intended tax year's year-end (e.g. "2025-12-31" for TY2025). Omitting it is an error, never a default.

includeProofboolean

include the full proof artifact in the response as proof (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned.

Response

ok:true with the computed value, line set or lookup hits; ok:false with error.code when the engine refuses (NEEDS_FACTS, NO_APPLICABLE_RULE, UNHANDLED_ENUM_CASE)

okboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.