> ## Documentation Index > Fetch the complete documentation index at: https://rollout.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update Loan ## OpenAPI ````yaml /openapi/los.json put /loans/{id} openapi: 3.0.3 info: title: Universal LOS API Documentation description: Development documentation version: '1.0' servers: - url: https://los.universal.rollout.com/api security: [] paths: /loans/{id}: put: tags: - Loans summary: Update Loan operationId: putLoansById parameters: - name: id in: path required: true schema: type: string - name: fields in: query required: false schema: type: string description: >- Comma-separated top-level fields to return; the parameter can also be repeated, once per field. `id` is always returned. Omit it, or pass `allFields`, to get every field, including `original`. Unknown names return 400. requestBody: required: true content: application/json: schema: type: object properties: type: type: string assignedUserId: type: string statusDate: type: string applicationDate: type: string closingDate: type: string fundingDate: type: string interestRate: type: number loanToValue: type: number amount: type: number rateAndTerms: type: object properties: monthlyPayment: type: number escrowIncluded: type: boolean pmiRequired: type: boolean pmiRate: type: number term: type: number purpose: type: string stage: type: string status: type: string application/x-www-form-urlencoded: schema: type: object properties: type: type: string assignedUserId: type: string statusDate: type: string applicationDate: type: string closingDate: type: string fundingDate: type: string interestRate: type: number loanToValue: type: number amount: type: number rateAndTerms: type: object properties: monthlyPayment: type: number escrowIncluded: type: boolean pmiRequired: type: boolean pmiRate: type: number term: type: number purpose: type: string stage: type: string status: type: string multipart/form-data: schema: type: object properties: type: type: string assignedUserId: type: string statusDate: type: string applicationDate: type: string closingDate: type: string fundingDate: type: string interestRate: type: number loanToValue: type: number amount: type: number rateAndTerms: type: object properties: monthlyPayment: type: number escrowIncluded: type: boolean pmiRequired: type: boolean pmiRate: type: number term: type: number purpose: type: string stage: type: string status: type: string responses: '200': description: Response for status 200 content: application/json: schema: type: object properties: id: type: string description: >- Rollout's stable universal id for this loan. Use this to reference the loan in the Rollout API. loanNumber: description: >- The human-facing loan number assigned by the source system, or null if it doesn't assign one. This is distinct from the source's internal record id (see originalIds) and from any source-specific GUID (available on `original`). Present unless the request's `fields` leaves it out. nullable: true type: string interestRate: description: Present unless the request's `fields` leaves it out. type: number amount: description: Present unless the request's `fields` leaves it out. type: number term: description: Present unless the request's `fields` leaves it out. nullable: true type: number loanToValue: description: Present unless the request's `fields` leaves it out. nullable: true type: number type: description: Present unless the request's `fields` leaves it out. type: string purpose: description: Present unless the request's `fields` leaves it out. type: string status: description: Present unless the request's `fields` leaves it out. type: string statusDate: description: Present unless the request's `fields` leaves it out. nullable: true type: string applicationDate: description: Present unless the request's `fields` leaves it out. nullable: true type: string closingDate: description: Present unless the request's `fields` leaves it out. nullable: true type: string fundingDate: description: Present unless the request's `fields` leaves it out. nullable: true type: string rateAndTerms: description: Present unless the request's `fields` leaves it out. type: object properties: monthlyPayment: type: number escrowIncluded: type: boolean pmiRequired: type: boolean pmiRate: type: number originalIds: description: >- The source system's own identifiers for this loan, keyed by original entity name (e.g. { loan: "17102475" } is the source's internal loan record id). This is NOT the human loan number (see loanNumber). Present unless the request's `fields` leaves it out. type: object additionalProperties: anyOf: - type: number - type: string original: description: Present unless the request's `fields` leaves it out. type: object additionalProperties: type: object additionalProperties: {} created: description: Present unless the request's `fields` leaves it out. nullable: true type: string updated: description: Present unless the request's `fields` leaves it out. nullable: true type: string userParticipantIds: description: Present unless the request's `fields` leaves it out. type: array items: type: string borrowerParticipantIds: description: Present unless the request's `fields` leaves it out. type: array items: type: string stage: description: Present unless the request's `fields` leaves it out. type: string stageHistory: description: Present unless the request's `fields` leaves it out. nullable: true type: array items: type: object properties: id: type: string name: type: string status: type: string scheduledStartDate: nullable: true type: string format: date-time actualStartDate: nullable: true type: string format: date-time completedDate: nullable: true type: string format: date-time plannedDurationDays: nullable: true type: number actualDurationDays: nullable: true type: number assignee: nullable: true type: object properties: id: nullable: true type: string name: nullable: true type: string email: nullable: true type: string phone: nullable: true type: string role: nullable: true type: string required: - id - name - email - phone - role requiresReview: nullable: true type: boolean isReviewed: nullable: true type: boolean order: nullable: true type: number isRequired: nullable: true type: boolean notes: type: string metadata: nullable: true required: - id - name - status loanFolder: description: Present unless the request's `fields` leaves it out. nullable: true type: string archived: description: Present unless the request's `fields` leaves it out. nullable: true type: boolean mortgageType: description: Present unless the request's `fields` leaves it out. nullable: true type: string lienType: description: Present unless the request's `fields` leaves it out. nullable: true type: string amortizationType: description: Present unless the request's `fields` leaves it out. nullable: true type: string armInitialPeriodMonths: description: Present unless the request's `fields` leaves it out. nullable: true type: number armSubsequentPeriodMonths: description: Present unless the request's `fields` leaves it out. nullable: true type: number expectedRentalIncome: description: Present unless the request's `fields` leaves it out. nullable: true type: number expectedNetRentalIncome: description: Present unless the request's `fields` leaves it out. nullable: true type: number communityProperty: description: Present unless the request's `fields` leaves it out. nullable: true type: boolean transactionDetail: description: Present unless the request's `fields` leaves it out. nullable: true type: string refinanceType: description: Present unless the request's `fields` leaves it out. nullable: true type: string refinanceProgram: description: Present unless the request's `fields` leaves it out. nullable: true type: string energyImprovement: description: Present unless the request's `fields` leaves it out. nullable: true type: string projectType: description: Present unless the request's `fields` leaves it out. nullable: true type: string proposedMonthlyPayment: description: Present unless the request's `fields` leaves it out. nullable: true type: object properties: firstMortgagePI: nullable: true type: number subordinatePI: nullable: true type: number homeownersInsurance: nullable: true type: number supplementalInsurance: nullable: true type: number propertyTaxes: nullable: true type: number mortgageInsurance: nullable: true type: number associationDues: nullable: true type: number other: nullable: true type: number total: nullable: true type: number loanFeatures: description: Present unless the request's `fields` leaves it out. nullable: true type: object properties: balloon: nullable: true type: boolean interestOnly: nullable: true type: boolean negativeAmortization: nullable: true type: boolean prepaymentPenalty: nullable: true type: boolean temporaryBuydown: nullable: true type: boolean other: nullable: true type: string qualifyingFunds: description: Present unless the request's `fields` leaves it out. nullable: true type: object properties: dueFromBorrower: nullable: true type: number totalMortgageLoans: nullable: true type: number totalCredits: nullable: true type: number cashFromToBorrower: nullable: true type: number titleInfo: description: Present unless the request's `fields` leaves it out. nullable: true type: object properties: heldInNames: nullable: true type: string currentlyHeldInNames: nullable: true type: string estateType: nullable: true type: string leaseholdExpiration: nullable: true type: string mannerOfTitle: nullable: true type: string trustInfo: nullable: true type: string tribalLand: nullable: true type: boolean loanOriginator: description: Present unless the request's `fields` leaves it out. nullable: true type: object properties: organizationName: nullable: true type: string organizationNmlsId: nullable: true type: string organizationStateLicense: nullable: true type: string individualName: nullable: true type: string individualNmlsId: nullable: true type: string individualStateLicense: nullable: true type: string email: nullable: true type: string phone: nullable: true type: string otherNewMortgageLoans: description: Present unless the request's `fields` leaves it out. nullable: true type: array items: type: object properties: creditor: nullable: true type: string lienType: nullable: true type: string monthlyPayment: nullable: true type: number loanAmount: nullable: true type: number creditLimit: nullable: true type: number giftsOrGrants: description: Present unless the request's `fields` leaves it out. nullable: true type: array items: type: object properties: assetType: nullable: true type: string source: nullable: true type: string deposited: nullable: true type: boolean value: nullable: true type: number rolloutUpdated: description: Present unless the request's `fields` leaves it out. type: string required: - id '400': description: Response for status 400 content: application/json: schema: type: object properties: errorMessage: type: string required: - errorMessage '404': description: Response for status 404 content: application/json: schema: type: object properties: errorMessage: type: string required: - errorMessage '409': description: Response for status 409 content: application/json: schema: type: object properties: errorMessage: type: string enum: - >- Data for this credential is not ready yet. Please try again. required: - errorMessage '423': description: >- 423 Locked — the credential is temporarily frozen by an operator. Reads still work; POST/PATCH/PUT/DELETE are rejected until it is unfrozen. Unlike 424 (invalid credential), do not re-authenticate — retry later. content: application/json: schema: type: object properties: errors: type: array items: type: object properties: message: type: string required: - message required: - errors security: - jwt: [] credential_id: [] components: securitySchemes: jwt: type: http scheme: bearer description: Consumer JWT minted by the tenant's backend credential_id: type: apiKey in: header name: X-Rollout-Credential-Id description: The Rollout Credential ID to use for queries/mutations ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.