For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
    • Home
    • API Basics
  • Products
    • Global Fiat Payouts
    • On-Ramps and Off-Ramps
  • Integration Guides
    • Global payouts integration guide
    • Country-specific details
  • API Reference
      • GETList Individuals
      • POSTCreate an Individual
      • GETRetrieve an Individual
LogoLogo
API ReferenceIndividuals

Create an Individual

POST
https://api.latitude.xyz/v1/individuals
POST
/v1/individuals
$curl -X POST https://api.latitude.xyz/v1/individuals \
> -H "Content-Type: application/json" \
> -d '{
> "given_name": "Maria",
> "family_name": "Gonzalez",
> "country": "AR",
> "address": {
> "line_1": "Av. Corrientes 1234",
> "city": "Buenos Aires",
> "state": "CABA",
> "postal_code": "1043"
> },
> "product_types": [
> "global_payouts"
> ],
> "financial_accounts": [
> {
> "details": {}
> }
> ]
>}'
201Created
1{
2 "id": "ind_9f8b7c6d-1234-4e56-8a9b-0c1d2e3f4a5b",
3 "given_name": "Maria",
4 "family_name": "Gonzalez",
5 "email": "[email protected]",
6 "phone": "+54 11 2345 6789",
7 "date_of_birth": "1985-07-20",
8 "idv_consent_recorded_at": "2024-04-10T14:22:00Z",
9 "address": {
10 "country": "AR",
11 "line_1": "Av. Corrientes 1234",
12 "line_2": "Apt 5B",
13 "city": "Buenos Aires",
14 "state": "CABA",
15 "postal_code": "1043"
16 },
17 "country": "AR",
18 "status": "active",
19 "product_types": [
20 "global_payouts"
21 ],
22 "financial_accounts": [
23 {
24 "id": "fa_123e4567-e89b-12d3-a456-426614174000",
25 "type": "pix",
26 "details": {},
27 "created_at": "2024-01-15T09:30:00Z",
28 "updated_at": "2024-01-15T09:30:00Z"
29 }
30 ],
31 "created_at": "2024-04-10T14:20:00Z",
32 "updated_at": "2024-04-10T14:22:00Z",
33 "document": {
34 "type": "cuit",
35 "number": "20-12345678-9"
36 },
37 "status_details": [
38 {
39 "code": "verification_front_image_needed",
40 "message": "Front image of the document is required for verification."
41 }
42 ]
43}
Creates a new individual with the provided details for Latitude products
Was this page helpful?
Previous

Retrieve an Individual

Next
Built with

Request

This endpoint expects an object.
given_namestringRequired

The individual’s given name (first name)

family_namestringRequired

The individual’s family name (last name)

countryenumRequired

Country code (e.g., MX, US)

addressobjectRequired
Address information for the individual
product_typeslist of enumsRequired

Product types to enroll the individual in (e.g., on_ramp, off_ramp)

Allowed values:
financial_accountslist of objectsRequired
Financial accounts for the individual
emailstringOptional
The individual's email address
phonestringOptional
The individual's phone number
documentobjectOptional
Document information for identity verification
date_of_birthstringOptional

Date of birth (YYYY-MM-DD format)

idv_consent_recorded_atstringOptional

ISO8601 when IDV consent was recorded; required for on_ramp or off_ramp

Response

Create an Individual
idstring
Unique public identifier for the individual
given_namestring
Individual's given name
family_namestring
Individual's family name
emailstring
Individual's email address
phonestring
Individual's phone number
date_of_birthstring

Date of birth (YYYY-MM-DD)

idv_consent_recorded_atstring

ISO8601 timestamp when IDV consent was recorded (on_ramp / off_ramp)

addressobject
Address information for the individual
countryenum

Country code (e.g., MX, US)

statusenum
Current KYC status of the individual
Allowed values:
product_typeslist of enums
Product types for the individual
Allowed values:
financial_accountslist of objects
Financial accounts for the individual
created_atstring
ISO 8601 timestamp when the individual was created
updated_atstring
ISO 8601 timestamp when the individual was last updated
documentobject
Document information for identity verification
status_detailslist of objects
Detail codes and messages explaining the current status