Status

status

Endpoint:

PATCH {url}/customer/status

🔐 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"`
`state`	`string`	Updates the state of an existing process. OK,KO and CANCELLED	✅	`"KO"`
`reasons`	`string`	Optional. Reason persisted in processes.status_reasons. If the key is not sent, the stored value is not modified	❌	`"The status is changed manually"`

Example Request

{
  "api_key": "UUID",
  "auth_uuid": "API_KEY",
  "state": "KO",
  "reasons": "The status is changed manually"
}

📤 Responses
✅ 200 - OK

Description: Returns information and related process details.

Example Response:

{
    "data": {
        "name": " ",
        "document_number": null,
        "document_type": null,
        "process_uuid": "019a125d-2300-7288-a0ac-54adae9b9cce",
        "nationality": null,
        "auth_uuid": "019a125d-2378-73b9-991c-78be3946449a",
        "company": "Tecalis",
        "profile_alias": "Debug",
        "status": "KO",
        "status_reasons": "The status changed manually",
        "created_at": "2026-05-04T09:41:23.000000Z",
        "updated_at": "2026-05-05T07:51:38.000000Z",
        "cleaned": false,
        "operations": [
            {
                "type": "DOCUMENTS",
                "operation": "019df25d-252f-7389-a488-fd8ab68bdf34",
                "state": "NOT_STARTED",
                "total_time": 0
            },
            {
                "type": "HOME",
                "operation": "019df25d-24ec-721e-b2ce-16e8b52152cb",
                "state": "OK",
                "total_time": 13
            },
            {
                "type": "OCR",
                "operation": "019df25d-2503-71d0-98da-fb1344ddd395",
                "state": "KO",
                "total_time": 11
            },
            {
                "type": "POL",
                "operation": "019df25d-2518-72b2-b65e-bb6c411e0035",
                "state": "NOT_STARTED",
                "total_time": 0
            },
            {
                "type": "FINISH",
                "operation": "019df25d-2546-706c-b006-8a8e99cda330",
                "state": "KO",
                "total_time": 0
            }
        ]
    }
}

❌ 401 - Unauthorized

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

Example Response:

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