# Blackswan

> Blackswan partner-facing HTTP API for customers, loans, repayments, and credit decisions.

## Docs

- [Authentication](https://docs.lms.bsa.ai/concepts/authentication.md): Every endpoint requires a Bearer JWT issued by the auth host.
- [Authorization](https://docs.lms.bsa.ai/concepts/authorization.md): How to obtain an auth token and how the API decides what you are allowed to do.
- [Errors](https://docs.lms.bsa.ai/concepts/errors.md): Error envelope, error codes, and how to branch on them.
- [IDs, dates, and money](https://docs.lms.bsa.ai/concepts/ids-dates-money.md): How identifiers, dates, and amounts are represented on the wire.
- [Pagination](https://docs.lms.bsa.ai/concepts/pagination.md): How list endpoints paginate, sort, and report total counts.
- [Boost credit limit](https://docs.lms.bsa.ai/credit-decisions/boost.md): Upload a financial statement PDF to attempt a credit-limit increase.
- [Get credit scorecard](https://docs.lms.bsa.ai/credit-decisions/scorecard.md): Fetch the current credit profile for a customer by externalId.
- [Close a customer](https://docs.lms.bsa.ai/customers/close.md): Permanently close an active customer.
- [Create a customer](https://docs.lms.bsa.ai/customers/create.md): Register a new customer record.
- [Delete a customer](https://docs.lms.bsa.ai/customers/delete.md): Permanently remove a customer record.
- [Get a customer](https://docs.lms.bsa.ai/customers/get.md): Fetch a single customer by LMS id or externalId.
- [List customers](https://docs.lms.bsa.ai/customers/list.md): Fetch a paginated list of customers.
- [Customers](https://docs.lms.bsa.ai/customers/overview.md): Create, manage, and close customer records.
- [Update a customer](https://docs.lms.bsa.ai/customers/update.md): Change the externalId on an existing customer record.
- [Introduction](https://docs.lms.bsa.ai/introduction.md): The Blackswan partner-facing HTTP API for customers, loans, repayments, and credit decisions.
- [Get a loan product](https://docs.lms.bsa.ai/loan-products/get.md): Fetch a single loan product by ID.
- [List loan products](https://docs.lms.bsa.ai/loan-products/list.md): Fetch all configured loan products.
- [Adjust disbursement date](https://docs.lms.bsa.ai/loans/adjust-disbursement-date.md): Shift an active loan's disbursal date when the partner-side wallet credit landed later than the LMS recorded.
- [Create a loan](https://docs.lms.bsa.ai/loans/create.md): Submit, approve, and disburse a loan in a single call. Returns an Active loan.
- [Delete a loan](https://docs.lms.bsa.ai/loans/delete.md): Permanently remove a pending loan.
- [Get a loan](https://docs.lms.bsa.ai/loans/get.md): Fetch a single loan by externalId or LMS id.
- [List loans](https://docs.lms.bsa.ai/loans/list.md): Fetch a paginated list of loans, filterable by customer and status.
- [Loans](https://docs.lms.bsa.ai/loans/overview.md): One-shot loan origination via POST /loans — submit, approve, and disburse in a single call.
- [Undo approval](https://docs.lms.bsa.ai/loans/undo-approval.md): Reverse an approval and return the loan to submitted state.
- [Undo disbursal](https://docs.lms.bsa.ai/loans/undo-disbursal.md): Reverse a disbursement and return the loan to approved state.
- [Update a loan](https://docs.lms.bsa.ai/loans/update.md): Modify a loan that is still in submitted and pending approval state.
- [Write off a loan](https://docs.lms.bsa.ai/loans/writeoff.md): Write off the outstanding balance of a delinquent loan.
- [Quickstart](https://docs.lms.bsa.ai/quickstart.md): Authenticate, create a customer, and create a loan in under five minutes.
- [Get a repayment](https://docs.lms.bsa.ai/repayments/get.md): Fetch a single transaction on a loan.
- [Repayments](https://docs.lms.bsa.ai/repayments/overview.md): Record repayments and look up posted transactions against active loans.
- [Record a repayment](https://docs.lms.bsa.ai/repayments/repay.md): Post a regular installment repayment.

## OpenAPI Specs

- [openapi](https://docs.lms.bsa.ai/api-reference/openapi.json)