Como consultar una transferencia

Consultar una transferencia

En caso de requerirse, las Entidades Participantes pueden consultar el estado actual de una transacción.El id del path corresponde al identificador de la transacción asignado por la Entidad Participante Origen al momento de creación de la transacción.

Dominio: https://bank.apihub.crt.achcolombia.com.co
GET v1/money-movement/transfers/{id}

Campos de entrada (Headers)

Campo Tipo Validación Descripción Obligatoriedad
movementType Lista Corresponde al tipo de transacción a consultar Identificador del schema del flujo transaccional. Si

Request consulta de transferencia

curl --location – request GET 'https://url_ach/v1/money-movement/transfers/{id}' \
--header 'x-movementType: xxxxxx \
--header 'Authorization: Bearer gfdfgfgfhfgfgsdsdsd'

Campos de salida consulta de transferencia

Campo Tipo Validación Descripción Obligatoriedad
data objeto N/A N/A SI
id cadena Min 1 Max 36 Identificador único de la transacción SI
status cadena N/A Estado de la transacción
 
SI
creationDateTime fecha Formato fecha Momento de la respuesta al participante SI
movementType lista Valores validos para el campo Identificador del schema del flujo transaccional.
 
SI
custom objeto objeto N/A COND. Si el "status:rejected o aborted" se envía el objeto con los campos
error objeto objeto N/A COND. Si el "status:rejected o aborted" se envía el objeto con los campos
code cadena Código de error del rechazo o fallo Min 1 - Max 255 COND. Si el "status:rejected o aborted" se envía el objeto con los campos
description cadena Descripción del rechazo o fallo Min 1 - Max 255 COND. Si el "status:rejected o aborted" se envía el objeto con los campos

Response consulta estado: completed

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "creationDateTime": "2026-08-21T10:15:30-05:00",
    "movementType": "P2P-TRANSFER"
  }
}

Response consulta estado: rejected - aborted

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "aborted",
    "creationDateTime": "2026-08-21T10:15:30-05:00",
    "movementType": "P2P-TRANSFER"
  }
},
  "custom": {
        "error": {
            "code": "307",
            "description": "bridge.account-not-found - Cuenta no encontrada"
        }
    },

Orderarticle 6
Errores del MOL Anterior