TABLE OF CONTENTS
- Overview
- What Is a Data Export?
- What Is Included in This Data Export?
- How to Use the Exports
- How Not to Use the Exports
- Terminology
- Table Relationship Diagram
- Join Key Reference
- Data Type Conventions
- Frequently Asked Questions
- How can I get started with data exports?
- Why should I use Clutch's data exports?
- What's the cost?
- How long are the exports available for download?
- What should I do if I didn't receive my daily file?
- I lost access to a file and I need to recover a copy. How can I get it?
- I need a data export for sandbox data. How do I get it?
- Why are some applications missing from the export?
- Why are the member number, housing, income, or employment fields blank for an application?
- How can I request a new data export to answer new business questions?
- Can I ask for additional fields in my data export?
- What should I do if I want to report an inconsistency in the data?
- Getting Help
Overview
This article helps users at partner credit unions understand the Clutch Lending STP (Straight-Through Processing) data export: the files it contains, their columns, and how to use them.
This export covers loan applications that were processed through Clutch's straight-through processing (STP) flow, from the application through decision, booking to your core, and funding. It is a relational export: a set of tables that join to each other, rather than a single flat file. It is a focused subset of the Clutch Lending LOS (LAS) export, plus a few fields specific to STP (core account number and funded timestamp).
What Is a Data Export?
A data export is a daily batch of data, sent in .csv format via SFTP. Each file contains one table in a fixed, predetermined format.
- Frequency: daily
- Channel: SFTP
- Format: .csv, pipe-delimited, with a header row. Every value is double-quoted, and a missing value is delivered as an empty quoted value (
"") - Data included: a fixed, predetermined format that scales across credit unions
What Is Included in This Data Export?
Six tables, each delivered as its own file. For each table there are two variants:
- Past 1 day: records created or updated during the previous calendar day (UTC), delivered under a folder named
stp_<table>-1-day - Past 30 days: records created or updated during the previous 30 calendar days (UTC, ending at midnight today), delivered under a folder named
stp_<table>-30-day
Both variants have the same columns; they differ in the time window and total volume. When no record falls in the window, you still receive a file that contains only the header row.
Only applications that were processed through straight-through processing are included, regardless of the outcome (funded, declined, routed to manual handling, failed, or still in progress). Applications that never entered the STP flow do not appear in this export.
The six tables, each with its own article containing the full data dictionary:
| Table | What It Contains |
|---|---|
loan_applications | One row per STP loan application — the hub every other table joins to. Includes the main applicant's member number and housing, income and employment profile. |
loan_products | The product requested on each application (offering, amount, term, APR). |
participants | The applicants (primary and co-applicant) with their compliance screening flags. |
decisions | The latest final decision per participant. |
closing_information | Loan calculation outputs (TILA fields), the core account number, and the funded timestamp. |
disbursements | Where the loan proceeds were directed (deposits to member accounts, loan payoffs, checks, general ledger entries), one row per disbursement. |
How to Use the Exports
Data warehouse ingestion
- Recommended: ingest the 30-day file of each table into your warehouse while upserting records (updating existing rows and inserting new ones) based on the primary key
id. This way, if your ingestion process skips a day, it will catch up on the next run. - Or append the 1-day file into your warehouse, taking care to check whether the record already exists there. Use the
updated_oncolumn to keep only the latest version of each record (fordecisions, which does not deliverupdated_on, upsert onid).
Analysis
- If you are going to analyze the data in a spreadsheet, use the 30-day files so you do not need to append anything.
Joining tables
- All tables join to
loan_applicationsviaapplication_id. See the Join Key Reference below.
How Not to Use the Exports
Important: If you need a metric spanning more than 30 days, do not append multiple 30-day files without a proper merge or upsert operation — you will get duplicates of the same records. Iterate through the files keeping the most recent version of each record (by
id, usingupdated_on).
- Do not treat the
idof a disbursement as permanent: it can change when the application's disbursement list is saved again. See thedisbursementsarticle. - Do not join tables by row order or by timestamps. Always use the documented keys (
application_id,participant_id).
Terminology
- An application is a loan application originated in the Clutch Lending LOS for your credit union that was processed through straight-through processing (STP).
- A participant is an applicant on an application. An application always has a
primaryparticipant and may have aco_applicant. Filter onroleto separate them. - The main applicant is the application's primary applicant. The member number and the housing, income and employment fields on
loan_applicationsdescribe the main applicant. - Routed off STP means the application was moved off the straight-through-processing path to manual handling (see
stp_off_board_stageandstp_off_board_reasononloan_applications). - The main applicant's information on
loan_applicationsis as reported on the application; it is blank when it could not be linked to the application.
Table Relationship Diagram
All tables join to loan_applications via application_id.
loan_applications (1)
├── loan_products (1:many, typically one)
├── participants (1:many, primary + co-applicant)
│ └── decisions (1:many, one per participant)
├── closing_information (1:1)
└── disbursements (1:many, one per disbursement)Secondary relationships
decisions.participant_id→participants.id
Join Key Reference
| From Table | Join Field | To Table | Join Field | Notes |
|---|---|---|---|---|
loan_products | application_id | loan_applications | id | 1:many (typically one per application) |
participants | application_id | loan_applications | id | 1:many (primary + co_applicant) |
decisions | application_id | loan_applications | id | Latest decision per participant |
decisions | participant_id | participants | id | Links decision to applicant |
closing_information | application_id | loan_applications | id | 1:1 per application |
disbursements | application_id | loan_applications | id | 1:many (one per disbursement) |
Data Type Conventions
| Type Label | Description | Example |
|---|---|---|
| UUID | 36-character universally unique identifier | a1b2c3d4-e5f6-... |
| String | Variable-length text | RENT |
| Integer | Whole number | 12, 503 |
| Decimal | Numeric with decimal precision | 0.1139, 50200.00 |
| Timestamp | ISO 8601 date and time with time zone (UTC) | 2025-11-15T14:32:00.000Z |
| Enum | Controlled vocabulary string | approved, declined |
Money fields are decimal USD dollars. Ratio fields are decimals (0.42 = 42%). Timestamps are UTC and include milliseconds. Any double quote (") inside a text value is replaced with a single quote (') so it does not break the file.
Frequently Asked Questions
How can I get started with data exports?
- Ask your Customer Success Manager to turn it on for you.
- The STP export is delivered via SFTP. That requires setting up an SFTP connection, so we may need to engage your IT team, and the server must be hosted by you. See Data Exports: API vs. SFTP Delivery for more on SFTP delivery.
Why should I use Clutch's data exports?
- It keeps your team informed about what's going on without having to ask for ad-hoc reports.
- You can work with the .csv files directly in Microsoft Excel or Google Sheets, and your IT team can ingest the data into your data warehouse.
- It is an extract of data you can build your own reports on top of.
What's the cost?
- Clutch does not charge any additional fees.
- You will need to host your own SFTP server.
How long are the exports available for download?
- It is up to you — since you host the server, you decide how to manage the .csv files once we push them.
- If you need retroactive files, submit a ticket with our support team.
What should I do if I didn't receive my daily file?
- Contact Clutch Support and we will help you track it down. See Getting Help below.
I lost access to a file and I need to recover a copy. How can I get it?
- Contact your Customer Success Manager to arrange a recovery.
I need a data export for sandbox data. How do I get it?
- Sandbox contains only test users and can be misleading when interpreting data, so we do not support sandbox data exports.
Why are some applications missing from the export?
- This export only includes applications that were processed through straight-through processing (STP).
- Applications that never entered the STP flow are not included.
Why are the member number, housing, income, or employment fields blank for an application?
- These fields describe the application's main applicant and are filled in only when the main applicant can be linked to the application.
- They are blank when no active main applicant record is available, or when the applicant did not provide the information. Some fields are blank for most applications (for example
job_occupation), andincome_typeis currently always blank. employment_statusis not standardized: depending on where the information was captured it can be a short code (for exampleEM,RE,SE) or a label in any letter case (for exampleEMPLOYED,employed,SELF_EMPLOYED).
How can I request a new data export to answer new business questions?
- Help us understand exactly what you are trying to achieve. Your Clutch team can guide you if there is a way to use the existing exports.
- If there is not, they will raise the feedback with our product team.
Can I ask for additional fields in my data export?
- We do not currently support custom fields per credit union.
- Contact your Customer Success Manager to let them know which fields you need.
What should I do if I want to report an inconsistency in the data?
- Let your Customer Success Manager know and we will assign an engineer to look into it.
Getting Help
For questions about enabling this export, adding a table, or anything specific to your credit union's setup, start with your Customer Success Manager. If you need help from Clutch Support, you can:
- Submit a ticket in the Clutch Support Portal at support.withclutch.com/support/tickets/new (the "Submit a Ticket" link in the top navigation).
- Email support@withclutch.com.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article
