Skip to main content
Migo Docs

Users and pre-qualifieds

The cr-users service manages the credit user identity. Creation is idempotent by document number: if a user with the same document already exists, the existing one is returned without duplicating.

Create user​

POST v2/credits/users/
Authorization: <token>
Content-Type: application/json
Body
{
"firstName": "Juan",
"lastName": "Pérez",
"document": { "type": "DPI", "number": "1234567890101", "expiration": "2030-01-01" },
"dateOfBirth": "1990-05-20",
"gender": "male",
"userAddress": {
"address": "Zona 10, Ciudad de Guatemala",
"department": "Guatemala",
"city": "Guatemala",
"country": "GT"
},
"middleName": "Carlos",
"secondSurname": "López",
"maritalStatus": "single",
"nationality": "GT",
"taxId": "1234567-8"
}

Required: firstName, lastName, document.type, document.number, dateOfBirth (YYYY-MM-DD), gender (male | female), userAddress (with address, department, city). Optional: middleName, extraName, secondSurname, marriedName, maritalStatus, nationality, taxId, document.expiration, userAddress.country.

Successful response
{
"success": true,
"data": {
"userId": "a1b2c3d4-...",
"documentType": "DPI",
"documentNumber": "1234567890101",
"status": "CREATED",
"createdAt": "2026-01-01T10:00:00.000Z"
}
}

Errors: 6010 (missing data), 6014 (invalid birth or expiration date), 6015 (invalid gender).

Query user​

GET v2/credits/users/{userUID}
Authorization: <token>
Response
{
"success": true,
"data": {
"userId": "a1b2c3d4-...",
"documentType": "DPI",
"documentNumber": "1234567890101",
"status": "ACTIVE",
"createdAt": "2026-01-01T10:00:00.000Z"
}
}

Errors: 6001 (missing userUID param or user does not exist).

Pre-qualifieds​

Pre-approved users before completing bank onboarding.

Create pre-qualified​

POST v2/credits/users/pre-qualifieds
Authorization: <token>
Content-Type: application/json
Body
{
"code": "PQ-001",
"customer": "miComercio",
"bank": "bam",
"name": "Juan Pérez",
"phone": "50212345678"
}

Required: code, customer, bank, name, phone.

Successful response
{
"success": true,
"data": {
"id": "665f...",
"code": "PQ-001",
"phone": "50212345678",
"name": "Juan Pérez",
"customer": "miComercio",
"bank": "bam",
"status": "CREATED"
}
}

Errors: 6010 (missing data or create/update error).

Query pre-qualified​

GET v2/credits/users/pre-qualifieds/{code}
Authorization: <token>

Returns an array of pre-qualifieds matching the code. Errors: 6010 (not found).

Next step: affiliate the user to a financial institution.