> ## 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. # Get a person > Returns an enriched person with active contact methods and current addresses. Returns 404 if the person isn't reachable by this token. ## OpenAPI ````yaml /api-reference/external_api.openapi.json get /v1/persons/{party_id} 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/{party_id}: get: tags: - Persons summary: Get a person description: >- Returns an enriched person with active contact methods and current addresses. Returns 404 if the person isn't reachable by this token. operationId: get_person_v1_persons__party_id__get parameters: - name: party_id in: path required: true schema: type: string title: Party Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PersonDetailRow' '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: PersonDetailRow: 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. contact_methods: items: $ref: '#/components/schemas/ContactMethodRow' type: array title: Contact Methods description: Active client-safe phone and email methods. addresses: items: $ref: '#/components/schemas/AddressRow' type: array title: Addresses description: Current client-safe addresses. type: object required: - id - display_name - first_name - last_name - is_active title: PersonDetailRow description: Detailed person record with contact methods and current addresses. 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. ContactMethodRow: properties: type: type: string title: Type description: Contact channel, such as phone or email. value: type: string title: Value description: Dialable phone number or email address. extension: anyOf: - type: string - type: 'null' title: Extension description: Phone extension, when applicable. usage_type: anyOf: - type: string - type: 'null' title: Usage Type description: Usage classification such as mobile or home. is_primary: type: boolean title: Is Primary description: Whether this is the preferred method for its type. is_active: type: boolean title: Is Active description: Whether this contact method can currently be used. verified_at: anyOf: - type: string format: date-time - type: 'null' title: Verified At description: When ownership was last verified. line_type: anyOf: - type: string - type: 'null' title: Line Type description: Detected phone line type, when available. carrier_name: anyOf: - type: string - type: 'null' title: Carrier Name description: Detected phone carrier, when available. is_textable: anyOf: - type: boolean - type: 'null' title: Is Textable description: Whether the phone line can receive SMS. deactivated_at: anyOf: - type: string format: date-time - type: 'null' title: Deactivated At description: When the carrier reported the line inactive. type: object required: - type - value - is_primary - is_active title: ContactMethodRow description: An active client-safe phone or email contact method. AddressRow: properties: party_address_id: type: string title: Party Address Id description: The party-address relationship ID for this address row. type: type: string title: Type description: Address usage type, such as home or mailing. is_current: type: boolean title: Is Current description: Whether this is a current address. line_1: type: string title: Line 1 description: Primary street-address line. line_2: anyOf: - type: string - type: 'null' title: Line 2 description: Secondary street-address line. city: type: string title: City description: City or locality. state: anyOf: - type: string - type: 'null' title: State description: >- State, province, or subdivision code, where the country uses one. Null for countries with no subdivision in an address. postal_code: anyOf: - type: string - type: 'null' title: Postal Code description: >- Postal code as provided by the source, in the local format. Null for countries that do not use postal codes. country: type: string title: Country description: Country code or name stored for the address. effective_from: anyOf: - type: string format: date - type: 'null' title: Effective From description: Date this party-address relationship began. effective_until: anyOf: - type: string format: date - type: 'null' title: Effective Until description: Date this party-address relationship ended. type: object required: - party_address_id - type - is_current - line_1 - city - country title: AddressRow description: A current client-safe address associated with a person. 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.