People

A record of a person. This is a singular base record that will be used within Binti in multiple capacities. A person can be part of a foster family, a child receiving services from an agency, an agency worker, or a potential connection in a family finding search.

• id* (string) - The primary key for the record.
• type* (string) - The JSON:API type specifier.
• attributes* (object) - Primary record attributes.

  • created-at* (unknown) - Date Person was created.

  • updated-at* (unknown) - Date Person was last updated in Binti.

  • first-name* (["string", "null"]) - First or given name, as provided to Binti.

  • middle-name* (["string", "null"]) - Middle name, as provided to Binti.

  • last-name* (["string", "null"]) - Last or family name, as provided to Binti.

  • suffix* (["string", "null"]) - Suffix, as provided to Binti.

  • nickname* (["string", "null"]) - Nickname or preferred name, as provided to Binti.

  • date-of-birth* (unknown) - Date of birth.

  • estimated-date-of-birth* (unknown) - Estimated date of birth. Only one of either date_of_birth or estimated_date_of_birth will be populated.

  • is-deceased* (["boolean", "null"]) - A boolean for if the person is deceased. (True: the person is deceased.)

  • date-of-death* (unknown) - Date of death.

  • gender* (["string", "null"]) - Gender, as selected from the available options.

    Allowed values

    • Female
    • Male
    • Transgender
    • Non-binary
    • Not listed above
    • Prefer not to answer

  • external-identifier* (["string", "null"]) - If the person is part of a foster family application they may be assigned an external identifier. Equivelent to user-agency-profiles.external-identifier

  • person-id* (["string", "null"]) - If the person is part of a foster family application they may be assigned an external identifier. Equivelent to user-agency-profiles.external-identifier

  • client-id* (["string", "null"]) - An external identifier signifying a child client of the agency. Equivement to children.client_id

  • primary-phone-number* (["string", "null"]) - Phone number provided to Binti and designated as Primary Phone number for person

  • primary-address* (["object", "null"]) - Address listed as primary for person within family finding.

  • primary-email-address* (["string", "null"]) - Email Address provided to Binti and designated as Primary Email Address for person

• relationships (object) - Related objects. For each relationship, you can find detailed information about the object by issuing another API call to look it up by ID, or for certain endpoints, you will find details in the "included" section.
  • user-agency-profile (["object", "null"]) - A relationship with a single entry.
  • child (["object", "null"]) - A relationship with a single entry.
  • email-addresses (object) - A relationship with multiple entries.
    • data* (array) - Array of entries.