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
-
Facilities
Programs for minors: names, addresses, years, operators, staff, licensing, practices, links. Fields
-
Companies
Companies that own or run programs, their executives, investors and parent companies. Fields
-
People
People who turn up across programs: their jobs and the people they are tied to. Fields
-
Lawsuits
Civil and criminal cases. Fields
-
Bills
State and federal bills and laws. Fields
-
News
Articles, op-eds, press releases, broadcast segments. Fields
-
Inspections
State licensing inspections, complaint investigations and citations, the shape KOP's own scrapers write. Fields
-
Source links
Leads you have not filed into a record: a link and a note. Fields
-
Stored facility record
Every key of a facility as KOP stores it, the ones KOP fills itself included. For reading the open data files.
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:
| Field | Type | What goes here |
|---|---|---|
submitted_by | text | Your name or your group's name, as you want it credited. |
collected_on | date | When you collected the data, YYYY-MM-DD. |
method | text | How you got it: "scraped the Texas HHS search page with Python", "read the 1998-2004 NATSAP directories by hand". |
kit_version, kind | fixed | Leave 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
- 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. - 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 ownUnknownvalue. - 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. - Use the formats KOP stores. Years are whole numbers (
1998, never"1998"or "late 90s"; put the words in a note). Dates areYYYY-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. - A renamed program keeps its old names with their years. Earlier names go in
pastNames, andoperatingPeriod.notessays when each name changed and who ran it under that name. A place that reopened under a different operator is its own record. - 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.
- 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 found | File | Field |
|---|---|---|
| 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
| Field | Type | What goes here |
|---|---|---|
name required | text | The program's name as its source gives it. |
currentName | text | The name it trades under now, only when that differs from name. |
otherNames | list of text | Other spellings and names in use at the same time. |
pastNames | list of text | Earlier names. The years of each change go in operatingPeriod.notes. |
legalName | text | The name on its state business filing ("CT Clinical Services, LLC"). |
dbaNames | list of text | Trade names registered on that filing (doing business as). |
registrants | list of {name, role, source, sourceUrl} | Who the filing names: registered agent, organizer, members, managers, officers. A name can be a person or a company. |
currentOperator | text | The company that runs it now. |
currentOwners | list of text | Who owns it now, if not the operator. |
pastOwners, pastOperators | list of text | Earlier owners and operators, with years in brackets when known: "Charter Behavioral Health Systems (1986-2000)". |
otherOperators | list of text | Other companies running it at the same time (a management contract). |
knownReferrers | list of text | Educational consultants, transport companies and others known to send children there. |
investors | list of text | Private equity firms, lenders and other backers. |
location
| Field | Type | What goes here |
|---|---|---|
raw | text | The address on one line exactly as the source gives it. |
text | text | A looser place description when there is no address ("Southern Utah"). |
street, city, zip | text | The address in parts, when you can split it. |
state | two-letter code or null | UT; null outside the US. |
country | text or null | United States whenever a state is set. |
additionalLocations | list of {raw, street, city, state, zip, country} | Other campuses of the same program, open now. |
formerLocations | list of {raw, city, state, country, fromYear, toYear} | Places it moved away from, with the years it was there. |
operatingPeriod
| Field | Type | What goes here |
|---|---|---|
startYear, endYear | whole number or null | The year it opened and the year it closed; endYear stays null while it is open. |
status | one value | Open, Closed, Suspended (license suspended or revoked, under appeal), Transferred (handed to another operator under a new record), Unknown. |
yearsOfOperation | text | The years as the source words them ("1971-present"). |
notes | list of text | Dated events with sources: openings, renames, closures, license actions. |
facilityDetails
| Field | Type | What goes here |
|---|---|---|
type | text | One of the facility types below; several are joined with ", ". |
capacity | whole number or null | Licensed beds. |
currentCensus | whole number or null | Children there on the date of the source; give the date in a note. |
ageRange | {min, max} | Whole numbers or null. |
gender | one value | Male, Female, Co-ed, or empty. |
isPrivatelyOwned | true, false or null |
Facility types
Adventure Therapy ProgramBehavior Modification ProgramBoot CampChristian Boarding SchoolEating Disorder Treatment CenterEmotional Growth Boarding SchoolFundamentalist Religious HomeGroup HomeJuvenile Correctional FacilityJuvenile Detention FacilityJuvenile Justice RTCLong-term Wilderness ProgramMaternity HomeMilitary-Style AcademyPsychiatric HospitalPsychiatric Residential Treatment FacilityQualified Residential Treatment Program (QRTP)Ranch ProgramResidential Treatment CenterSpecialty Boarding SchoolSubstance Abuse TreatmentTherapeutic Boarding SchoolTherapeutic Group HomeTransitional Living ProgramWilderness TherapyOther
staff
| Field | Type | What goes here |
|---|---|---|
staff.administrator | list of {name, role, pastJobs, source, sourceUrl} | Executive directors, CEOs, founders and owners on site. |
staff.notableStaff | same | Therapists, teachers, medical directors and other staff a source names. pastJobs is a line of text ("Clinical director at Island View, 2004-2008"). |
staff.pastTTIJobs | list 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
| Field | Type | What goes here |
|---|---|---|
accreditations | {current: [], past: []} | Joint Commission, CARF, COA, Cognia and others, by name. |
memberships | list of text | NATSAP, OBH Council, IECA and other trade groups; "former member" in the text when it has left. |
certifications | list of text | Staff certifications the program lists. |
licensing | list of text | License type, number and agency: "Utah DHHS Office of Licensing, residential treatment, license 93696". |
profileLinks | list of URLs | The program's own websites. |
resourceLinks | list of {url, label, kind, source} | Outside pages about it. label is a short title; source says where you found the link. |
federalFunding | list 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
licensingLicensing and inspection reportscourtCourt recordsgovernmentGovernment recordsnewsNews coveragesocialSurvivor posts and discussionpeopleStaff listing or directoryadvertisingAdvertising and marketing listingsreferenceReference and researcharchiveArchived pagesstaff_profileStaff profilebusiness_or_property_recordsBusiness or property recordsotherOther links
federalFunding stream
medicaidmedicaid_child_welfareMedicaid and federal child welfare fundschild_welfareFederal foster care funds (Title IV-E)orrOffice of Refugee Resettlement (unaccompanied migrant children)tricareTRICARE (health insurance for military families)pppPaycheck Protection Program loaneducationU.S. Department of Educationspecial_educationSpecial education placements paid by school districts (IDEA and state funds)otherOther 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
| Field | Type | What goes here |
|---|---|---|
notes | list of text | Facts that fit nowhere else, one per line, each ending with its source. |
fieldNotes | map | Leave empty; KOP editors use it. |
survivorTestimony | list 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.").
| Field | Type | What goes here |
|---|---|---|
name required | text | The company's full name. |
operator.currentName | text | The name it uses now, when different. |
operator.otherNames | list of text | Other and earlier names, short forms. |
operator.status | text | Active, Acquired, Merged, Defunct, or empty. |
operator.founded | text | Year, and how: "1988 (incorporated in Delaware)". |
operator.operatingPeriod | text | "1988 to 2010". |
operator.headquarters | text | The full headquarters address, with headquartersCity and headquartersState split out. |
operator.location | text | "Franklin, TN", with locationCity and locationState split out. |
operator.websites | list of URLs | |
operator.parentCompanies, owners, investors | list of text | With years in brackets when known. |
operator.keyStaff | {ceo, founders, keyExecutives} | ceo is a name; the two lists take {name, role, pastJobs}. |
operator.notes | list of text | Dated events with sources: acquisitions, sales, bankruptcies, settlements. |
facilities | list 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.
| Field | Type | What goes here |
|---|---|---|
name required | text | Full name as a source gives it, middle initial included. |
otherNames | list of text | Maiden names, nicknames, other spellings a source shows are the same person. |
pool | one value | industry (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). |
jobs | list of {place, placeCity, placeState, role, years, source, sourceUrl} | One line per job. place is a program or company; years is text ("2004-2008"). |
relations | list of {otherName, kind, detail, source, sourceUrl} | Ties to another person: kind such as spouse, parent, sibling, business partner. |
notes | list of text | Arrests, licenses lost, statements, each with its source. |
Lawsuits
| Field | Type | What goes here |
|---|---|---|
case_name required | text | The caption, with the program in brackets when the caption doesn't name it. |
case_number | text | Docket number or citation. |
court | text | "U.S. District Court for the District of Utah". |
jurisdiction | text | The state's full name, or Federal. |
filing_date | date or null | YYYY-MM-DD. With only the year, use YYYY-01-01 and say so in summary. |
status | one value | Listed below. |
plaintiffs, defendants | list of text | As the caption names them. Minor plaintiffs by initials or "Doe" names only. |
facilities_mentioned | list of text | "Program name (City, State)". |
staff_mentioned, organizations_mentioned | list of text | Staff and owners; companies. |
claims | list of text | Each claim in plain words ("Wrongful death", "Negligent supervision"). |
outcome | text | Verdict, ruling, dismissal or settlement terms. |
settlement_amount | text | As stated: "$4.5 million". |
summary | text | What the case is about, in a few sentences. |
source_urls | list of URLs | Articles and docket pages. |
document_urls | list of URLs | The filings themselves: complaints, orders, opinions. |
tags | list of text | Free topics: restraint, transport, sexual abuse. |
status
closeddismissedfiledin_progressIn progressappealOn appealrulingRuling issuedsettledunknown
Bills
The file's list is called legislation.
| Field | Type | What goes here |
|---|---|---|
bill_title required | text | Official or short title. |
bill_number | text | "HB 123", "S. 1351". |
jurisdiction | text | The state's full name, or Federal. |
chamber | one value | house, senate, assembly, joint, federal_house, federal_senate, other, unknown. |
session_year | text | "2025" or "2025-2026". |
bill_type | text | HB, SB, AB, HR, SR... |
sponsors | list of text | "Ron Wyden (D-OR)". |
status | one value | Listed below. |
introduced_date, last_action_date | date or null | YYYY-MM-DD. |
last_action_text | text | The legislature's own wording of the last action. |
subject_tags | list of text | restraint, oversight, licensing, Medicaid... |
summary | text | What the bill does. |
full_text_url, official_url | URL | The bill text; the legislature's tracking page. |
facilities_affected | list of text | Programs it names or was written about. |
tags | list of text | Free topics. |
status
proposedProposed (discussion draft)introducedin_committeeIn committeepassed_housePassed Housepassed_senatePassed Senatesignedvetoeddeadenactedunknown
News
The file's list is called articles. If all you have is the link, use a source link instead.
| Field | Type | What goes here |
|---|---|---|
article_title required | text | The headline as published. |
author | text | Byline. |
publication_name | text | "The Salt Lake Tribune". |
publication_date | date or null | YYYY-MM-DD. |
article_url required | URL | The original address. |
archive_url | URL | An archived copy, if you used one. |
article_type | one value | Listed below. |
facilities_mentioned, staff_mentioned | list of text | Programs ("Name (City, State)") and staff it names. |
content_warnings | list of text | From the list below. |
tags | list of text | Topics; KOP's usual ones are below. |
summary | text | Two or three sentences on what the article reports. |
article_type
corporateCorporate Change ArticleexposeExposé or Survivor AccountclosureFacility Closure ArticlelawsuitLawsuit ArticleeventSpecific Event ArticlearrestStaff Arrest ArticlegeneralGeneral News Article
content_warnings
Autism-Specific AbuseChemical RestraintChild-on-Child CSAChild DeathChild Sexual AbuseConversion TherapyEating DisordersFood RestrictionForced LaborGraphic Descriptions of Assaults or InjuriesHate CrimesHomophobiaHumiliating PunishmentsInvoluntary TransportLaw Enforcement AbuseMedical NeglectPeer ViolencePhysical RestraintRacismSeclusionSelf-harmSlursSpiritual AbuseSubstance AbuseSuicideTransphobiaUnsanitary ConditionsVictim Blaming
tags
AdoptionArrestChild Protective ServicesClosureConversion TherapyCorporate GovernanceDeathDisability RightsDocumentaryEscapeFaith-Based ProgramsFamily LawForced LaborFoster CareGroup HomeHuman TraffickingImmigrationJuvenile JusticeKidnappingLegislationLGBTQ+ RightsLicensingMedicaidOversightPrivate PrisonsPrivate SchoolsRiotSafety ViolationsSelf-HarmSettlementSexual MisconductStaff MisconductSuicideSurvivor StoriesTransportTrialWilderness 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.
| Field | Type | What goes here |
|---|---|---|
facility_info.facility_name required | text | The licensee or site name as the state lists it. |
facility_info.program_name | text | The program or building name, when the state lists one separately. |
facility_info.full_address, phone | text | |
facility_info.program_category | text | The state's own license category ("Group Home"). |
facility_info.executive_director | text | |
facility_info.bed_capacity | text | As the state shows it. |
facility_info.license_number, license_exp_date, relicense_visit_date | text | As the state shows them. |
facility_info.action | text | Any license action shown (probation, revocation). |
reports[].report_id required | text | The state's id for the report, or another value unique within the facility. |
reports[].report_date | text | As the state shows it. |
reports[].report_url | URL | A link that opens this report, not the search page. |
reports[].raw_content | text | The full report text. |
reports[].content_length | whole number | Characters in raw_content. |
reports[].summary | text | Optional one-line summary. |
Source links
A plain list. KOP checks each link against what it already holds and sends the new ones to its review inbox.
| Field | Type | What goes here |
|---|---|---|
type | one value | article (news, opinion, press release), lawsuit (court records, dockets), legislation (bills), website (everything else). |
url required | URL | |
title | text | The page's title. |
notes | text | Which program, company or person it is about, why it matters, and the key quote. |
website_kind | one value | For website only; listed below. |
website_kind
archiveArchived pagebusinessBusiness or property recorddirectoryDirectory or listingforumForum post or threadglossarygovernmentGovernment page or recordin_their_own_wordsIn their own wordsmarketingMarketing group or referral serviceprogramProgram's own pageredditReddit post or threadreportReport or studyreview_page_yelp_google_indeedReview page (Yelp, Google, Indeed)socialSocial media poststaffStaff profile or resumeblogSurvivor blog or personal sitemediaVideo or podcastother
