---
title: "Create Person"
method: POST
path: "/person"
---

# Create Person

`POST /person`

## Request body

- object
  - `name_first` string, required
  - `name_last` string, required
  - `name_other` string, required
  - `phone` string, required — Kindly provide the full phone number complete with the country prefix e.g. +11234567890
  - `email` string, required
  - `dob` string, date, required — Date format should be `YYYY-MM-DD`
  - `id_type` 'passport' | 'drivers_license' | 'national_id' | 'voters_card'
  - `id_number` string — Document number of either an International Passport, SSN, Drivers License, NIN, or Voters Card depending on the ID level of this individual
  - `id_country` string, required — Use ISO Alpha-2 country codes (e.g., "US" for United States) for accurate processing.
  - `bank_id_number` string — BVN for Nigerian ID holders
  - `kyc_level` 'preliminary' | 'basic'
  - `address` object, required
    - `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

## Response `201`

201

- object
  - `data` object
    - `id` 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_type` string
    - `id_upload` string
    - `address_line1` string
    - `address_city` string
    - `address_state` string
    - `address_country` 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/versions/cb65d8f214c3/schema)