# Finosu

- [Introduction](https://docs.finosu.com/introduction.md): Connect your lending platform to Finosu for origination and collections.
- [Quickstart](https://docs.finosu.com/concepts.md): Authenticate and retrieve your first Finosu API response.
- [Common Workflows](https://docs.finosu.com/common-workflows.md): Enroll applications, board loans, retrieve results, and manage servicing.
- [API Basics](https://docs.finosu.com/api-reference/introduction.md): Base URL, authentication, and choosing your API workflow.
- [Upcoming API Changes](https://docs.finosu.com/api-reference/upcoming-changes.md): Proposed payment-plan retrieval, public API validation changes, and customer-field migration guidance
- [Create a Customer](https://docs.finosu.com/api-reference/endpoint/customers/create.md): Creates a new customer
- [Update a Customer](https://docs.finosu.com/api-reference/endpoint/customers/update.md): Updates a customer
- [Retrieve a Customer](https://docs.finosu.com/api-reference/endpoint/customers/get.md): Returns a specific customer from the system that the user has access to
- [List All Customers](https://docs.finosu.com/api-reference/endpoint/customers/all.md): Returns all customers from the system that the user has access to
- [Delete a Customer](https://docs.finosu.com/api-reference/endpoint/customers/delete.md): Deletes a customer
- [Batch Create Customers](https://docs.finosu.com/api-reference/endpoint/customers/batch.md): Submit a list for background processing. Explicit scheduleMode=enroll uses origination enrollment with a batch Idempotency-Key and per-row idempotencyKey. Omit scheduleMode for the existing customer-create workflow. HTTP 202 confirms acceptance, not successful processing of every row.
- [Upsert a Customer (Webhook)](https://docs.finosu.com/api-reference/endpoint/customers/webhook.md): Your system posts customer data to Finosu. This is an inbound API endpoint, not an outbound callback.
- [Sync Customer Schedules](https://docs.finosu.com/api-reference/endpoint/customers/schedule-sync.md): Sync a customer schedule. Omit scheduleMode or use replace for the existing replacement behavior. Explicitly use enroll for company-enabled application enrollment that preserves cadence progress and requires an Idempotency-Key.
- [Cancel All Communications](https://docs.finosu.com/api-reference/endpoint/customers/cancel-communications.md): Cancels all pending communications for a customer: scheduled calls, scheduled emails, scheduled SMS, and all active schedules
- [Create Scheduled Calls](https://docs.finosu.com/api-reference/endpoint/scheduled-calls/create.md): Creates scheduled calls for a customer. For origination enrollment use POST /customers/schedule/sync; for configured loan-based collections boarding use POST /loans.
- [Retrieve a Scheduled Call](https://docs.finosu.com/api-reference/endpoint/scheduled-calls/get-by-id.md): Returns a specific scheduled call from the system that the user has access to
- [List Scheduled Calls](https://docs.finosu.com/api-reference/endpoint/scheduled-calls/get.md): Returns all scheduled calls for a given customer
- [Cancel a Scheduled Call](https://docs.finosu.com/api-reference/endpoint/scheduled-calls/cancel.md): Cancels a specific scheduled call by ID
- [Cancel All Scheduled Calls](https://docs.finosu.com/api-reference/endpoint/scheduled-calls/cancel-all.md): Cancels all pending scheduled calls for a customer
- [Retrieve a Call](https://docs.finosu.com/api-reference/endpoint/calls/get-by-id.md): Returns a specific call in the authenticated company. recordingUrl is a fresh one-hour link or null if unavailable. Missing, deleted, or inaccessible calls return 404.
- [List All Calls](https://docs.finosu.com/api-reference/endpoint/calls/list.md): Retrieve your company’s call history with cursor pagination.
- [List Calls for a Customer](https://docs.finosu.com/api-reference/endpoint/calls/get.md): Returns a customer's calls from the last 30 days, newest first. For older history use GET /calls.
- [List Call Flags](https://docs.finosu.com/api-reference/endpoint/calls/flags.md): Returns the flag catalog for the requested task type, served from the flag registry — the same source call results use — so every flag that can appear in your call results is discoverable here. Scoped to the authenticated company, ordered alphabetically by name, no pagination. This lookup does not e…
- [Get Texts](https://docs.finosu.com/api-reference/endpoint/text/get.md): Returns all texts for a given customer
- [Get Emails](https://docs.finosu.com/api-reference/endpoint/email/get.md): Returns email history for a customer. limit and offset select email threads before their messages are flattened, so the number of returned messages may exceed limit.
- [New Call](https://docs.finosu.com/api-reference/endpoint/calls/webhook.md): Finosu posts call results to your configured receiver. /call/webhook is a documentation identifier, not an endpoint to call on api.finosu.com. Acknowledge with any 2xx status after durably accepting the event.
- [Transfer Note](https://docs.finosu.com/api-reference/endpoint/transfer-notes/transfer-note.md): Submit transfer note with call summary and verification details
- [LMS Customer Full Sync](https://docs.finosu.com/api-reference/endpoint/lms/sync-customer-full.md): Perform a full sync of a customer and all their loans from the company's configured LMS.
- [LMS Customer Batch Sync](https://docs.finosu.com/api-reference/endpoint/lms/sync-customer-full-batch.md): Queue 1–100 external customer IDs for background processing. HTTP 202 acknowledges the job, not successful synchronization.
- [LMS Batch Sync Status](https://docs.finosu.com/api-reference/endpoint/lms/sync-batch-status.md)
- [LMS Loan Sync](https://docs.finosu.com/api-reference/endpoint/lms/sync-loan.md): Sync a single loan and its associated customer from the company's configured LMS. This is a loan-centric entry point for LMS platforms where customer lookups don't reveal associated loans.
- [Origination Overview](https://docs.finosu.com/api-reference/origination/overview.md): Start new-lead, returning-borrower, and one-off outreach using your existing cadences.
- [Enroll an Application](https://docs.finosu.com/api-reference/endpoint/customers/origination-enrollment.md): Create or reuse a customer and enroll an application in its configured outreach cadence.
- [Enroll a List (Batch)](https://docs.finosu.com/api-reference/origination/batch.md): Send a customer/application list in one request. Finosu processes the list in the background and reports each row’s outcome.
- [Origination Examples](https://docs.finosu.com/api-reference/origination/examples.md): Complete requests for new leads, returning borrowers, and one-off calls, with retry handling.
- [Batch Progress and Results](https://docs.finosu.com/api-reference/origination/batch-status.md): Company-scoped job progress. Origination jobs return ordered per-row results and failures; customer-create jobs return failures with results empty. Partial while running. completed can include failed rows, so always inspect failed and the row outcomes.
- [List Origination Task Types](https://docs.finosu.com/api-reference/endpoint/task-types/list.md): Returns origination task types for POST /customers/schedule/sync with scheduleMode=enroll. This catalog does not indicate account enablement. For collections use GET /collections/task-types.
- [Close Origination](https://docs.finosu.com/api-reference/origination/close.md): Record the final outcome for an enrolled application and cancel its active/paused call, SMS and email cadences and pending communications atomically. No lender-side writes. Same-reason retries reassert closure; conflicting outcomes and active funded loans return 409. Queue-claimed calls remain owned…
- [List Origination Close Reasons](https://docs.finosu.com/api-reference/origination/close-reasons.md): Complete unpaginated catalog of case-sensitive origination close reasons. Requires an active X-API-Key.
- [Collections Overview](https://docs.finosu.com/api-reference/collections/overview.md): Service active loans: automated outreach, payment events, and servicing lifecycle.
- [List Collections Task Types](https://docs.finosu.com/api-reference/endpoint/collections/task-types.md): Returns collections task types for configured customer/loan boarding: create the customer, then POST /loans. This catalog does not indicate account enablement. For origination use GET /origination/task-types.
- [Create Loan](https://docs.finosu.com/api-reference/endpoint/loans/create.md): Create or update (upsert) a loan pushed from an external partner. The loan is keyed on (customer, externalReference). Returns 201 on create, 200 on update.
- [Create Loans (Batch)](https://docs.finosu.com/api-reference/endpoint/loans/batch.md): Create or update (upsert) many loans asynchronously. Large batches are split server-side into parallel slices of 25 rows. Returns a job ID immediately; poll GET /loans/batch/{jobId} for progress and for every row that failed. Each row has the same semantics as POST /loans, including the upsert on (c…
- [Update Loan](https://docs.finosu.com/api-reference/endpoint/loans/update.md): Partially update a loan by its external reference. Only send fields that changed. amountDue is immutable.
- [Delete Loan](https://docs.finosu.com/api-reference/endpoint/loans/delete.md): Soft-delete a loan. Sets servicing status to NOT_SERVICING, cancels scheduled payments and communications.
- [Cancel Loan Servicing](https://docs.finosu.com/api-reference/endpoint/loans/cancel-servicing.md): Cancel loan servicing and all associated scheduled payments and communications. Sets the loan's servicing status to NOT_SERVICING and cancels all pending scheduled payments, calls, emails, and SMS.
- [Cancel Customer Servicing](https://docs.finosu.com/api-reference/endpoint/customers/cancel-servicing.md): Cancel servicing for all loans belonging to a customer. Sets all loans' servicing status to NOT_SERVICING and cancels all pending scheduled payments, calls, emails, and SMS across all loans.
- [List Stop Servicing Reasons](https://docs.finosu.com/api-reference/endpoint/loans/stop-servicing-reasons.md): Returns the complete, unpaginated array of case-sensitive reasons accepted by both loan and customer cancel-servicing endpoints. Values are shared by all authenticated companies. Additional values may be added; clients must not rely on array positions or a fixed length.
- [Submit ACH Return](https://docs.finosu.com/api-reference/endpoint/ach-returns/create.md): Receive ACH return information and update the matching payment records.
- [Submit ACH Returns (Batch)](https://docs.finosu.com/api-reference/endpoint/ach-returns/batch.md): Process a batch independently and inspect each result; HTTP 200 does not mean every item succeeded.
- [Confirm ACH Settlement](https://docs.finosu.com/api-reference/endpoint/ach-confirms/create.md): Confirm settlement of an existing ACH payment.
- [Confirm ACH Settlements (Batch)](https://docs.finosu.com/api-reference/endpoint/ach-confirms/batch.md): Process a batch independently and inspect each result; HTTP 200 does not mean every item succeeded.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)

## Optional

- [Website](https://www.finosu.com/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.