Member applications

The member applications resource is used to track member applications.

Member application object

{
  "id": "0198c930-d9a2-7343-8780-58a8bdbbb92a",
  "tenant": "01988bb8-1cfb-7c87-9326-93op0349288e",
  "contact": "0198c815-d2c0-7b64-b9e2-djaaqgzap5r3",
  "application_identifier": null,
  "status": "01988bb8-2071-7da1-aac5-0c313a9d2025",
  "applied_at": "2025-08-12 20:22:00",
  "veteran": false,
  "national_id": "999-99-9999",
  "gender_identity": "other",
  "race": "white",
  "sexual_orientation": "undisclosed",
  "language": "english",
  "housing_type": "family",
  "housing_minors": false,
  "housing_minors_acs": false,
  "housing_homeless": false,
  "housing_homeless_12mo": false,
  "housing_homeless_details": null,
  "clubhouse_transportation": "vehicle_friend",
  "clubhouse_tour": true,
  "clubhouse_goal": "employment",
  "clubhouse_why": null,
  "clubhouse_challenges": null,
  "benefits_ssi_id": null,
  "benefits_ssi_amount": 0,
  "benefits_ssi_date_start": null,
  "benefits_ssi_payee": null,
  "benefits_ssdi_id": null,
  "benefits_ssdi_amount": 0,
  "benefits_ssdi_date_start": null,
  "benefits_ssdi_payee": null,
  "benefits_snap_amount": 0,
  "benefits_public_amount": 0,
  "benefits_retirement_amount": 0,
  "benefits_veteran_amount": 0,
  "insurance_medicaid_id": null,
  "insurance_medicaid_provider": null,
  "insurance_medicaid_date_effective": null,
  "insurance_medicaid_company": null,
  "insurance_medicare_id": null,
  "insurance_medicare_provider": null,
  "insurance_medicare_date_effective": null,
  "insurance_private_id": null,
  "insurance_private_provider": null,
  "insurance_private_date_effective": null,
  "education": "some_college",
  "employment_current": false,
  "employment_12mo": false,
  "employment_history": false,
  "medical_accessibility_needs": null,
  "medical_allergies": null,
  "medical_conditions": [
    "mobility"
  ],
  "medical_conditions_other": null,
  "medical_diagnosis_primary": "bipolar",
  "medical_diagnosis_secondary": "ptsd",
  "medical_diagnosis_other": null,
  "medical_medications": null,
  "substance_tobacco_current": false,
  "substance_tobacco_12mo": false,
  "substance_tobacco_history": false,
  "substance_alcohol_current": false,
  "substance_alcohol_12mo": false,
  "substance_alcohol_history": false,
  "substance_drug_current": false,
  "substance_drug_12mo": false,
  "substance_drug_history": false,
  "substance_notes": null,
  "legal_jail": false,
  "legal_prison": false,
  "legal_misdemeanor": false,
  "legal_felony": false,
  "legal_injured": false,
  "legal_violence": false,
  "legal_12mo": false,
  "legal_details": null,
  "contact_referrer": null,
  "contact_psychiatrist": null,
  "contact_psychiatrist_date_start": null,
  "contact_primary_care": null,
  "contact_primary_care_date_start": null,
  "contact_therapist": null,
  "contact_therapist_date_start": null,
  "notes": null,
  "meta": null,
  "archived_at": null,
  "created_at": "2025-08-20 20:34:38",
  "updated_at": "2025-12-19 15:49:31"
}

Fields

id
required readonly string
Unique ID of the record.
tenant
required readonly string
Unique ID of the tenant.
contact
required string
Unique ID of the contact.
application_identifier
nullable string
Unique identifier for the application within the tenant.
status
nullable string
Unique ID of the application status.
applied_at
required string
UTC timestamp of when the application was submitted.
veteran
boolean
Whether the applicant is a veteran. The default value is false.
national_id
nullable string
National ID (i.e.: Social Security number) of the applicant.
gender_identity
required string
Gender identity of the applicant. One of:
- man
- woman
- transgender_man
- gransgender_woman
- non_binary
- other
race
required string
Race of the applicant. One of:
- alaskan_indian
- latino
- hawaiian_islander
- asian
- black
- white
- other
sexual_orientation
required string
Sexual orientation of the applicant. One of:
- heterosexual
- bisexual
- lesbian
- gay
- other
- undisclosed
language
required string
Primary language of the applicant. One of:
- afrikaans
- akan
- albanian
- amharic
- arabic
- armenian
- assamese
- azerbaijani
- basque
- belarusian
- bengali
- bosnian
- bulgarian
- burmese
- catalan
- cebuano
- chichewa
- chinese_cantonese
- chinese_mandarin
- corsican
- croatian
- czech
- danish
- dari
- dutch
- dzongkha
- english
- esperanto
- estonian
- ewe
- filipino_tagalog
- finnish
- french
- frisian
- galician
- georgian
- german
- greek
- guarani
- gujarati
- haitian_creole
- hausa
- hawaiian
- hebrew
- hindi
- hmong
- hungarian
- icelandic
- igbo
- indonesian
- irish
- italian
- japanese
- javanese
- kannada
- kazakh
- khmer
- kinyarwanda
- korean
- kurdish_kurmanji
- kurdish_sorani
- kyrgyz
- lao
- latin
- latvian
- lingala
- lithuanian
- luxembourgish
- macedonian
- malagasy
- malay
- malayalam
- maltese
- maori
- marathi
- mongolian
- nepali
- norwegian
- nyanja
- odia_oriya
- oromo
- pashto
- persian_farsi
- polish
- portuguese
- punjabi
- quechua
- romanian
- russian
- samoan
- scots_gaelic
- serbian
- sesotho
- shona
- sign_language
- sindhi
- sinhala
- slovak
- slovenian
- somali
- spanish
housing_type
required string
Housing type of the applicant. One of:
- alf (Assisted Living Facility)
- own
- family
- friend
- group (Group home)
- sro (Single Room Occupancy)
- subsidized
- supervised
- supportive
- nursing
- shelter
- homeless
- unknown
housing_minors
boolean
Whether the applicant lives with minors. The default value is false.
housing_minors_acs
boolean
Whether the applicant has had an open ACS (Administration for Children's Services) case. The default value is false.
housing_homeless
boolean
Whether the applicant has a history of homelessness. The default value is false.
housing_homeless_12mo
boolean
Whether the applicant has been homeless in the last 12 months. The default value is false.
housing_homeless_details
nullable string
Details about the applicant's history of homelessness.
clubhouse_transportation
required string
Transportation method used by the applicant to get to the Clubhouse. One of:
- bicycle
- clubhouse
- public
- taxi
- vehicle_friend
- vehicle_self
- walk
- other
clubhouse_tour
boolean
Whether the applicant has taken a tour of the Clubhouse. The default values is false.
clubhouse_goal
required string
Applicant's main goal for joining the Clubhouse. One of:
- community
- education
- employment
- health
- benefits
- housing
- other
clubhouse_why
nullable string
Applicant's response to why they feel the Clubhouse would be a good place for them.
clubhouse_challenges
nullable string
Applicant's response to what challenges or barriers are keeping them from achieving their goals.
benefits_ssi_id
nullable string
Applicant's Supplemental Security Income (SSI) ID.
benefits_ssi_amount
nullable integer
Applicant's Supplemental Security Income (SSI) amount (monthly).
benefits_ssi_date_start
nullable string
UTC date of when the applicant's Supplemental Security Income (SSI) started.
benefits_ssi_payee
nullable string
Applicant's Supplemental Security Income (SSI) payee.
benefits_ssdi_id
nullable string
Applicant's Social Security Disability Insurance (SSDI) ID.
benefits_ssdi_amount
nullable integer
Applicant's Social Security Disability Insurance (SSDI)
benefits_ssdi_date_start
nullable string
UTC date of when the applicant's Social Security Disability Insurance (SSDI) started.
benefits_ssdi_payee
nullable string
Applicant's Social Security Disability Insurance (SSDI) payee.
benefits_snap_amount
nullable integer
Applicant's Supplemental Nutrition Assistance Program (SNAP) amount (monthly).
benefits_public_amount
nullable integer
Applicant's public assistance amount (monthly).
benefits_retirement_amount
nullable integer
Applicant's retirement benefits amount (monthly).
benefits_veteran_amount
nullable integer
Applicant's veteran benefits amount (monthly).
insurance_medicaid_id
nullable string
Applicant's Medicaid ID.
insurance_medicaid_provider
nullable string
Applicant's Medicaid provider.
insurance_medicaid_date_effective
nullable string
UTC date of when the applicant's Medicaid coverage started.
insurance_medicaid_company
nullable string
Applicant's Medicaid company.
insurance_medicare_id
nullable string
Applicant's Medicare ID.
insurance_medicare_provider
nullable string
Applicant's Medicare provider.
insurance_medicare_date_effective
nullable string
UTC date of when the applicant's Medicare coverage started.
insurance_private_id
nullable string
Applicant's private insurance ID.
insurance_private_provider
nullable string
Applicant's private insurance provider.
insurance_private_date_effective
nullable string
UTC date of when the applicant's private insurance coverage started.
education
required string
Applicant's highest level of education. One of:
- none
- some_high_school
- ged
- high_school
- trade_school
- some_college
- associates
- bachelors
- some_graduate
- masters
- advanced
employment_current
boolean
Whether the applicant is currently employed. The default value is false.
employment_12mo
boolean
Whether the applicant has been employed in the last 12 months. The default value is false.
employment_history
boolean
Whether the applicant has a history of employment. The default value is false.
medical_accessibility_needs
nullable string
Applicant's accessibility needs.
medical_allergies
nullable string
Applicant's allergies.
medical_conditions
nullable array
List of applicant's medical conditions. One or more of:
- mobility
- asthma
- visual
- emphysema
- seizure
- allergy
- new_psychiatric_medication
- hearing
- diabetes
- hypertension
- other
medical_conditions_other
nullable string
Applicant's other medical conditions.
medical_diagnosis_primary
nullable string
Applicant's primary psychiatric diagnosis. One of:
- adhd
- anxiety
- asd (Autism Spectrum Disorder)
- bipolar
- gad (Generalized Anxiety Disorder)
- major_depressive_disorder
- ocd (Obsessive Compulsive Disorder)
- panic (Panic Disorder)
- ptsd (Post-Traumatic Stress Disorder)
- schizoaffective
- schizophrenia
- other
medical_diagnosis_secondary
nullable string
Applicant's secondary psychiatric diagnosis. One of:
- adhd
- anxiety
- asd (Autism Spectrum Disorder)
- bipolar
- gad (Generalized Anxiety Disorder)
- major_depressive_disorder
- ocd (Obsessive Compulsive Disorder)
- panic (Panic Disorder)
- ptsd (Post-Traumatic Stress Disorder)
- schizoaffective
- schizophrenia
- other
medical_diagnosis_other
nullable string
Applicant's other psychiatric diagnosis.
medical_medications
nullable string
Applicant's medications.
substance_tobacco_current
boolean
Whether the applicant currently uses tobacco. The default value is false.
substance_tobacco_12mo
boolean
Whether the applicant has used tobacco in the last 12 months. The default value is false.
substance_tobacco_history
boolean
Whether the applicant has a history of tobacco use. The default value is false.
substance_alcohol_current
boolean
Whether the applicant currently abuses alcohol. The default value is false.
substance_alcohol_12mo
boolean
Whether the applicant has abused alcohol in the last 12 months. The default value is false.
substance_alcohol_history
boolean
Whether the applicant has a history of alcohol abuse. The default value is false.
substance_drug_current
boolean
Whether the applicant currently abuses drugs. The default value is false.
substance_drug_12mo
boolean
Whether the applicant has abused drugs in the last 12 months. The default value is false.
substance_drug_history
boolean
Whether the applicant has a history of drug abuse. The default value is false.
substance_notes
nullable string
Notes about the applicant's substance use.
legal_jail
boolean
Whether the applicant has been in jail. The default value is false.
legal_prison
boolean
Whether the applicant has been in prison. The default value is false.
legal_misdemeanor
boolean
Whether the applicant has a misdemeanor conviction. The default value is false.
legal_felony
boolean
Whether the applicant has a felony conviction. The default value is false.
legal_injured
boolean
Whether the applicant has ever physically injured another person. The default value is false.
legal_violence
boolean
Whether the applicant has a history of violent behavior. The default value is false.
legal_12mo
boolean
Whether the applicant has had any legal issues in the last 12 months. The default value is false.
legal_details
nullable string
Details about the applicant's legal history.
contact_referrer
nullable string
Contact ID of the applicant's referrer.
contact_psychiatrist
nullable string
Contact ID of the applicant's Psychiatrist.
contact_psychiatrist_date_start
nullable string
UTC date of when the applicant started seeing their psychiatrist.
contact_primary_care
nullable string
Contact ID of the applicant's Primary Care Physician.
contact_primary_care_date_start
nullable string
UTC date of when the applicant started seeing their primary care physician.
contact_therapist
nullable string
Contact ID of the applicant's therapist.
contact_therapist_date_start
nullable string
UTC date of when the applicant started seeing their therapist.
notes
nullable string
Application notes.
meta
nullable object
Additional metadata about the application.
archived_at
nullable string
UTC timestamp of when the record was archived.
created_at
required readonly string
UTC timestamp of when the record was created.
updated_at
nullable readonly string
UTC timestamp of when the record was last updated.

Create a member application

POST /tenants/{tenantId}/member-applications

The request body must include a member application object.

Required permissions

member_applications:create contacts:read options:read

Response

HTTP status	Title	Description	Schema
201	Created	Successfully created	Member application object
400	Bad Request	Invalid or missing field(s)	Error object
404	Not Found	Tenant not found	Error object

List member applications

GET /tenants/{tenantId}/member-applications

Required permissions

member_applications:read contacts:read options:read

Response

HTTP status	Title	Description	Schema
200	OK		An associative array of member application objects
400	Bad Request	Invalid parameters in the request query	Error object
404	Not Found	Tenant not found	Error object

Read a member application

GET /tenants/{tenantId}/member-applications/{id}

Required permissions

member_applications:read contacts:read options:read

Response

HTTP status	Title	Description	Schema
200	OK		Member application object
400	Bad Request	Invalid parameters in the request query	Error object
404	Not Found	Tenant or application ID not found	Error object

Update a member application

PATCH /tenants/{tenantId}/member-applications/{id}

The request body must include parts of a member application object.

Required permissions

member_applications:update contacts:read options:read

Response

HTTP status	Title	Description	Schema
200	OK	Updated member application record	Member application object
400	Bad Request	Invalid or missing field(s)	Error object
404	Not Found	Tenant or application ID not found	Error object

Delete a member application

DELETE /tenants/{tenantId}/member-applications/{id}

Required permissions

member_applications:delete

Response

HTTP status	Title	Description	Schema
204	No content	Successfully deleted
404	Not Found	Tenant ID not found	Error object

Was this page helpful?