---
title: "Update Person"
method: PATCH
path: "/person/{person_id}"
---

# Update Person

`PATCH /person/{person_id}`

## Path parameters

- `person_id` string, required

## Request body

- object
  - `name_first` string
  - `name_last` string
  - `name_other` string
  - `email` string
  - `phone` string
  - `dob` string, date
  - `address` object
    - `line1` string, required
    - `line2` string
    - `city` string, required
    - `state` string, required
    - `country` string, required — NOTE: Use the ISO Alpha 2 country code format to ensure accurate processing. e.g United States should be passed as 'US', Nigeria should be passed as 'NG' and so on.
    - `postal_code` string, required
  - `background_information` object
    - `employment_status` 'employed' | 'self_employed' | 'unemployed' | 'student' | 'retired'
    - `occupation` string
    - `primary_purpose` 'business' | 'personal' | 'salary' | 'freelance'
    - `source_of_funds` 'salary' | 'savings' | 'business' | 'freelance' | 'investment' | 'government_benefits' | 'pension'
    - `expected_monthly_inflow` integer
  - `documents` object[]
    - `type` 'passport' | 'national_id' | 'drivers_licence' | 'residence_permit' | 'voters_card' | 'bank_statement' | 'utility_bill' | 'incorporation_certificate' | 'registration_certificate' | 'memorandum_articles' | 'business_licence' | 'cac', required
    - `url` string, required
    - `issue_date` string, date
    - `expiry_date` string, date
  - `id_type` 'passport' | 'drivers_license' | 'national_id' | 'voters_card'
  - `id_country` string — Use ISO Alpha-2 country codes (e.g., "US" for United States) for accurate processing.
  - `id_number` string
  - `bank_id_number` string

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `environment` string
    - `name_first` string
    - `name_last` string
    - `name_other` string
    - `email` string
    - `phone` string
    - `dob` string
    - `id_level` string
    - `id_type` string
    - `id_number` string
    - `id_country` string
    - `id_upload` string
    - `id_upload_type` string
    - `bank_id_number` string
    - `bank_id_type` string
    - `address` object
      - `line1` string
      - `line2` string
      - `city` string
      - `state` string
      - `country` string
      - `postal_code` string
    - `status` string
    - `kyc_status` string
    - `kyc_level` string
    - `is_deleted` boolean
    - `created_at` string
    - `updated_at` string
  - `message` string
  - `meta` unknown
  - `status` string

---

[API](https://skmtc.net/useoval/apis/core-api.md) · [All operations](https://skmtc.net/useoval/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/useoval/core-api/revisions/cb65d8f214c3/schema)