Researcher Data Kit

The record shapes Kids Over Profits stores, where each fact you collect belongs, and blank templates to scrape or type into.

For researchers collecting data with us

The templates use KOP's own field names and formats, so what you send can be loaded into our review queues without retyping. Nothing is published until a KOP editor has checked it.

To read what KOP already holds, use the open data downloads: they use the same shapes.

Downloads

How to send

Use one JSON file per kind of record, copied from a template above. A file can hold as many records as you like: add entries to its list. Every file starts with the same fields:

FieldTypeWhat goes here
submitted_bytextYour name or your group's name, as you want it credited.
collected_ondateWhen you collected the data, YYYY-MM-DD.
methodtextHow you got it: "scraped the Texas HHS search page with Python", "read the 1998-2004 NATSAP directories by hand".
kit_version, kindfixedLeave as they are. They tell the importer which shape it is reading.

Name the file after what it covers (facilities-utah-licensing-2026-10.json). If KOP gave you a personal upload link, send your files there, as many at a time and as large as you like (a .zip is fine), along with the documents themselves (court records, reports, handbooks, scans) under "Send documents". Otherwise send them to us through the contact page, or to whoever sent you here. A spreadsheet is fine too, as long as its column headings are the field paths on this page (location.city, operatingPeriod.startYear); a list goes in one cell, separated by |.

Rules for every file

  1. Every fact carries its source. A record with a place for one (source, sourceUrl, source_urls, resourceLinks) takes it there; a free-text note ends with its link: "Closed in March 2019 after the state revoked its license (source: https://...)". A primary source beats a report about it: the court filing over the article, the inspection report over a summary, the program's own website or handbook, tax returns and business filings.
  2. Leave a field empty when you don't know. An empty string, an empty list or null. Never write "Unknown", "N/A", "none" or "?" into a field, because those read as facts. Status fields are the one exception: they have their own Unknown value.
  3. Copy names exactly as the source spells them. Don't tidy, expand or guess a program's, company's or person's name. Another spelling from another source goes in otherNames. A different middle initial means a different person until a source says otherwise.
  4. Use the formats KOP stores. Years are whole numbers (1998, never "1998" or "late 90s"; put the words in a note). Dates are YYYY-MM-DD. US states are two-letter codes in capitals (UT). Countries are full English names (United States, Mexico). ZIP codes stay text, so "04530" keeps its zero.
  5. A renamed program keeps its old names with their years. Earlier names go in pastNames, and operatingPeriod.notes says when each name changed and who ran it under that name. A place that reopened under a different operator is its own record.
  6. Archived copies. If you read something on the Wayback Machine or another archive, give both the original address and the archive link. KOP keeps its own copy.
  7. Protect private people. Name staff, owners, officials and anyone who has spoken publicly under their own name. Never send the names or details of children, or of survivors who have not gone public. Survivor accounts come only from public posts, and stay hidden until KOP checks them.

What goes where

Records link up by name: when a lawsuit names a facility, write the facility's name as the source spells it, with its city and state, and KOP connects them.

You foundFileField
A program for minors: its name, address, years, type, ages Facilities identification, location, operatingPeriod, facilityDetails
A program's state business filing (legal name, DBAs, agent, officers) Facilities identification.legalName, dbaNames, registrants
A program's license number or licensing agency Facilities licensing
Trade group membership; accreditation Facilities memberships; accreditations
Medicaid, foster care, ORR, TRICARE, PPP or other federal money Facilities federalFunding
What a program says it treats or uses (diagnoses, behaviors, level systems, restraint) Facilities targetedDiagnoses, targetedBehaviors, treatmentTypes, ttiPractices, philosophy
Deaths, staff arrests, hospitalizations, riots at a program Facilities criticalIncidents (tick) + notes (what happened, with source)
A page about a program: licensing record, court page, forum thread, staff profile, ad Facilities resourceLinks, with a kind
A public survivor account of a program Facilities survivorTestimony
A staff member or director of one program Facilities staff.administrator, staff.notableStaff
A company that owns or runs programs, its executives, investors, parent companies Companies operator, facilities
A person's jobs across programs, or two people's relationship People jobs, relations
A court case Lawsuits the whole record
A bill or law Bills the whole record
A news article, op-ed or press release News the whole record
State licensing inspections, complaints or citations Inspections facility_info, reports
Anything else relevant you have no time to file Source links the whole record

What counts as a facility

A facility is a residential program that holds people under 18: residential treatment centers, psychiatric residential treatment facilities, therapeutic and religious boarding schools, wilderness and outdoor programs, boot camps, ranches, group homes, maternity homes, shelters for migrant children (Office of Refugee Resettlement), and juvenile detention and correctional facilities.

Leave out foster family homes, adult group homes, nursing homes and programs only for adults. A program for people 18 and older that is tied to the industry (a "young adult" program run by a youth program's company) is still worth sending: file it under facilities with ageRange.min at 18 or more, and KOP keeps it on its own list. The same goes for Indian boarding and residential schools.

Facilities

One entry per program at one place. Two campuses run as one program are one record (the second goes in additionalLocations); two programs on one campus are two records.

identification

FieldTypeWhat goes here
name requiredtextThe program's name as its source gives it.
currentNametextThe name it trades under now, only when that differs from name.
otherNameslist of textOther spellings and names in use at the same time.
pastNameslist of textEarlier names. The years of each change go in operatingPeriod.notes.
legalNametextThe name on its state business filing ("CT Clinical Services, LLC").
dbaNameslist of textTrade names registered on that filing (doing business as).
registrantslist of {name, role, source, sourceUrl}Who the filing names: registered agent, organizer, members, managers, officers. A name can be a person or a company.
currentOperatortextThe company that runs it now.
currentOwnerslist of textWho owns it now, if not the operator.
pastOwners, pastOperatorslist of textEarlier owners and operators, with years in brackets when known: "Charter Behavioral Health Systems (1986-2000)".
otherOperatorslist of textOther companies running it at the same time (a management contract).
knownReferrerslist of textEducational consultants, transport companies and others known to send children there.
investorslist of textPrivate equity firms, lenders and other backers.

location

FieldTypeWhat goes here
rawtextThe address on one line exactly as the source gives it.
texttextA looser place description when there is no address ("Southern Utah").
street, city, ziptextThe address in parts, when you can split it.
statetwo-letter code or nullUT; null outside the US.
countrytext or nullUnited States whenever a state is set.
additionalLocationslist of {raw, street, city, state, zip, country}Other campuses of the same program, open now.
formerLocationslist of {raw, city, state, country, fromYear, toYear}Places it moved away from, with the years it was there.

operatingPeriod

FieldTypeWhat goes here
startYear, endYearwhole number or nullThe year it opened and the year it closed; endYear stays null while it is open.
statusone valueOpen, Closed, Suspended (license suspended or revoked, under appeal), Transferred (handed to another operator under a new record), Unknown.
yearsOfOperationtextThe years as the source words them ("1971-present").
noteslist of textDated events with sources: openings, renames, closures, license actions.

facilityDetails

FieldTypeWhat goes here
typetextOne of the facility types below; several are joined with ", ".
capacitywhole number or nullLicensed beds.
currentCensuswhole number or nullChildren there on the date of the source; give the date in a note.
ageRange{min, max}Whole numbers or null.
genderone valueMale, Female, Co-ed, or empty.
isPrivatelyOwnedtrue, false or null

Facility types

  • Adventure Therapy Program
  • Behavior Modification Program
  • Boot Camp
  • Christian Boarding School
  • Eating Disorder Treatment Center
  • Emotional Growth Boarding School
  • Fundamentalist Religious Home
  • Group Home
  • Juvenile Correctional Facility
  • Juvenile Detention Facility
  • Juvenile Justice RTC
  • Long-term Wilderness Program
  • Maternity Home
  • Military-Style Academy
  • Psychiatric Hospital
  • Psychiatric Residential Treatment Facility
  • Qualified Residential Treatment Program (QRTP)
  • Ranch Program
  • Residential Treatment Center
  • Specialty Boarding School
  • Substance Abuse Treatment
  • Therapeutic Boarding School
  • Therapeutic Group Home
  • Transitional Living Program
  • Wilderness Therapy
  • Other

staff

FieldTypeWhat goes here
staff.administratorlist of {name, role, pastJobs, source, sourceUrl}Executive directors, CEOs, founders and owners on site.
staff.notableStaffsameTherapists, teachers, medical directors and other staff a source names. pastJobs is a line of text ("Clinical director at Island View, 2004-2008").
staff.pastTTIJobslist of {role, organization, employer}Other industry programs where this program's staff worked; employer repeats organization.

Roles take "a" or "an" for jobs many people hold (therapist, teacher, staff member) and "the" for one-holder titles (director, CEO, founder). No "former" and no abbreviations inside a role, and a year only when it is a start or an end ("from 2010 to 2012").

Memberships, licensing and links

FieldTypeWhat goes here
accreditations{current: [], past: []}Joint Commission, CARF, COA, Cognia and others, by name.
membershipslist of textNATSAP, OBH Council, IECA and other trade groups; "former member" in the text when it has left.
certificationslist of textStaff certifications the program lists.
licensinglist of textLicense type, number and agency: "Utah DHHS Office of Licensing, residential treatment, license 93696".
profileLinkslist of URLsThe program's own websites.
resourceLinkslist of {url, label, kind, source}Outside pages about it. label is a short title; source says where you found the link.
federalFundinglist of {stream, detail, years, sources, source}Federal money it received. detail says what (a rate, a contract, a loan amount); years is text; sources is a list of {url, label}.

resourceLinks kind

  • licensing Licensing and inspection reports
  • court Court records
  • government Government records
  • news News coverage
  • social Survivor posts and discussion
  • people Staff listing or directory
  • advertising Advertising and marketing listings
  • reference Reference and research
  • archive Archived pages
  • staff_profile Staff profile
  • business_or_property_records Business or property records
  • other Other links

federalFunding stream

  • medicaid
  • medicaid_child_welfare Medicaid and federal child welfare funds
  • child_welfare Federal foster care funds (Title IV-E)
  • orr Office of Refugee Resettlement (unaccompanied migrant children)
  • tricare TRICARE (health insurance for military families)
  • ppp Paycheck Protection Program loan
  • education U.S. Department of Education
  • special_education Special education placements paid by school districts (IDEA and state funds)
  • other Other federal money

Checklists

treatmentTypes, targetedDiagnoses, targetedBehaviors, ttiPractices, philosophy and criticalIncidents are tick boxes: set a box to true only when a source shows it, and put that source in notes or resourceLinks. Every box is in the facilities template. A practice with no box goes in ttiPractices.other as text. resources records which kinds of material exist about the program (hasNews, hasLawsuits, hasInspections...); its ...Details fields take a line of text.

Notes and survivor accounts

FieldTypeWhat goes here
noteslist of textFacts that fit nowhere else, one per line, each ending with its source.
fieldNotesmapLeave empty; KOP editors use it.
survivorTestimonylist of {text, source, date, publish}A public account quoted or summarized, its link in source. publish stays false.

The stored record also has schema_version, facility_id, identification.nameKey, providerDetails, documentFolderId, provenance and legacy. KOP fills those itself; leave them out.

Companies

A company that owns or runs programs, or a parent or holding company above one. name is its full name with its suffix ("Psychiatric Solutions, Inc.").

FieldTypeWhat goes here
name requiredtextThe company's full name.
operator.currentNametextThe name it uses now, when different.
operator.otherNameslist of textOther and earlier names, short forms.
operator.statustextActive, Acquired, Merged, Defunct, or empty.
operator.foundedtextYear, and how: "1988 (incorporated in Delaware)".
operator.operatingPeriodtext"1988 to 2010".
operator.headquarterstextThe full headquarters address, with headquartersCity and headquartersState split out.
operator.locationtext"Franklin, TN", with locationCity and locationState split out.
operator.websiteslist of URLs
operator.parentCompanies, owners, investorslist of textWith years in brackets when known.
operator.keyStaff{ceo, founders, keyExecutives}ceo is a name; the two lists take {name, role, pastJobs}.
operator.noteslist of textDated events with sources: acquisitions, sales, bankruptcies, settlements.
facilitieslist of {name, city, state, relationship, years, source}Programs it runs or ran; relationship is current or past.

People

For someone who turns up across several programs or companies. KOP gives every person one id and shows their jobs on each page that names them.

FieldTypeWhat goes here
name requiredtextFull name as a source gives it, middle initial included.
otherNameslist of textMaiden names, nicknames, other spellings a source shows are the same person.
poolone valueindustry (works or worked in or for the industry, including people who went through a program and now work in it), press (reporters, authors), harmed (survivors who have gone public).
jobslist of {place, placeCity, placeState, role, years, source, sourceUrl}One line per job. place is a program or company; years is text ("2004-2008").
relationslist of {otherName, kind, detail, source, sourceUrl}Ties to another person: kind such as spouse, parent, sibling, business partner.
noteslist of textArrests, licenses lost, statements, each with its source.

Lawsuits

FieldTypeWhat goes here
case_name requiredtextThe caption, with the program in brackets when the caption doesn't name it.
case_numbertextDocket number or citation.
courttext"U.S. District Court for the District of Utah".
jurisdictiontextThe state's full name, or Federal.
filing_datedate or nullYYYY-MM-DD. With only the year, use YYYY-01-01 and say so in summary.
statusone valueListed below.
plaintiffs, defendantslist of textAs the caption names them. Minor plaintiffs by initials or "Doe" names only.
facilities_mentionedlist of text"Program name (City, State)".
staff_mentioned, organizations_mentionedlist of textStaff and owners; companies.
claimslist of textEach claim in plain words ("Wrongful death", "Negligent supervision").
outcometextVerdict, ruling, dismissal or settlement terms.
settlement_amounttextAs stated: "$4.5 million".
summarytextWhat the case is about, in a few sentences.
source_urlslist of URLsArticles and docket pages.
document_urlslist of URLsThe filings themselves: complaints, orders, opinions.
tagslist of textFree topics: restraint, transport, sexual abuse.

status

  • closed
  • dismissed
  • filed
  • in_progress In progress
  • appeal On appeal
  • ruling Ruling issued
  • settled
  • unknown

Bills

The file's list is called legislation.

FieldTypeWhat goes here
bill_title requiredtextOfficial or short title.
bill_numbertext"HB 123", "S. 1351".
jurisdictiontextThe state's full name, or Federal.
chamberone valuehouse, senate, assembly, joint, federal_house, federal_senate, other, unknown.
session_yeartext"2025" or "2025-2026".
bill_typetextHB, SB, AB, HR, SR...
sponsorslist of text"Ron Wyden (D-OR)".
statusone valueListed below.
introduced_date, last_action_datedate or nullYYYY-MM-DD.
last_action_texttextThe legislature's own wording of the last action.
subject_tagslist of textrestraint, oversight, licensing, Medicaid...
summarytextWhat the bill does.
full_text_url, official_urlURLThe bill text; the legislature's tracking page.
facilities_affectedlist of textPrograms it names or was written about.
tagslist of textFree topics.

status

  • proposed Proposed (discussion draft)
  • introduced
  • in_committee In committee
  • passed_house Passed House
  • passed_senate Passed Senate
  • signed
  • vetoed
  • dead
  • enacted
  • unknown

News

The file's list is called articles. If all you have is the link, use a source link instead.

FieldTypeWhat goes here
article_title requiredtextThe headline as published.
authortextByline.
publication_nametext"The Salt Lake Tribune".
publication_datedate or nullYYYY-MM-DD.
article_url requiredURLThe original address.
archive_urlURLAn archived copy, if you used one.
article_typeone valueListed below.
facilities_mentioned, staff_mentionedlist of textPrograms ("Name (City, State)") and staff it names.
content_warningslist of textFrom the list below.
tagslist of textTopics; KOP's usual ones are below.
summarytextTwo or three sentences on what the article reports.

article_type

  • corporate Corporate Change Article
  • expose Exposé or Survivor Account
  • closure Facility Closure Article
  • lawsuit Lawsuit Article
  • event Specific Event Article
  • arrest Staff Arrest Article
  • general General News Article

content_warnings

  • Autism-Specific Abuse
  • Chemical Restraint
  • Child-on-Child CSA
  • Child Death
  • Child Sexual Abuse
  • Conversion Therapy
  • Eating Disorders
  • Food Restriction
  • Forced Labor
  • Graphic Descriptions of Assaults or Injuries
  • Hate Crimes
  • Homophobia
  • Humiliating Punishments
  • Involuntary Transport
  • Law Enforcement Abuse
  • Medical Neglect
  • Peer Violence
  • Physical Restraint
  • Racism
  • Seclusion
  • Self-harm
  • Slurs
  • Spiritual Abuse
  • Substance Abuse
  • Suicide
  • Transphobia
  • Unsanitary Conditions
  • Victim Blaming

tags

  • Adoption
  • Arrest
  • Child Protective Services
  • Closure
  • Conversion Therapy
  • Corporate Governance
  • Death
  • Disability Rights
  • Documentary
  • Escape
  • Faith-Based Programs
  • Family Law
  • Forced Labor
  • Foster Care
  • Group Home
  • Human Trafficking
  • Immigration
  • Juvenile Justice
  • Kidnapping
  • Legislation
  • LGBTQ+ Rights
  • Licensing
  • Medicaid
  • Oversight
  • Private Prisons
  • Private Schools
  • Riot
  • Safety Violations
  • Self-Harm
  • Settlement
  • Sexual Misconduct
  • Staff Misconduct
  • Suicide
  • Survivor Stories
  • Transport
  • Trial
  • Wilderness Therapy

Inspections

The shape KOP's own state scrapers write, so a scraper's output can be loaded as it is. One file per state, with state (two-letter code), scraped_timestamp (ISO 8601) and source_site (the search page you scraped). Keep the report text whole; KOP reads the findings out of it.

FieldTypeWhat goes here
facility_info.facility_name requiredtextThe licensee or site name as the state lists it.
facility_info.program_nametextThe program or building name, when the state lists one separately.
facility_info.full_address, phonetext
facility_info.program_categorytextThe state's own license category ("Group Home").
facility_info.executive_directortext
facility_info.bed_capacitytextAs the state shows it.
facility_info.license_number, license_exp_date, relicense_visit_datetextAs the state shows them.
facility_info.actiontextAny license action shown (probation, revocation).
reports[].report_id requiredtextThe state's id for the report, or another value unique within the facility.
reports[].report_datetextAs the state shows it.
reports[].report_urlURLA link that opens this report, not the search page.
reports[].raw_contenttextThe full report text.
reports[].content_lengthwhole numberCharacters in raw_content.
reports[].summarytextOptional one-line summary.