Listar perfiles de registro

Buscar perfiles de registro existentes

Liste los perfiles de registro locales activos y no eliminados asociados a su cuenta de API. Utilice esta función para localizar el UUID de un perfil antes de abrirlo con get_document, no para determinar si se aprobaron sus documentos justificativos o el registro del número.

Solicitud de listado

Autentíquese con su cuenta de API de MultiTEL habilitada y su dirección IP permitida. Los ejemplos utilizan credenciales de HTTP Basic almacenadas en variables de entorno. Compruebe tanto la respuesta HTTP como el campo JSON status.code; una respuesta HTTP 200 por sí sola no indica que la operación haya tenido éxito. Todos los valores de los ejemplos son ficticios.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/documents

Este controlador no implementa un cuerpo de solicitud, paginación ni parámetros de filtrado. Devuelve los perfiles almacenados de la cuenta correspondiente; no dé por hecho ningún orden concreto. Evite consultar con frecuencia la lista completa en cuentas de gran tamaño.

Lista de respuesta

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": [
    {
      "id": "11111111111111111111111111111111",
      "first_name": "Example",
      "last_name": "Person",
      "phone_number": "12025550123",
      "id_number": "",
      "birth_date": null,
      "company_name": "",
      "company_reg_number": "",
      "vat_id": "",
      "personal_tax_id": "",
      "description": "Example profile",
      "identity_type": "Personal",
      "postal_code": "00000",
      "city": "Example City",
      "address": "1 Example Street",
      "signature": "BASE64_PNG_SIGNATURE_DATA",
      "date_created": "2026-10-23 16:00:00"
    }
  ]
}

Si no hay perfiles activos que coincidan, el controlador devuelve el código de API 200 y una lista de respuesta vacía. response[].id es el UUID del perfil local devuelto como uuid durante la creación; no es un ID de identidad ni un ID de dirección.

Campos del perfil devueltos

La proyección contiene id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature y date_created.

Los valores opcionales pueden estar vacíos o ser null, según los datos almacenados. Esta proyección heredada omite email, los selectores de país, identity_id, address_id, las referencias a archivos cargados, las listas de documentos justificativos y el estado de verificación. No es un endpoint para consultar el estado de los documentos justificativos ni la aprobación del registro. Trate los datos de identidad, contacto y firma devueltos como privados.

Próximos pasos

Guarde los ID de entidad de la respuesta original de create_document para realizar vinculaciones posteriores. Si se perdió esa respuesta, esta lista no permite recuperarlos. Revise el perfil en el portal o póngase en contacto con el servicio de asistencia en lugar de crear automáticamente un duplicado.