> ## 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. # Create Borrower ## OpenAPI ````yaml /openapi/los.json post /borrowers 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: /borrowers: post: tags: - Borrowers summary: Create Borrower operationId: postBorrowers parameters: - 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: emails: type: array items: type: object properties: value: type: string type: type: string status: type: string isPrimary: nullable: true type: boolean required: - value - type - status - isPrimary name: type: string type: type: string phones: type: array items: type: object properties: value: type: string type: type: string status: type: string isPrimary: nullable: true type: boolean required: - value - type - status - isPrimary addresses: type: array items: type: object properties: type: type: string street: type: string city: type: string state: type: string code: type: string county: type: string country: type: string required: - type - street - city - state - code - country taxId: type: string loanId: type: string role: type: string required: - emails - name - type - phones - addresses - taxId - loanId application/x-www-form-urlencoded: schema: type: object properties: emails: type: array items: type: object properties: value: type: string type: type: string status: type: string isPrimary: nullable: true type: boolean required: - value - type - status - isPrimary name: type: string type: type: string phones: type: array items: type: object properties: value: type: string type: type: string status: type: string isPrimary: nullable: true type: boolean required: - value - type - status - isPrimary addresses: type: array items: type: object properties: type: type: string street: type: string city: type: string state: type: string code: type: string county: type: string country: type: string required: - type - street - city - state - code - country taxId: type: string loanId: type: string role: type: string required: - emails - name - type - phones - addresses - taxId - loanId multipart/form-data: schema: type: object properties: emails: type: array items: type: object properties: value: type: string type: type: string status: type: string isPrimary: nullable: true type: boolean required: - value - type - status - isPrimary name: type: string type: type: string phones: type: array items: type: object properties: value: type: string type: type: string status: type: string isPrimary: nullable: true type: boolean required: - value - type - status - isPrimary addresses: type: array items: type: object properties: type: type: string street: type: string city: type: string state: type: string code: type: string county: type: string country: type: string required: - type - street - city - state - code - country taxId: type: string loanId: type: string role: type: string required: - emails - name - type - phones - addresses - taxId - loanId responses: '201': description: Response for status 201 content: application/json: schema: type: object properties: id: type: string name: description: Present unless the request's `fields` leaves it out. type: string taxId: description: Present unless the request's `fields` leaves it out. type: string type: description: Present unless the request's `fields` leaves it out. type: string addresses: description: Present unless the request's `fields` leaves it out. type: array items: type: object properties: type: type: string street: type: string city: type: string state: type: string code: type: string county: type: string country: type: string required: - type - street - city - state - code - country emails: description: Present unless the request's `fields` leaves it out. type: array items: type: object properties: value: type: string type: type: string status: type: string isPrimary: nullable: true type: boolean relationshipId: type: number required: - value - type - status - isPrimary phones: description: Present unless the request's `fields` leaves it out. type: array items: type: object properties: value: type: string type: type: string status: type: string isPrimary: nullable: true type: boolean required: - value - type - status - isPrimary bio: description: Present unless the request's `fields` leaves it out. 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 nameFirst: description: Present unless the request's `fields` leaves it out. nullable: true type: string nameMiddle: description: Present unless the request's `fields` leaves it out. nullable: true type: string nameLast: description: Present unless the request's `fields` leaves it out. nullable: true type: string nameSuffix: description: Present unless the request's `fields` leaves it out. nullable: true type: string dateOfBirth: description: Present unless the request's `fields` leaves it out. nullable: true type: string citizenshipType: description: Present unless the request's `fields` leaves it out. nullable: true type: string maritalStatus: description: Present unless the request's `fields` leaves it out. nullable: true type: string dependentCount: description: Present unless the request's `fields` leaves it out. nullable: true type: number creditType: description: Present unless the request's `fields` leaves it out. nullable: true type: string jointBorrowerCount: description: Present unless the request's `fields` leaves it out. nullable: true type: number dependentAges: description: Present unless the request's `fields` leaves it out. nullable: true type: array items: type: number alternateNames: description: Present unless the request's `fields` leaves it out. nullable: true type: array items: type: object properties: first: nullable: true type: string middle: nullable: true type: string last: nullable: true type: string suffix: nullable: true type: string residences: description: Present unless the request's `fields` leaves it out. nullable: true type: array items: type: object properties: type: nullable: true type: string address: nullable: true type: object properties: type: type: string street: type: string city: type: string state: type: string code: type: string county: type: string country: type: string required: - type - street - city - state - code - country durationMonths: nullable: true type: number housingType: nullable: true type: string monthlyRent: nullable: true type: number employment: description: Present unless the request's `fields` leaves it out. nullable: true type: array items: type: object properties: employer: nullable: true type: string position: nullable: true type: string startDate: nullable: true type: string endDate: nullable: true type: string isCurrent: nullable: true type: boolean selfEmployed: nullable: true type: boolean ownershipShare: nullable: true type: number monthlyIncome: nullable: true type: object properties: base: nullable: true type: number overtime: nullable: true type: number bonus: nullable: true type: number commission: nullable: true type: number other: nullable: true type: number otherIncomeSources: description: Present unless the request's `fields` leaves it out. nullable: true type: array items: type: object properties: source: nullable: true type: string monthlyAmount: nullable: true type: number declarations: description: Present unless the request's `fields` leaves it out. nullable: true type: object additionalProperties: {} militaryService: description: Present unless the request's `fields` leaves it out. nullable: true type: object properties: servedInMilitary: nullable: true type: boolean currentlyServing: nullable: true type: boolean status: nullable: true type: string expirationDate: nullable: true type: string survivingSpouse: nullable: true type: boolean demographics: description: Present unless the request's `fields` leaves it out. nullable: true type: object properties: ethnicity: nullable: true type: array items: type: string hispanicOrigin: nullable: true type: string sex: nullable: true type: string race: nullable: true type: array items: type: string raceDetail: nullable: true type: string visualObservation: nullable: true type: object properties: ethnicity: nullable: true type: boolean sex: nullable: true type: boolean race: nullable: true type: boolean collectionMethod: nullable: true type: string unmarriedAddendum: description: Present unless the request's `fields` leaves it out. nullable: true type: object properties: hasSpousalRights: nullable: true type: boolean relationshipType: nullable: true type: string state: nullable: true type: string explanation: nullable: true type: string rolloutUpdated: description: Present unless the request's `fields` leaves it out. type: string originalIds: description: 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: {} required: - id '400': description: Response for status 400 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.