> ## 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.

# List Borrowers



## OpenAPI

````yaml /openapi/los.json get /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:
    get:
      tags:
        - Borrowers
      summary: List Borrowers
      operationId: getBorrowers
      parameters:
        - name: sort
          in: query
          required: false
          schema:
            type: string
            enum:
              - id
              - created
              - updated
        - name: id
          in: query
          required: false
          schema:
            type: string
        - name: role
          in: query
          required: false
          schema:
            type: string
        - name: rolloutUpdated.gte
          in: query
          required: false
          schema:
            type: string
        - name: rolloutUpdated.lte
          in: query
          required: false
          schema:
            type: string
        - name: next
          in: query
          required: false
          schema:
            type: string
            description: >-
              Cursor of the page to return, from the previous page's
              `_metadata.next`. Can't be combined with `offset`.
        - name: offset
          in: query
          required: false
          schema:
            type: number
            description: >-
              Number of records to skip, for offset paging. Defaults to 0. Can't
              be combined with `next`.
        - name: limit
          in: query
          required: false
          schema:
            default: 10
            description: Records per page, capped at 100.
            type: number
        - 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.
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    type: object
                    properties:
                      collection:
                        type: string
                        enum:
                          - borrowers
                        description: The key of this response that holds the records.
                      offset:
                        type: number
                        description: >-
                          Number of records skipped before this page: the
                          `offset` requested, or 0 on a cursor page.
                      limit:
                        type: number
                        description: >-
                          Page size applied: the `limit` requested, capped at
                          100, or 10 by default.
                      total:
                        type: number
                        description: >-
                          Number of records matching the request, across all
                          pages.
                      next:
                        nullable: true
                        description: >-
                          Cursor of the next page, to pass as `next`; null on
                          the last page.
                        type: string
                      nextLink:
                        nullable: true
                        description: >-
                          URL of the next page, this request's with `next` set;
                          null on the last page.
                        type: string
                    required:
                      - collection
                      - offset
                      - limit
                      - total
                      - next
                      - nextLink
                    description: How this page relates to the whole collection.
                  borrowers:
                    type: array
                    items:
                      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
                    description: The records of this page, under the collection's name.
                required:
                  - _metadata
                  - borrowers
        '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
      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.