# List Individuals

**GET** `/individuals`

Base URL: `https://api.uat.triple-a.io/api/fiat-payout/v1`

This endpoint allows API users to retrieve a list of individuals they have created.

## Authorization

- oauth2 (http, bearer)

## Query parameters

- `page` (integer)
  Specify the page number
- `per_page` (integer)
  Specify the number of items per page
- `name` (string)
  Search individuals by `first_name` or `last_name`.
- `external_id` (string)

## Responses

### 200

OK

- `id` (string<uuid>, required)
  A UUID to identify an Individual.
- `external_id` (string, required)
  A reference given by API caller
- `gender` ("female" | "male")
  Gender
- `native_first_name` (string)
  First name or given name in native language
- `first_name` (string, required)
  First name or given name
- `native_last_name` (string)
  Last name or surname in native language
- `last_name` (string, required)
  Last name or surname
- `email` (string<email>)
  Email address
- `country_code` (string<iso-3166-1-alpha3>, required)
  Residence country
- `province_state` (string)
  Residence State/Province
- `city` (string)
  Residence city
- `native_address` (string)
  Residence address in native language
- `address` (string)
  Residence address
- `zip_code` (string)
  Residence address zip code or postal code
- `date_of_birth` (string<date>)
  Date of birth
- `place_of_birth` (string)
  Place of birth
- `mobile_number` (string)
  Mobile number
- `identification_type` ("RESIDENT_CARD" | "NATIONAL_ID" | "PASSPORT" | "TAX_ID" | "DRIVING_LICENSE" | "SOCIAL_SECURITY" | "OTHER", required)
  Identification type
- `identification_number` (string, required)
  Identification number
- `additional_identification_type` ("BVN")
  Additional identification type
- `additional_identification_number` (string)
  Identification number
- `nationality` (string<iso-3166-1-alpha3>)
  Nationality
- `remarks` (string)
  Remarks or notes
- `verification_status` ("none" | "missing" | "pending" | "failed" | "additional_kyc_required" | "confirmed")
  Individual KYC verification status
- `kyc_submitted` (boolean)
  Did the individual submit KYC information
- `daily_quota` (number)
  Daily limit of sending transfers
- `monthly_quota` (number)
  Monthly limit of sending transfers
- `yearly_quota` (number)
  Yearly limit of sending transfers
- `quota_currency` (string<iso-4217-ext>)
  Currency to be used for all quotas
- `created_at` (string<date-time>)
  Creation timestamp
- `updated_at` (string<date-time>)
  Last update timestamp
- `is_blocked` (boolean)
  Whether this sender entity is blocked for transfer operations. Managed by internal ops only.

Example:

```json
[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "external_id": "9c0eb636-84ac-4f78-a83c-83ab108d8cee",
    "gender": "female",
    "native_first_name": "占士",
    "first_name": "James",
    "native_last_name": "張",
    "last_name": "Zhang",
    "email": "jamse.zhang@example.com",
    "country_code": "USA",
    "province_state": "New York",
    "city": "New York City",
    "native_address": "51 號，福州路，廣州市",
    "address": "1 Falcon Ave, California",
    "zip_code": "12345",
    "date_of_birth": "2019-08-24",
    "place_of_birth": "New York City",
    "mobile_number": "+198766234",
    "identification_type": "NATIONAL_ID",
    "identification_number": "S98765433X",
    "additional_identification_type": "BVN",
    "additional_identification_number": 22227340549,
    "nationality": "SGP",
    "remarks": "string",
    "verification_status": "none",
    "kyc_submitted": true,
    "daily_quota": 10000,
    "monthly_quota": 50000,
    "yearly_quota": 100000,
    "quota_currency": "USD",
    "created_at": "1970-01-01T00:00:00.000Z",
    "updated_at": "1970-01-01T00:00:00.000Z",
    "is_blocked": true
  }
]
```