+
+
diff --git a/docs/models/collections.md b/docs/models/collections.md
new file mode 100644
index 000000000..bf0ae4893
--- /dev/null
+++ b/docs/models/collections.md
@@ -0,0 +1,31 @@
+### Collections
+
+A Collection represents a quarterly CX Data Collection.
+OMB collects CX Data on a quarterly basis from each of the High-impact Service Providers (HISPs).
+
+Data is published for download at https://www.performance.gov/cx/data/.
+
+|Field Name | Sample Input | Format | Description |
+|-- | -- | -- | -- |
+| id | 59 | Number | Unique number for a collection record. A collection record is generated for each HISP each reporting quarter. A record indicates whether HISP has reported survey(s) for the quarter, as well as how many surveys were reported. |
+| name | CX Quarterly Reporting | Text | Name of collection; same for all HISPs |
+| start_date | 10/1/2023 | Date | Start date of the reporting quarter |
+| end_date | 12/31/2023 | Date | End date of the reporting quarter |
+| service_provider_id | 36 | Number | Unique number for each HISP |
+| service_provider_name | Farm Service Agency | Text | Name of HISP |
+| service_provider_organization_id | 2098 | Number | Unique number for each department. A department may contain several HISPs. |
+| service_provider_organization_name | Department of Agriculture | Text | Name of department |
+| service_provider_organization_abbreviation | USDA | Text | Abbreviation of each department name |
+| organization_id | 2098 | Number | Unique number for each department. A department may contain several HISPs. |
+| organization_name | Department of Agriculture | Text | Name of department |
+| organization_abbreviation | USDA | Text | Abbreviation of each department name |
+| user_email | | Text | Email of POC for each HISP |
+| year | 2021 | Year | Year of reported data |
+| quarter | 1 | Quarter | Quarter of reported data |
+| reflection | This FY21 first quarter report completes the data collection for the first annual FPAC Producer Satisfaction Survey… | Text | Each HISP provide a reflection text on the insights gleaned from all surveys for the quarter. |
+| created_at | 2021-07-06 20:25:51 UTC | Date | Timestamp for creation of collection record |
+| updated_at | 2021-08-04 16:29:20 UTC | Date | Timestamp for update to the collection record. May reflection HISP POC updating records and/or OMB reviewing data submission and approval to publish. |
+| rating | PARTIAL | Text | OMB provides a rating of the data submission after review. |
+| aasm_state | draft | Text | Indicates whether HISP records are in draft, submitted, or published. Draft is when OMB creates the collection record. Submitted indicates that HISP has affirmatively provided data submission. Published indicates that OMB has reviewed and cleared data submission for publishing. OMB uses the published tag as filter for HISPs that met the data reporting requirements. |
+| integrity_hash | | Text | This is an auto-generated tag for unique record. |
+| omb_cx_reporting_collections_count | 1 | Number | Number of surveys submitted by the HISPs for the quarter. |
\ No newline at end of file
diff --git a/docs/models/omb_cx_reporting_collections.md b/docs/models/omb_cx_reporting_collections.md
new file mode 100644
index 000000000..fad61fcfc
--- /dev/null
+++ b/docs/models/omb_cx_reporting_collections.md
@@ -0,0 +1,102 @@
+### OMB CX Reporting Collections
+
+An OMB CX Reporting Collection represents summary data for a single Service Channel within a CX Data Collection.
+OMB collects CX Data on a quarterly basis from each of the High-impact Service Providers (HISPs).
+
+Data is published for download at https://www.performance.gov/cx/data/.
+
+
+|Field Name | Sample Input | Format | Description|
+|-- | -- | -- | --|
+|id | 190 | Number | Unique number for each set of survey responses. Each number indicates a unique survey deployed by the HISPs. Each row corresponds to a unique survey.|
+|collection_id | 57 | Number | Unique number for a collection record. A collection record is generated for each HISP each reporting quarter. A collection record may include multiple surveys for the HISP service for the quarter.|
+|collection_year | 2021 | Year | Year of data collection|
+|collection_quarter | 1 | Quarter | Quarter of data collection|
+|collection_name | CX Quarterly Reporting | Text | Name of collection; same for all HISPs|
+|collection_organization_id | 2139 | Number | Unique number for each department. A department may contain several HISPs.|
+|collection_organization_name | DHS | Text | Name of department|
+|collection_organization_abbreviation | Department of Homeland Security | Text | Abbreviation of each department name|
+|service_provider_id | 7 | Number | Unique number for each HISP|
+|service_provider_name | Customs and Border Protection | Text | Name of HISP|
+|service_provider_organization_id | 2139 | Number | Unique number for each department. A department may contain several HISPs.|
+|service_provider_organization_name | Department of Homeland Security | Text | Name of department|
+|service_provider_organization_abbreviation | DHS | Text | Abbreviation of each department name|
+|service_provided | Travelers who contact the TCC about four travel programs (EVUS, ESTA, ADIS, and TTP) by phone or email | Text | Free text, HISP provides a description of the designated service provided at the point of the reported survey.|
+|service_id | 10 | Number | Unique number of the designated service associated with the reported survey.|
+|service_name | Contacting the CBP contact center | Text | Name of designated service associated with the reported survey|
+|transaction_point | | Text | Free text, HISP provides a description of the transaction point where the reported survey is provided to the customers.|
+|channel | | Text | Mode by which the reported survey is deployed.|
+|volume_of_customers | 0 | Number | Total number of customers served by the HISP within the designated service for the quarter|
+|volume_of_customers_provided_survey_opportunity | 0 | Number | Total number of customers provided with the reported customer feedback survey for the designated service during the quarter|
+|volume_of_respondents | 0 | Number | Total number of survey responses for the quarter|
+|omb_control_number | OMB Control Number | Text | HISP provides the OMB Control Number associated with the reported survey|
+|federal_register_url | Federal Register URL | Text | HISP provides the Federal Register URL associated with the reported survey|
+|q1_text | | Text | Text of the question measuring satisfaction in the reported survey|
+|q1_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q1_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q1_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q1_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q1_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q2_text | | Text | Text of the question measuring trust in the reported survey|
+|q2_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q2_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q2_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q2_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q2_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q3_text | | Text | Text of the question measuring effectiveness in the reported survey|
+|q3_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q3_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q3_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q3_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q3_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q4_text | | Text | Text of the question measuring ease in the reported survey|
+|q4_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q4_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q4_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q4_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q4_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q5_text | | Text | Text of the question measuring efficiency in the reported survey|
+|q5_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q5_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q5_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q5_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q5_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q6_text | | Text | Text of the question measuring transparency in the reported survey|
+|q6_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q6_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q6_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q6_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q6_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q7_text | | Text | Text of the question measuring employee interaction in the reported survey|
+|q7_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q7_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q7_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q7_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q7_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q8_text | | Text | HISP may provide text of additional question of interest.|
+|q8_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q8_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q8_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q8_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q8_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q9_text | | Text | HISP may provide text of additional question of interest.|
+|q9_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q9_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q9_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q9_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q9_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q10_text | | Text | HISP may provide text of additional question of interest.|
+|q10_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q10_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q10_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q10_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q10_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|q11_text | | Text | HISP may provide text of additional question of interest.|
+|q11_1 | 0 | Number | Total number of responses for 1-strongly disagree on a 1-5 bi-directional Likert Scale.|
+|q11_2 | 0 | Number | Total number of responses for 2-disagree on a 1-5 bi-directional Likert Scale.|
+|q11_3 | 0 | Number | Total number of responses for 3-neutral on a 1-5 bi-directional Likert Scale.|
+|q11_4 | 0 | Number | Total number of responses for 4-agree on a 1-5 bi-directional Likert Scale.|
+|q11_5 | 0 | Number | Total number of responses for 5-strongly agree on a 1-5 bi-directional Likert Scale.|
+|created_at | 2021-07-02 21:46:03 UTC | Date | Date of survey record creation by OMB|
+|updated_at | 2021-08-04 19:29:49 UTC | Date | Date of survey record update by HISP and/or modifcation and review by OMB|
+|operational_metrics | | Text | Free text, HISP may provide any additional text describing operational metrics associated with designated service of the reported survey.|
diff --git a/docs/models/service_providers.md b/docs/models/service_providers.md
new file mode 100644
index 000000000..4e61688b8
--- /dev/null
+++ b/docs/models/service_providers.md
@@ -0,0 +1,20 @@
+### Service Providers
+
+A Service Providers represents a HISP (High-impact Service Provider); a federal entity, as designated by the Director of the Office of Management and Budget (OMB), that provides or funds customer-facing services, including Federal services administered at the State or local level.
+
+OMB collects CX Data on a quarterly basis from each of the High-impact Service Providers (HISPs),
+and each OMB CX Reporting Collection references a Service Provider.
+
+Data is published for download at https://www.performance.gov/cx/data/.
+
+|Field Name|Sample Input|Format |Description|
+|:----|:----|:----|:----|
+|id|36|Number|Unique number for a collection record. A collection record is generated for each HISP each reporting quarter. A record indicates whether HISP has reported survey(s) for the quarter, as well as how many surveys were reported.organization_id|2098|Number|Unique number for each department. A department may contain several HISPs.organization_abbreviation|USDA|Text|Abbreviation of each department name|
+|organization_name|Department of Agriculture|Text|Name of department|
+|name|Farm Service Agency|Text|Name of HISP|
+|slug|usda-fsa|Text|Abbreciation of department and HISP namesdescription| |Text|Description of the HISP, services, and/or area of responsibility.notes| |Text|Field for HISP to provide additional notes.department|usda|Text|Abbreviation of department name|
+|department_abbreviation|usda|Text|Abbreviation of department name|
+|bureau|Farm Service Agency|Text|Name of HISP|
+|url| |Text|HISP may provide a website link to their agency.|
+|new|FALSE|Boolean|True or False for whether HISP is a new service provider.|
+|inactive|FALSE|Boolean|True or False for whether HISP is inactive.|
diff --git a/docs/models/services.md b/docs/models/services.md
new file mode 100644
index 000000000..b166bc298
--- /dev/null
+++ b/docs/models/services.md
@@ -0,0 +1,37 @@
+### Services
+
+A Service represents a service provided by a federal government agency.
+
+OMB collects CX Data on a quarterly basis from each of the High-impact Service Providers (HISPs),
+and each OMB CX Reporting Collection references a Services.
+
+Data is published for download at https://www.performance.gov/cx/data/.
+
+|Field Name|Sample Input|Format |Description|
+|:----|:----|:----|:----|
+|id|2|Number|Unique identifier for a Service.|
+|name|Receiving outpatient services|Text|Name of designated service of the HISP|
+|description|VHA sends email surveys to everyone who receives outpatient services. |Text|HISP provides a description of the designated service.|
+|organization_id|2129|Number|Unique number for each department. A department may contain several HISPs|
+|organization_abbreviation|VA|Text|Abbreviation of each department name|
+|organization_name|Department of Veterans Affairs|Text|Name of department|
+|service_provider_id|21|Number|Unique number for each HISP|
+|service_provider_name|Veterans Health Administration|Text|Name of HISP|
+|service_provider_slug|va-vha|Text|Abbreviation of department and HISP names|
+|justification_text| |Text|HISP provides a description for why this service was selected for priority designation.|
+|contact_center|FALSE|Boolean|True or False for whether the service involves a contact center and/or an interaction with a contact center|
+|kind|[]|Text|Identifies the category of service: compliance, administrative, benefits, recreation, informational, data and research, and regulatory|
+|transactional|FALSE|Boolean|True or False for whether the service is transactional|
+|notes| |Text|Field for HISP to provide additional notes|
+|hisp|FALSE|Boolean|True or False for identifying the agency as a HISP|
+|department|va|Text|Abbreviation of department name|
+|bureau|Veterans Health Administration|Text|Name of HISP|
+|service_abbreviation|vha|Text|Abbreviation of HISP names|
+|service_slug|va-vha|Text|Abbreviation of department and HISP names|
+|url| |Text|HISP may provide a website link to their service|
+|homepage_url| |Text|HISP may provide a website link to their service|
+|channels|[]|Text|HISP select channel(s) where their service is delivered|
+|tags|[]|Text|HISP may add tags as needed. No strict guidance on tag type|
+|available_in_person|FALSE|Boolean|True or False for whether service is available in person|
+|available_digitally|FALSE|Boolean|True or False for whether service is available digitally|
+|available_via_phone|FALSE|Boolean|True or False for whether service is available through telephone. |