Customer

/customer

Endpoint:

POST {url}/customer?data=antifraud,images,video,identity

🔐 Authentication

No prior authentication required; the request is validated using the auth_uuid and apiKey in the request body.

📥 Request Body

Content-Type: application/json

Campo	Tipo	Descripción	Obligatorio	Ejemplo
`auth_uuid`	`string`	The authorization UUID..	✅	`"01992d22-420f-7549-ba33-4fcf72954f48"`
`api_key`	`string`	The customer’s API Key.	✅	`"01992d22-420f-7549-ba33-4fcf72954f48"`
`data`	`string`	Optional. Comma-separated list of additional information to include in url	❌	`"antifraud,images,video,identity"`

Example Request

{
  "auth_uuid": "UUID",
  "api_key": "API_KEY"
}

📤 Responses
✅ 200 - OK

Description: Returns customer information and related process details.

Example Response:

{
    "general": {
        "auth": "019cbdb7-58b4-712f-886f-341bc0e39c51",
        "company": "SOLUCIONES TECH GLOBAL S.A.",
        "metadata": [],
        "location": [
            {
                "lat": "40.416775",
                "lon": "-3.703790"
            }
        ],
        "devices": [
            {
                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
            }
        ],
        "video": "https://cdn.fakeserver.io/streams/video_test_record_99823.mp4"
    },
    "process_uuid": "882b7c11-443d-733c-94d9-a22caf3cb367",
    "process_details": "",
    "process_status": "OK",
    "operations": {
        "OCR": {
            "uuid": "019cbdb7-5a05-709b-bba5-055864340dfd",
            "ip": "185.22.41.102",
            "completed": true,
            "state": "OK",
            "total_time": 45,
            "total_tries": 1,
            "start_at": "2026-03-12T10:00:10.000000Z",
            "end_at": "2026-03-12T10:01:15.000000Z",
            "address": "AVENIDA DEL PARQUE 45 3B",
            "birthdate": "1988-11-22 10:01:00",
            "country": "ESP",
            "country_place_of_birth": "ESP",
            "expiration_date": "2032-05-15 10:01:00",
            "first_surnames": "GARCIA",
            "gender": "M",
            "identifier": "12345678Z",
            "mrz1": "IDESPCJU99999912345678Z<<<<<<",
            "mrz2": "8811225M3205156ESP<<<<<<<<<<<2",
            "mrz3": "GARCIA<LOPEZ<<ALBERTO<<<<<<<<<",
            "municipality": "MADRID",
            "names": "ALBERTO",
            "nationality": "ESP",
            "parents_names": "JUAN / MARIA DEL CARMEN",
            "place_of_birth": "MADRID MADRID",
            "province": "MADRID",
            "second_surnames": "LOPEZ",
            "support_number": "ABC123456",
            "surnames": "GARCIA LOPEZ",
            "team_number": "99887X112",
            "document_type": "DNI_ESP",
            "aml": "false",
            "pep": "false",
            "start_side": "front",
            "antifraud": {
                "LEGAL_AGE": "OK",
                "EXPIRATED": "OK",
                "AML": "OK",
                "PEP": "OK",
                "AEAT": "OK",
                "MANIPULATED_PHOTO": "OK",
                "PHOTOCOPY": "OK",
                "SCREENPHOTO": "OK",
                "INCOMPLETE": "OK",
                "PROHIBITED_CAMERAS": "OK",
                "FRAUD_FACE": "OK",
                "FACIAL_RECOGNITION": "OK",
                "KO": "OK",
                "MRZ_VALIDATE": "OK"
            },
            "images": {
                "temporary": [
                    "https://storage.provider.com/bucket-test/img/temp_001.jpg?token=fake_sig_1",
                    "https://storage.provider.com/bucket-test/img/temp_002.jpg?token=fake_sig_2"
                ],
                "ocr_front": [
                    "https://storage.provider.com/bucket-test/img/front_scan_main.jpg?token=fake_sig_3"
                ],
                "ocr_back": [
                    "https://storage.provider.com/bucket-test/img/back_scan_main.jpg?token=fake_sig_4"
                ]
            }
        },
        "POL": {
            "uuid": "019cbdb7-5a25-7004-818d-dbba19104d1e",
            "ip": "185.22.41.102",
            "completed": true,
            "state": "OK",
            "total_time": 30,
            "total_tries": 0,
            "details": null,
            "start_at": "2026-03-12T09:59:00.000000Z",
            "end_at": "2026-03-12T10:00:00.000000Z",
            "low_age": "35",
            "high_age": "40",
            "type": "random",
            "antifraud": {
                "PROHIBITED_CAMERAS": "OK",
                "FRAUD_FACE_BLOCK": "OK"
            },
            "images": {
                "temporary": [
                    "https://storage.provider.com/bucket-test/pol/liveness_01.jpg?token=fake_sig_5",
                    "https://storage.provider.com/bucket-test/pol/liveness_02.jpg?token=fake_sig_6"
                ],
                "selfie": [
                    "https://storage.provider.com/bucket-test/pol/final_selfie.jpg?token=fake_sig_7"
                ]
            }
        }
    },
    "identity": {
        "uuid": "773a41e6-221f-731d-8aa7-9941eeeb6e2c",
        "identifier": "12345678Z",
        "names": "ALBERTO",
        "surnames": "GARCIA LOPEZ",
        "nationality": "ESP",
        "gender": "M",
        "birthdate": "1988-11-22",
        "expiration_date": "2032-05-15",
        "country_code": "ESP",
        "document_type": "DNI_ESP"
    }
}

❌ 401 - Unauthorized

Description: The client is not authorized or provided invalid credentials.

Example Response:

{
  "internal_code": 401,
  "message": "Not authorized"
}