> ## Documentation Index > Fetch the complete documentation index at: https://docs.montereyfinancial.com/llms.txt > Use this file to discover all available pages before exploring further. # List persons > Paginated list of persons (borrowers) visible to the calling access token's organization allowlist. ## OpenAPI ````yaml /api-reference/external_api.openapi.json get /v1/persons openapi: 3.1.0 info: title: Monterey Client API description: >- Org-scoped, token-authenticated account, borrower, and payment endpoints for Monterey Financial clients. version: 1.0.0 servers: - url: https://eapi.montereyfinancial.com description: Production security: - BearerToken: [] tags: - name: Authentication description: Exchange API keys for access tokens. - name: Organizations description: Organizations visible to the API key. - name: Persons description: Borrowers visible through in-scope accounts. - name: Accounts description: Servicing accounts and identifier lookups. - name: Transactions description: Account money-movement history. - name: Payment Methods description: Stored payment instruments. - name: Autopay description: Recurring payment schedules. paths: /v1/persons: get: tags: - Persons summary: List persons description: >- Paginated list of persons (borrowers) visible to the calling access token's organization allowlist. operationId: list_persons_v1_persons_get parameters: - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Opaque pagination cursor from a previous response's `page.next_cursor`. Omit on the first page. title: Cursor description: >- Opaque pagination cursor from a previous response's `page.next_cursor`. Omit on the first page. - name: limit in: query required: false schema: anyOf: - type: integer maximum: 1000 minimum: 1 - type: 'null' description: >- Page size for cursor pagination. Default 100, minimum 1, maximum 1000. Requests above the maximum return 422 — narrow your page size and use the returned `next_cursor` to walk additional pages. title: Limit description: >- Page size for cursor pagination. Default 100, minimum 1, maximum 1000. Requests above the maximum return 422 — narrow your page size and use the returned `next_cursor` to walk additional pages. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Page_PersonRow_' '400': description: The `cursor` is malformed or was tampered with (`invalid_cursor`). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Missing or invalid access token. '403': description: Authenticated token lacks the required scope (`insufficient_scope`). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Resource not in scope or does not exist. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerToken: [] components: schemas: Page_PersonRow_: properties: items: items: $ref: '#/components/schemas/PersonRow' type: array title: Items page: $ref: '#/components/schemas/PageMeta' type: object required: - items - page title: Page[PersonRow] description: 'A page of results: `items` plus a `page` pagination envelope.' ErrorResponse: properties: detail: $ref: '#/components/schemas/ErrorBody' type: object required: - detail title: ErrorResponse description: Standard error envelope. Branch on `detail.error_code`. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError description: >- Parameter-validation error (HTTP 422). `detail` lists each violated constraint with its location, message, and type. PersonRow: properties: id: type: string title: Id description: The person's unique party ID. display_name: type: string title: Display Name description: The person's client-facing display name. first_name: type: string title: First Name description: The person's first name. last_name: type: string title: Last Name description: The person's last name. date_of_birth: anyOf: - type: string format: date - type: 'null' title: Date Of Birth description: The person's date of birth. ssn_last_four: anyOf: - type: string - type: 'null' title: Ssn Last Four description: Last four SSN digits; the full hash is never exposed. primary_phone: anyOf: - type: string - type: 'null' title: Primary Phone description: Preferred active phone, or newest active phone. primary_email: anyOf: - type: string - type: 'null' title: Primary Email description: Preferred active email, or newest active email. preferred_language: anyOf: - type: string - type: 'null' title: Preferred Language description: Preferred language code. is_active: type: boolean title: Is Active description: Whether the person is active. type: object required: - id - display_name - first_name - last_name - is_active title: PersonRow description: Thin person record returned by paginated list endpoints. PageMeta: properties: next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: Opaque token to pass as ?cursor= to fetch the next page. has_more: type: boolean title: Has More description: True if more rows exist past this page. limit: type: integer title: Limit description: Echo of the resolved page size. type: object required: - has_more - limit title: PageMeta description: >- Pagination envelope on list responses. `next_cursor` is non-null when more rows exist — pass it back as `cursor` to continue. ErrorBody: properties: error_code: type: string title: Error Code type: object required: - error_code title: ErrorBody description: Standard error body. Branch on `error_code`. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError description: >- A single parameter-validation failure: `loc` is the path to the offending input, `msg` is human-readable, and `type` is the rule that failed. securitySchemes: BearerToken: type: http description: Short-lived access token minted by POST /v1/oauth/token. scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.