Skip to main content
HeirPros – Heir Search Firm

Estimate research hours

For AI agents: a documentation index is available at /llms.txt. This page is also available as markdown.

POST https://heirpros.com/api/v1/hours with a JSON body. Requires an API key.

Formula

Estimated hours = 1.5 + known heirs + estimated unknown heirs. The optional case details are checked but do not change the hours in v1.

Fields

FieldTypeValues
known_heirsinteger, requiredTotal number of known family members. 1 to 100.
unknown_heirsinteger, requiredEstimated number of unknown family members. 1 to 25.
estate_typeoptionaltestate, intestate or n/a
search_purposeoptionalnotice, distribution or n/a
has_identifying_infooptionalyes or no
last_contact_knownoptionalyes, no or unknown
lifestyle_considerationsoptionalyes, no or unknown
distribution_methodoptionalper stirpes, per capita or unsure
immigration_or_emigrationoptionalyes or no
has_additional_detailsoptionalyes or no

Example request

curl -X POST https://heirpros.com/api/v1/hours \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"known_heirs": 3, "unknown_heirs": 2, "estate_type": "intestate"}'

Example response (200)

{
  "estimated_hours": 6.5,
  "total_heirs": 5,
  "known_heirs": 3,
  "unknown_heirs": 2,
  "case_details": { "estate_type": "intestate" },
  "method": "1.5 base hours plus 1 hour per known and estimated unknown heir.",
  "note": "This is an estimate. Final hours are confirmed by HeirPros before work starts."
}

Response fields

FieldMeaning
estimated_hoursThe estimated research hours.
total_heirsKnown plus estimated unknown heirs.
case_detailsThe optional details you sent, normalized to lower case.
methodHow the hours were worked out.
noteReminder that HeirPros confirms final hours.

Invalid input returns 422 validation_failed and names each field. See Errors.