Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Este documento describe los items de tipo consulta pública aplicables a verificaciones KYB en México. Su valor no cambia una vez creados. Para cada item se incluye su descripción, opciones de creación y estructura de respuesta. Para documentos cargables (actas, constancias, poderes), consulta Items de documentos — KYB México.

​
Tabla resumen

ÍtemDescripción
sigerConsulta del SIGER (Sistema Integral de Gestión Registral) de México.
siger_shareholdersBúsqueda en SIGER de empresas relacionadas por accionistas.
public_sat_signaturesFirmas electrónicas (FIEL) y sellos digitales registrados ante el SAT.
curp_itemConsulta y validación de datos asociados al CURP.

​
siger — Sistema Integral de Gestión Registral

Consulta del SIGER (Sistema Integral de Gestión Registral) de México. Incluye análisis automático de minutas (FME) que intenta procesar todos los actos dentro de un límite de tiempo de 13 minutos, priorizando los más recientes.
El item SIGER se agrega automáticamente en el request a menos que se especifique lo contrario con {"skip_siger":true} en los verification options.

​
Filtros de búsqueda

Usa estos campos opcionales dentro de options para limitar la consulta en siger, los mismos se utilizarán como filtros dentro de la web:
  • state_code (string, opcional): código numérico de la entidad federativa. Acepta los valores 1–32 listados abajo.
  • state_name (string, opcional): nombre oficial de la entidad federativa. Debe coincidir con uno de los nombres listados.
  • fme (string, opcional): folio mercantil estatal para filtrar la búsqueda.
  • legal_name (string, opcional): razón social a buscar en SIGER.

​
Extracción de información

​
Flag siger_data_extraction

Este flag habilita la creación inteligente de items de tipo acta basados en el análisis de eventos extraídos de los actos registrados en SIGER. Comportamiento del flag:
  • Análisis FME (Feature Minute Extractor): El análisis de minutas mediante IA intenta procesar todos los actos independientemente del valor de este flag. El proceso tiene un límite de tiempo de 13 minutos; si se alcanza, se detiene y persiste los datos procesados hasta ese momento, priorizando los actos más recientes.
  • Creación de items acta: Cuando el flag está activado (siger_data_extraction: true), el sistema:
    • Analiza los eventos extraídos de cada acto (como cambios en la administración, accionistas, capital social, etc.)
    • Crea automáticamente items de tipo acta solo para aquellos actos que contienen eventos relevantes
    • Prioriza los actos más recientes (ordenados por fecha de registro)
    • Detiene la creación de items una vez que se han recopilado todos los eventos necesarios O si se alcanza el límite de tiempo
Eventos analizados: El sistema busca y analiza los siguientes grupos de eventos:
  1. Eventos de empresa (requiere todos):
    • Modificación de nombre o razón social (constitucion_modificacion_denominacion_social)
    • Modificación de tipo societario (constitucion_modificacion_tipo_sociedad)
    • Modificación de duración (constitucion_modificacion_duracion)
    • Modificación de domicilio social (constitucion_modificacion_domicilio)
    • Modificación de objeto social (constitucion_modificacion_objeto_social)
  2. Eventos de accionistas (requiere al menos uno):
    • Adición de accionistas (nombramiento_accionistas)
    • Compraventa o transferencia de acciones (compra_venta_cesion_traspaso_acciones_donacion)
    • Modificación de capital social (modificacion_capital)
  3. Eventos de administración (requiere al menos uno):
    • Adición de administradores (adicion_administracion)
    • Remoción de administradores (remocion_administracion)
    • Renovación o reelección (renovacion_reeleccion_administracion)
    • Cambio de tipo de órgano de administración (establecimiento_cambio_tipo_organo_administracion)
  4. Eventos de vigilancia (requiere al menos uno):
    • Adición de órgano de vigilancia (adicion_vigilancia)
    • Remoción (remocion_vigilancia)
    • Renovación o reelección (renovacion_reeleccion_vigilancia)
    • Cambio de tipo de órgano de vigilancia (establecimiento_cambio_tipo_organo_vigilancia)
  5. Eventos de firmantes (requiere al menos uno):
    • Adición de firmantes (nombramiento_apoderados)
    • Remoción de firmantes (remocion_apoderados)
    • Renovación de poderes (renovacion_apoderados)
    • Modificación de poderes (modificacion_apoderados)
Ejemplo de configuración: 
{
  "type": "siger",
  "options": {
    "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
    "siger_data_extraction": true
  }
}
El análisis FME intenta procesar todos los actos dentro de un límite de tiempo de 13 minutos, incluso si el flag está desactivado. Los actos se procesan en orden de fecha (más recientes primero), asegurando que los documentos más relevantes se analicen primero. Los resultados procesados se almacenan y permiten consultar la información extraída sin necesidad de reprocesar los documentos.
Límite de tiempo: El proceso tiene un máximo de 13 minutos por razones de seguridad y confiabilidad. Si hay muchos actos o el procesamiento es lento, algunos actos pueden no ser procesados. En estos casos, los actos más recientes siempre se priorizan.

​
Búsqueda de empresas relacionadas

El flag search_related_companies_siger habilita la búsqueda de empresas relacionadas a partir de los accionistas detectados para la empresa consultada en SIGER. Cuando el item SIGER se complete, el sistema creará un ítem de tipo siger_shareholders con las coincidencias. Comportamiento del flag:
  • Se puede activar en las opciones del item SIGER (search_related_companies_siger: true) o en las opciones de verificación
  • Cuando el item SIGER se completa, el sistema automáticamente:
    • Crea un nuevo item de tipo siger_shareholders
    • Identifica los accionistas de la empresa consultada en SIGER
    • Busca otras empresas en las que estos accionistas participan
    • Retorna información de las empresas relacionadas encontradas en el nuevo item
Para el filtro por entidad federativa (state_code y state_name) una de las opciones es suficiente; si envías ambas, se le dará prioridad a state_code. Envía solo los valores de la lista.

​
Ejemplo de payload

{
  "country": "mx",
  "items": [
    {
      "type": "siger",
      "options": {
        "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
        "fme": "9999",
        "state_code": "3"
      }
    }
  ],
  "metadata": {
    "reason": "Example of SIGER via API"
  },
  "tag": "siger-example-uuid"
}

​
Lista de entidades federativas válidas

state_codestate_name
1Aguascalientes
2Baja California
3Baja California Sur
4Campeche
5Coahuila de Zaragoza
6Colima
7Chiapas
8Chihuahua
9Ciudad de México
10Durango
11Guanajuato
12Guerrero
13Hidalgo
14Jalisco
15México
16Michoacán de Ocampo
17Morelos
18Nayarit
19Nuevo León
20Oaxaca
21Puebla
22Querétaro
23Quintana Roo
24San Luis Potosí
25Sinaloa
26Sonora
27Tabasco
28Tamaulipas
29Tlaxcala
30Veracruz de Ignacio de la Llave
31Yucatán
32Zacatecas

​
Estructura de respuesta

{
  "item_type": "siger",
  "item_value": {
    "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
    "documents": [
      {
        "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
        "fme_number": "FME-2024-001234",
        "fme_status": "Activo",
        "acts": [
          {
            "pre_coded_form": "Constitución de Sociedad Anónima",
            "act": "Acta constitutiva",
            "nci": "NCI-2024-001234",
            "admission_date": "2024-01-01",
            "registration_date": "2024-01-02",
            "document_number": "DOC-2024-001234",
            "mode": "Electrónico",
            "document_url": "https://siger.gob.mx/documentos/acta-constitutiva.pdf",
            "act_details": {
              "acta_city": "Ciudad de México",
              "acta_date": "2024-01-01",
              "acta_state": "Ciudad de México",
              "acta_number": "ACTA-2024-001",
              "notary_number": "123",
              "notary_name": "Lic. María González",
              "business_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
              "business_type": "Sociedad Anónima",
              "business_address": "Av. Reforma 123, Col. Juárez, CDMX",
              "business_address_state": "Ciudad de México",
              "business_address_city": "Cuauhtémoc",
              "business_duration": "99 años",
              "assembly_details": {
                "type": "Asamblea Constitutiva",
                "date": "2024-01-01",
                "general_type": "Ordinaria"
              },
              "assembly_agreement": "Constitución de sociedad anónima",
              "modifications": {}
            },
            "fme_assembly_minute_extractor": [
              {
                "event_group_name": "company_events",
                "explanation": "Se protocolizó la constitución de la sociedad.",
                "events": [
                  "constitucion_modificacion_denominacion_social",
                  "constitucion_modificacion_tipo_sociedad",
                  "constitucion_modificacion_duracion",
                  "constitucion_modificacion_domicilio",
                  "constitucion_modificacion_objeto_social"
                ]
              },
              {
                "event_group_name": "shareholders_events",
                "explanation": "Se estableció la estructura accionaria inicial.",
                "events": [
                  "nombramiento_accionistas",
                  "modificacion_capital"
                ]
              },
              {
                "event_group_name": "administration_events",
                "explanation": "Se designó el órgano de administración.",
                "events": [
                  "adicion_administracion",
                  "establecimiento_cambio_tipo_organo_administracion"
                ]
              }
            ]
          }
        ],
        "business_purpose": "Comercio y servicios",
        "business_type": "Sociedad Anónima",
        "business_duration": "99 años",
        "federal_entity": "Ciudad de México",
        "office": "Oficina Central",
        "tax_id_number": "ABC123456789",
        "registration_date": "2024-01-01",
        "city": "Cuauhtémoc",
        "nationality": "Mexicana",
        "address": "Av. Reforma 123, Col. Juárez, CDMX",
        "shareholders": [
          {
            "name": "Juan Pérez García",
            "shares": 1000,
            "total": 1000,
            "value": 1000000
          }
        ],
        "scrapedAt": "2024-01-01T00:00:00Z"
      }
    ]
  }
}

​
Análisis automático de minutas (FME)

El campo fme_assembly_minute_extractor contiene el análisis automático mediante IA de los eventos relevantes identificados en cada acto. Este análisis intenta procesar todos los actos independientemente de la configuración de flags, pero tiene un límite de tiempo de 13 minutos por razones de seguridad y confiabilidad. Los actos se procesan en orden cronológico inverso (más recientes primero), asegurando que los documentos más relevantes se analicen primero. Estructura del campo: Cada acto incluye un array de grupos de eventos con la siguiente información:
  • event_group_name: Nombre del grupo de eventos (company_events, shareholders_events, administration_events, supervision_events, signatories_holders_events)
  • explanation: Descripción generada por IA sobre los eventos encontrados en el acto
  • events: Array de eventos identificados en el acto
Grupos de eventos analizados:
  1. company_events: Eventos relacionados con la empresa (nombre, tipo societario, duración, domicilio, objeto social)
  2. shareholders_events: Eventos de accionistas (adiciones, transferencias, modificaciones de capital)
  3. administration_events: Eventos de administración (cambios en órganos de administración)
  4. supervision_events: Eventos de vigilancia (cambios en órganos de vigilancia)
  5. signatories_holders_events: Eventos de firmantes (adiciones, remociones, modificaciones de poderes)
El análisis FME se almacena en el ítem SIGER para los actos procesados y está disponible para consulta incluso si no se crearon items de tipo acta automáticamente.
Límite de tiempo: El proceso de análisis FME tiene un límite de 13 minutos. Si hay muchos actos, algunos pueden no ser procesados. El sistema prioriza los actos más recientes para asegurar que los documentos más relevantes se analicen primero. Si se alcanza el límite, los datos procesados hasta ese momento se persisten.

​
Creación automática de items de tipo acta

Cuando el flag siger_data_extraction está activado, el sistema analiza los eventos extraídos y crea automáticamente items de tipo acta para aquellos actos que contienen eventos relevantes. Estos items aparecerán como items adicionales en la verificación con:
  • item_type: Puede ser ac_mx (acta constitutiva), aa_mx (acta de asamblea), o fme_mx (folio mercantil)
  • file_source_info: Contiene información sobre el acto de SIGER del que proviene el item
    • item_type: “siger”
    • item_id: ID del item SIGER fuente
Los items de tipo acta creados automáticamente desde SIGER pasan por el mismo flujo de extracción que los items subidos manualmente, por lo que incluirán toda la información extraída del documento (firmantes, accionistas, poderes, etc.).

​
Error en la consulta SIGER

Cuando el ítem siger tiene "item_internal_status": "siger_error", es porque se presentó algún error relacionado al mal funcionamiento de la página o comportamientos inesperados.
Si el item_internal_status es "siger_error", la consulta no pudo completarse debido a problemas técnicos con el portal SIGER. En estos casos, el item_value puede estar vacío o incompleto.

​
siger_shareholders — Empresas relacionadas por accionistas

El ítem siger_shareholders contiene las coincidencias de empresas relacionadas para una lista de accionistas (personas físicas).
Límite: Solo 1 accionista por ítem siger_shareholders.
Puedes obtener este ítem de dos formas:
  • Automático (recomendado si buscas los mismos accionistas de SIGER): usa search_related_companies_siger: true en el ítem siger y no agregues siger_shareholders manualmente.
  • Manual (cuando no tienes item siger o cuando ya tienes una lista de accionistas): puedes crear directamente siger_shareholders en el POST /verifications pasando options.shareholders.
Ejemplo (manual) dentro del POST /verifications: 
{
  "type": "siger_shareholders",
  "options": {
    "shareholders": [
      {
        "name": "LUIS",
        "paternal_surname": "BUITRAGO",
        "maternal_surname": "LEON"
      }
    ]
  }
}
Requisitos:
  • El item SIGER debe tener resultados con información de accionistas
Casos de uso:
  • Análisis de beneficiarios finales (UBOs)
  • Identificación de estructuras corporativas relacionadas
  • Due diligence extendido
Ejemplo de configuración en opciones del item: 
{
  "type": "siger",
  "options": {
    "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
    "search_related_companies_siger": true
  }
}
Ejemplo de configuración en opciones de verificación: 
{
  "country": "mx",
  "items": [
    {
      "type": "siger",
      "options": {
        "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V."
      }
    }
  ],
  "options": {
    "search_related_companies_siger": true
  }
}
Si quieres buscar los mismos accionistas detectados por el item siger, usa search_related_companies_siger: true y no agregues siger_shareholders manualmente.

​
Estructura de respuesta

{
  "item_type": "siger_shareholders",
  "item_value": {
    "shareholders": [
      {
        "name": "LUIS",
        "paternal_surname": "BUITRAGO",
        "maternal_surname": "LEON"
      }
    ],
    "data": [
      {
        "shareholder": {
          "name": "LUIS",
          "paternal_surname": "BUITRAGO",
          "maternal_surname": "LEON"
        },
        "related_companies": [
          {
            "name": "4321 TREBOL, SOCIEDAD ANÓNIMA DE CAPITAL VARIABLE",
            "fme": "N-2024038395"
          }
        ]
      }
    ],
    "scraped_at": "2026-02-26T20:23:24Z"
  }
}
Campos principales:
  • shareholders: Lista de accionistas de la empresa consultada
    • name: Nombre del accionista
    • paternal_surname: Apellido paterno
    • maternal_surname: Apellido materno
  • data: Detalle de empresas relacionadas por cada accionista
    • shareholder: Información del accionista
    • related_companies: Array de empresas donde participa el accionista
      • name: Nombre de la empresa relacionada
      • fme: Folio mercantil electrónico de la empresa
Si no hay coincidencias para un accionista, related_companies puede venir como un arreglo vacío.
  • scraped_at: Fecha y hora en que se realizó la consulta
Este ítem es útil para análisis de beneficiarios finales (UBOs) y para identificar estructuras corporativas relacionadas en procesos de due diligence.

​
public_sat_signatures — Firmas y Sellos SAT

Consulta de firmas electrónicas (FIEL) y sellos digitales registrados ante el SAT (Servicio de Administración Tributaria) de México para empresas y representantes legales.

​
Opciones de creación

Requisito obligatorio: SIEMPRE se deben crear DOS items de tipo public_sat_signatures:
  1. Un item de tipo business
  2. Un item de tipo representatives
Ambos items son requeridos en todos los casos, independientemente de si la verificación es para una empresa o una persona.
Item de tipo business: Consulta los certificados y sellos del RFC principal (empresa o persona).
  • Si la verificación tiene un tax_id a nivel de verificación, este se usará automáticamente
  • Si NO hay tax_id a nivel de verificación, debe especificarse en tax_id_number dentro de las opciones del item
{
  "type": "public_sat_signatures",
  "options": {
    "type": "business",
    "tax_id_number": "ABC123456789"  // Requerido si no hay tax_id en la verificación
  }
}
Item de tipo representatives: Consulta automáticamente los certificados de los representantes legales asociados a la verificación. 
{
  "type": "public_sat_signatures",
  "options": {
    "type": "representatives"
  }
}
Ejemplo completo para una empresa: 
{
  "country": "mx",
  "tax_id": "ABC123456789",
  "items": [
    {
      "type": "public_sat_signatures",
      "options": {
        "type": "business"
      }
    },
    {
      "type": "public_sat_signatures",
      "options": {
        "type": "representatives"
      }
    }
  ]
}
Ejemplo completo para una persona (sin empresa): 
{
  "country": "mx",
  "items": [
    {
      "type": "public_sat_signatures",
      "options": {
        "type": "business",
        "tax_id_number": "PERJ800101ABC"  // RFC de la persona
      }
    },
    {
      "type": "public_sat_signatures",
      "options": {
        "type": "representatives"
      }
    }
  ]
}
Para verificaciones de personas (no empresas): Los datos del SAT quedarán iguales tanto en el item business como en el representatives, ya que ambos consultarán el mismo RFC de la persona.

​
Estructura de la respuesta

La respuesta del ítem contiene la siguiente estructura:
  • tax_ids: Array con los RFCs consultados.
  • data: Objeto donde cada clave es un RFC y contiene la información de certificados asociados.

​
Propiedades del objeto de datos por RFC

Cada entrada en data contiene:
  • status: Estado de la consulta ("success" o "fail").
  • legalName: Nombre legal de la empresa o persona.
  • taxIdNumber: RFC consultado.
  • businessType: Tipo de empresa (solo para empresas).
  • certificates: Array de certificados FIEL y sellos encontrados.
  • validationMessage: Mensaje descriptivo del resultado de la consulta.
  • screenshotUrl: URL de la captura de pantalla de la consulta en el portal del SAT.
  • scraped_at: Fecha y hora en que se realizó la consulta.
  • validatedAt: Fecha y hora de validación de los datos.

​
Respuesta cuando el RFC no arroja resultados

Este proceso responde en un ítem el sello y FIEL de la empresa y en otro ítem el del representante legal de la empresa. Cuando se ingresa un RFC que no arroja resultados en la consulta, se retorna lo siguiente dentro de la llave item_value.data.{tax_id}:
  • "status": "fail"
  • "validationMessage": "No succesfull response has been returned, please check RFC."
En estos casos:
  • El array certificates estará vacío.
  • El campo legalName estará vacío.
  • El campo taxIdNumber será null.
  • El campo businessType estará vacío.
  • Para items de tipo representantes, el item_internal_status será "sat_scrap_failed" y el item_value estará vacío.
Si el RFC no se encuentra en el sistema del SAT, verifica que el RFC sea correcto y esté registrado en el SAT.

​
Estructura de certificados

Cada certificado en el array certificates contiene:
  • tipo: Tipo de certificado ("FIEL" o "SELLO").
  • estado: Estado del certificado ("Activo", "Revocado" o "Caduco").
  • fechaInicial: Fecha de inicio de vigencia del certificado.
  • fechaFinal: Fecha de fin de vigencia del certificado.
  • numeroSerie: Número de serie del certificado.
  • serieLink: URL al certificado en el portal del SAT.
  • cerFile: Archivo del certificado en formato base64 (solo para certificados activos con datos completos).
  • data: Objeto con información detallada del certificado (solo para certificados activos):
    • type: Tipo de certificado.
    • status: Estado.
    • startDate y endDate: Fechas de vigencia.
    • serialNumber: Número de serie.
    • certificate: Objeto con información del emisor y sujeto del certificado.
  • legalRepresentativeRFC: RFC del representante legal asociado (solo para sellos de empresas).
  • personEmail: Email de la persona (solo para certificados FIEL de personas físicas).

​
Ejemplo de respuesta exitosa

Este ejemplo muestra una verificación que incluye consultas tanto para una empresa como para representantes legales: 
{
  "id": 12345, //business sat item
  "item_order": 0,
  "item_status": "complete",
  "item_type": "public_sat_signatures",
  "item_internal_status": "screenshot_taken",
  "item_value": {
    "tax_ids": ["ABC123456789"],
    "data": {
      "ABC123456789": {
        "status": "success",
        "bucketId": "business-verification-stack-verificationsbucket-example",
        "fileName": "mx/sat/screenshots/12345/ABC123456789/example-file.jpg",
        "legalName": "EMPRESA EJEMPLO SA DE CV",
        "scrapedAt": "2025-01-15T10:30:00.000Z",
        "taxIdNumber": "ABC123456789",
        "validatedAt": "2025-01-15T10:30:00.000Z",
        "businessType": "SOCIEDAD ANONIMA DE CAPITAL VARIABLE",
        "certificates": [
          {
            "data": {
              "type": "FIEL",
              "status": "Activo",
              "endDate": "2027-12-31T23:59:59.000Z",
              "startDate": "2023-01-01T00:00:00.000Z",
              "certificate": {
                "issuer": {
                  "C": "MX",
                  "L": "CUAUHTEMOC",
                  "O": "SERVICIO DE ADMINISTRACION TRIBUTARIA",
                  "CN": "AC DEL SERVICIO DE ADMINISTRACION TRIBUTARIA",
                  "OU": "SAT-IES Authority",
                  "ST": "CDMX",
                  "street": "Av. Hidalgo 77, Col. Guerrero",
                  "postalCode": "06300",
                  "emailAddress": "serviciosalcontribuyente@sat.gob.mx",
                  "unstructuredName": "responsable: ADMINISTRACION CENTRAL DE SERVICIOS TRIBUTARIOS AL CONTRIBUYENTE",
                  "x500UniqueIdentifier": "SAT970701NN3"
                },
                "subject": {
                  "O": "EMPRESA EJEMPLO SA DE CV",
                  "CN": "EMPRESA EJEMPLO SA DE CV",
                  "OU": "MATRIZ",
                  "name": "EMPRESA EJEMPLO SA DE CV",
                  "serialNumber": " / REP123456ABCD00",
                  "x500UniqueIdentifier": "ABC123456789 / REP123456EF1"
                }
              },
              "serialNumber": "3030303031303030303030373030333333303132"
            },
            "tipo": "SELLO",
            "estado": "Activo",
            "cerFile": "MIIF7DCCA9SgAwIBAgIUMDAwMDEwMDAwMDA3MDAzMzMwMTIwDQYJKoZIhvcNAQELBQAwggGV... [truncado]",
            "serieLink": "https://rdc.sat.gob.mx/rccf/000010/000007/00/33/30/00001000000700333012.cer",
            "fechaFinal": "2027-12-31T23:59:59.000Z",
            "numeroSerie": "00001000000700333012",
            "fechaInicial": "2023-01-01T00:00:00.000Z",
            "legalRepresentativeRFC": "REP123456EF1"
          },
          {
            "tipo": "FIEL",
            "estado": "Revocado",
            "serieLink": "https://rdc.sat.gob.mx/rccf/000010/000005/01/88/04/00001000000501880457.cer",
            "fechaFinal": "2023-02-28T18:09:20.000Z",
            "numeroSerie": "00001000000501880457",
            "fechaInicial": "2019-10-24T20:41:37.000Z"
          }
        ],
        "screenshotAt": "2025-01-15 10:30:15",
        "validationResult": null,
        "validationMessage": "Enterprise data has been successfully retrieved.",
        "screenshotUrl": "https://files.sandbox.gotrebol.com/mx/sat/screenshots/12345/ABC123456789/example-file.jpg?..."
      }
    }
  },
  "tag": null,
  "item_scope": "advanced",
  "tags": {}
},
{
    "id": 12346, //representatives sat item
    "item_order": 1,
    "item_status": "complete",
    "item_type": "public_sat_signatures",
    "item_internal_status": "screenshot_taken",
    "item_value": {
        "tax_ids": [
            "XYZ987654321"
        ],
        "data": {
            "XYZ987654321": {
                "status": "success",
                "bucketId": "business-verification-stack-verificationsbucket-example",
                "fileName": "mx/sat/screenshots/12346/XYZ987654321/example-file.jpg",
                "legalName": "JUAN PEREZ GARCIA",
                "scrapedAt": "2025-01-15T10:30:30.000Z",
                "taxIdNumber": "XYZ987654321",
                "validatedAt": "2025-01-15T10:30:30.000Z",
                "businessType": "",
                "certificates": [
                    {
                        "data": {
                            "type": "FIEL",
                            "status": "Activo",
                            "endDate": "2027-09-21T16:05:26.000Z",
                            "startDate": "2023-09-21T16:04:46.000Z",
                            "certificate": {
                                "issuer": {
                                    "C": "MX",
                                    "L": "CUAUHTEMOC",
                                    "O": "SERVICIO DE ADMINISTRACION TRIBUTARIA",
                                    "CN": "AC DEL SERVICIO DE ADMINISTRACION TRIBUTARIA",
                                    "OU": "SAT-IES Authority",
                                    "ST": "CDMX",
                                    "street": "Av. Hidalgo 77, Col. Guerrero",
                                    "postalCode": "06300",
                                    "emailAddress": "serviciosalcontribuyente@sat.gob.mx",
                                    "unstructuredName": "responsable: ADMINISTRACION CENTRAL DE SERVICIOS TRIBUTARIOS AL CONTRIBUYENTE",
                                    "x500UniqueIdentifier": "SAT970701NN3"
                                },
                                "subject": {
                                    "C": "MX",
                                    "O": "JUAN PEREZ GARCIA",
                                    "CN": "JUAN PEREZ GARCIA",
                                    "name": "JUAN PEREZ GARCIA",
                                    "emailAddress": "juan.perez@example.com",
                                    "serialNumber": "XYZ987654321",
                                    "x500UniqueIdentifier": "XYZ987654321"
                                }
                            },
                            "serialNumber": "3030303031303030303030373032343330373934"
                        },
                        "tipo": "FIEL",
                        "estado": "Activo",
                        "cerFile": "MIIGSzCCBDOgAwIBAgIUMDAwMDEwMDAwMDA3MDI0MzA3OTQwDQYJKoZIhvcNAQELBQAwggGV... [truncado]",
                        "serieLink": "https://rdc.sat.gob.mx/rccf/000010/000007/02/43/07/00001000000702430794.cer",
                        "fechaFinal": "2027-09-21T16:05:26.000Z",
                        "numeroSerie": "00001000000702430794",
                        "personEmail": "juan.perez@example.com",
                        "fechaInicial": "2023-09-21T16:04:46.000Z"
                    },
                    {
                        "tipo": "FIEL",
                        "estado": "Revocado",
                        "serieLink": "https://rdc.sat.gob.mx/rccf/000010/000005/01/85/63/00001000000501856356.cer",
                        "fechaFinal": "2023-09-21T16:04:46.000Z",
                        "numeroSerie": "00001000000501856356",
                        "fechaInicial": "2019-10-23T17:27:19.000Z"
                    },
                    {
                        "tipo": "FIEL",
                        "estado": "Caduco",
                        "serieLink": "https://rdc.sat.gob.mx/rccf/000010/000004/00/46/61/00001000000400466137.cer",
                        "fechaFinal": "2019-09-25T17:34:23.000Z",
                        "numeroSerie": "00001000000400466137",
                        "fechaInicial": "2015-09-25T17:33:43.000Z"
                    }
                ],
                "screenshotAt": "2025-01-15 10:30:45",
                "validationResult": null,
                "validationMessage": "Enterprise data has been successfully retrieved.",
                "screenshotUrl": "https://files.sandbox.gotrebol.com/mx/sat/screenshots/12346/XYZ987654321/example-file.jpg?..."
            }
        }
    },
    "tag": null,
    "item_scope": "advanced",
    "tags": {}
}

​
Ejemplo de respuesta con error

Cuando el RFC no se encuentra o la consulta falla, la respuesta incluye un estado "fail" y un mensaje descriptivo: 
{
  "id": 12346, //business sat item
  "item_order": 0,
  "item_status": "complete",
  "item_type": "public_sat_signatures",
  "item_internal_status": "screenshot_taken",
  "item_value": {
    "tax_ids": ["INVALID123456"],
    "data": {
      "INVALID123456": {
        "status": "fail",
        "bucketId": "business-verification-stack-verificationsbucket-example",
        "fileName": "mx/sat/screenshots/12346/INVALID123456/example-file.jpg",
        "legalName": "",
        "scrapedAt": "2025-01-15T10:35:00.000Z",
        "taxIdNumber": null,
        "validatedAt": "2025-01-15T10:35:00.000Z",
        "businessType": "",
        "certificates": [],
        "screenshotAt": "2025-01-15 10:35:15",
        "validationResult": null,
        "validationMessage": "No succesfull response has been returned, please check RFC.",
        "screenshotUrl": "https://files.sandbox.gotrebol.com/mx/sat/screenshots/12346/INVALID123456/example-file.jpg?..."
      }
    }
  },
  "tag": null,
  "item_scope": "advanced",
  "tags": {
    "uploaded-from": "api-creation"
  }
},
{
    "id": 12347, //Representatives sat item
    "item_order": 1,
    "item_status": "complete",
    "item_type": "public_sat_signatures",
    "item_internal_status": "sat_scrap_failed",
    "item_value": {},
    "tag": null,
    "item_scope": "advanced",
    "tags": {
        "uploaded-from": "api-creation"
    }
}
Importante: Si el RFC no se encuentra en el sistema del SAT, el campo status será "fail", el array certificates estará vacío, y el validationMessage indicará el motivo del fallo. En estos casos, el item sat de tipo representantes se completara con internal status "sat_scrap_failed". Verifica que el RFC sea correcto y esté registrado en el SAT.

​
curp_item — Consulta CURP

Consulta y validación de datos asociados al CURP (Clave Única de Registro de Población) en México.

​
Ejemplo de payload

{
  "country": "mx",
  "items": [
    {
      "type": "curp_item",
      "options": {
        "curp": "DAH**************6"
      }
    }
  ],
  "metadata": {
    "reason": "Curp item example."
  },
  "tag": "custom-identity-tag",
  "options": {
    "skip_siger": true
  }
}

​
Estructura de respuesta

{
  "item_type": "curp_item",
  "item_value": {
    "curp": "XXXX######XXXXXX##",
    "curp_validated_at": "2024-01-01T00:00:00Z",
    "curp_validation_data": {
      "curp": "PERE800101HDFXXX01",
      "curp_status": "alta_normal"|"baja_por_defuncion"|"otro"|"no_encontrado",
      "names": "Juan Carlos",
      "gender": "H",
      "act_number": "123456",
      "birth_date": "1980-01-01",
      "birth_entity": "Hidalgo",
      "nationality": "Mexicana",
      "first_surname": "Pérez",
      "second_surname": "García",
      "register_entity": "Hidalgo",
      "evidentiary_document": "Acta de nacimiento",
      "register_municipality": "Pachuca",
      "curp_file": "https://curp.gob.mx/curp/consultaCurp.jsp"
    },
    "curp_validation_result": "curp_found"|"curp_not_found",
    "curp_validation_status": "valid"|"invalid",
    "curp_validation_message": "curp_found"|"curp_not_found"
  }
}
Información detallada sobre el tipo curp_item:curp_validation_data - Datos extraídos de la consulta CURP:
  • curp_status: Estado del CURP en el registro:
    • alta_normal: Persona activa en el registro
    • baja_por_defuncion: Persona fallecida
    • otro: Otros estados
    • no_encontrado: CURP no encontrado
curp_validation_result - Resultado de la validación:
  • curp_found: CURP encontrado y válido
  • curp_not_found: CURP no encontrado
curp_validation_status - Estado de la validación:
  • valid: Validación exitosa
  • invalid: Validación fallida