{ "info": { "name": "Consulta Única — API v3", "description": "Colección de la API pública de Consulta Única (v3).\n\n**Autenticación**: todas las peticiones envían el header `X-API-Key`. Define tu clave en la variable de colección `apiKey`.\n\n**Variables**: `baseUrl` (default `https://api.consultaunica.mx`) y `apiKey`.\n\n**Formato de los errores**: los servicios síncronos devuelven `{message}`, y agregan `errors` cuando falla la validación del payload. `sc_premium` y `user-stats` devuelven `{message, description, errorCode}`; en esos, programa contra `errorCode`, que es el campo estable.\n\nCada petición trae respuestas de ejemplo guardadas —éxito y errores— tomadas de la documentación pública: https://docs.consultaunica.mx", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.consultaunica.mx" }, { "key": "apiKey", "value": "", "type": "string" } ], "item": [ { "name": "Seguro Social", "item": [ { "name": "imss — nss (rápida, _v=3)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=3", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "3" } ] }, "description": "Consulta rápida de NSS. Devuelve los datos del titular junto con el NSS.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_fast.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — NSS localizado", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=3", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "3" } ] }, "description": "Consulta rápida de NSS. Devuelve los datos del titular junto con el NSS.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_fast.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"curp\": \"LOOA531113HTCPBN07\",\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"maternalName\": \"OBRADOR\",\n \"birthDate\": \"1953-11-13\",\n \"nss\": \"12345678901\",\n \"email\": \"amlo@gmail.com\",\n \"startDate\": \"2020-01-01\",\n \"endDate\": null,\n \"arco\": null\n}" }, { "name": "❌ 409 — CURP con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=3", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "3" } ] }, "description": "Consulta rápida de NSS. Devuelve los datos del titular junto con el NSS.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_fast.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.nss.curp\",\n \"error\": \"String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'\"\n }\n ]\n}" }, { "name": "❌ 409 — Correo con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=3", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "3" } ] }, "description": "Consulta rápida de NSS. Devuelve los datos del titular junto con el NSS.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_fast.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.userEmail\",\n \"error\": \"value is not a valid email address: An email address must have an @-sign.\"\n }\n ]\n}" }, { "name": "❌ 400 — Error del Seguro Social", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=3", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "3" } ] }, "description": "Consulta rápida de NSS. Devuelve los datos del titular junto con el NSS.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_fast.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"La CURP capturada no es válida o no cuenta con NSS\"\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=3", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "3" } ] }, "description": "Consulta rápida de NSS. Devuelve los datos del titular junto con el NSS.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_fast.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "imss — nss (profunda, _v=2)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Consulta profunda de NSS. Devuelve el NSS y los datos de RENAPO en `personInfo`.\n\nOtros mensajes del error 400: «El correo capturado ya se encuentra asociado a otra CURP», «La persona no cuenta con NSS», «Datos inconsistentes, debe acudir a una subdelegación del Seguro Social», «El servicio arrojó un error inesperado, favor de consultar nuevamente».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_regular.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — NSS localizado", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Consulta profunda de NSS. Devuelve el NSS y los datos de RENAPO en `personInfo`.\n\nOtros mensajes del error 400: «El correo capturado ya se encuentra asociado a otra CURP», «La persona no cuenta con NSS», «Datos inconsistentes, debe acudir a una subdelegación del Seguro Social», «El servicio arrojó un error inesperado, favor de consultar nuevamente».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_regular.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"nss\": \"12345678901\",\n \"personInfo\": {\n \"maternalName\": \"OBRADOR\",\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"sex\": \"H\",\n \"birthDate\": \"1953-11-13\"\n }\n}" }, { "name": "❌ 409 — CURP con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Consulta profunda de NSS. Devuelve el NSS y los datos de RENAPO en `personInfo`.\n\nOtros mensajes del error 400: «El correo capturado ya se encuentra asociado a otra CURP», «La persona no cuenta con NSS», «Datos inconsistentes, debe acudir a una subdelegación del Seguro Social», «El servicio arrojó un error inesperado, favor de consultar nuevamente».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_regular.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.nss.curp\",\n \"error\": \"String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'\"\n }\n ]\n}" }, { "name": "❌ 409 — Correo con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Consulta profunda de NSS. Devuelve el NSS y los datos de RENAPO en `personInfo`.\n\nOtros mensajes del error 400: «El correo capturado ya se encuentra asociado a otra CURP», «La persona no cuenta con NSS», «Datos inconsistentes, debe acudir a una subdelegación del Seguro Social», «El servicio arrojó un error inesperado, favor de consultar nuevamente».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_regular.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.userEmail\",\n \"error\": \"value is not a valid email address: An email address must have an @-sign.\"\n }\n ]\n}" }, { "name": "❌ 400 — Error del Seguro Social", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Consulta profunda de NSS. Devuelve el NSS y los datos de RENAPO en `personInfo`.\n\nOtros mensajes del error 400: «El correo capturado ya se encuentra asociado a otra CURP», «La persona no cuenta con NSS», «Datos inconsistentes, debe acudir a una subdelegación del Seguro Social», «El servicio arrojó un error inesperado, favor de consultar nuevamente».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_regular.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"La CURP capturada no es válida\"\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Consulta profunda de NSS. Devuelve el NSS y los datos de RENAPO en `personInfo`.\n\nOtros mensajes del error 400: «El correo capturado ya se encuentra asociado a otra CURP», «La persona no cuenta con NSS», «Datos inconsistentes, debe acudir a una subdelegación del Seguro Social», «El servicio arrojó un error inesperado, favor de consultar nuevamente».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/nss_regular.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"nss\",\n \"nss\": {\n \"curp\": \"LOOA531113HTCPBN07\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"sendNssToEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "imss — vd (vigencia al correo, _v=2)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Envía la constancia de vigencia de derechos al correo indicado.\n\n`allowEmailConcat` (default `true`) concatena el NSS al correo: `amlo+12345678901@gmail.com`.\n\nOtros mensajes del error 400: «El correo ya fue usado con otra CURP, escriba un correo diferente», «La vigencia de derechos solo puede consultarse 2 veces al día».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_email.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"allowEmailConcat\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Constancia enviada", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Envía la constancia de vigencia de derechos al correo indicado.\n\n`allowEmailConcat` (default `true`) concatena el NSS al correo: `amlo+12345678901@gmail.com`.\n\nOtros mensajes del error 400: «El correo ya fue usado con otra CURP, escriba un correo diferente», «La vigencia de derechos solo puede consultarse 2 veces al día».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_email.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"allowEmailConcat\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Reporte de vigencia de derechos enviado al correo ingresado\"\n}" }, { "name": "❌ 409 — CURP con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Envía la constancia de vigencia de derechos al correo indicado.\n\n`allowEmailConcat` (default `true`) concatena el NSS al correo: `amlo+12345678901@gmail.com`.\n\nOtros mensajes del error 400: «El correo ya fue usado con otra CURP, escriba un correo diferente», «La vigencia de derechos solo puede consultarse 2 veces al día».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_email.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"allowEmailConcat\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.vdSc.curp\",\n \"error\": \"String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'\"\n }\n ]\n}" }, { "name": "❌ 409 — NSS de más de 11 dígitos", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Envía la constancia de vigencia de derechos al correo indicado.\n\n`allowEmailConcat` (default `true`) concatena el NSS al correo: `amlo+12345678901@gmail.com`.\n\nOtros mensajes del error 400: «El correo ya fue usado con otra CURP, escriba un correo diferente», «La vigencia de derechos solo puede consultarse 2 veces al día».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_email.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"allowEmailConcat\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.vdSc.nss\",\n \"error\": \"String should have at most 11 characters\"\n }\n ]\n}" }, { "name": "❌ 409 — Correo con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Envía la constancia de vigencia de derechos al correo indicado.\n\n`allowEmailConcat` (default `true`) concatena el NSS al correo: `amlo+12345678901@gmail.com`.\n\nOtros mensajes del error 400: «El correo ya fue usado con otra CURP, escriba un correo diferente», «La vigencia de derechos solo puede consultarse 2 veces al día».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_email.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"allowEmailConcat\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.userEmail\",\n \"error\": \"value is not a valid email address: An email address must have an @-sign.\"\n }\n ]\n}" }, { "name": "❌ 400 — Datos reportados por el Seguro Social", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Envía la constancia de vigencia de derechos al correo indicado.\n\n`allowEmailConcat` (default `true`) concatena el NSS al correo: `amlo+12345678901@gmail.com`.\n\nOtros mensajes del error 400: «El correo ya fue usado con otra CURP, escriba un correo diferente», «La vigencia de derechos solo puede consultarse 2 veces al día».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_email.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"allowEmailConcat\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"El NSS no fue localizado en el Seguro Social\"\n}" }, { "name": "❌ 422 — Error de consulta con el Seguro Social", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Envía la constancia de vigencia de derechos al correo indicado.\n\n`allowEmailConcat` (default `true`) concatena el NSS al correo: `amlo+12345678901@gmail.com`.\n\nOtros mensajes del error 400: «El correo ya fue usado con otra CURP, escriba un correo diferente», «La vigencia de derechos solo puede consultarse 2 veces al día».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_email.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"allowEmailConcat\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"No se localizó información en RENAPO con la CURP capturada\"\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss?_v=2", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ], "query": [ { "key": "_v", "value": "2" } ] }, "description": "Envía la constancia de vigencia de derechos al correo indicado.\n\n`allowEmailConcat` (default `true`) concatena el NSS al correo: `amlo+12345678901@gmail.com`.\n\nOtros mensajes del error 400: «El correo ya fue usado con otra CURP, escriba un correo diferente», «La vigencia de derechos solo puede consultarse 2 veces al día».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_email.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n },\n \"userEmail\": \"amlo@gmail.com\",\n \"allowEmailConcat\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "imss — vd_validity", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Solo valida la vigencia de derechos: no envía documento ni correo.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_validity.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd_validity\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Vigencia validada", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Solo valida la vigencia de derechos: no envía documento ni correo.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_validity.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd_validity\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"vd_validity\",\n \"message\": \"La vigencia de derechos fue validada\",\n \"vdValidity\": {\n \"hasIncludedRight\": true,\n \"hasMedicalInsuranceRight\": true,\n \"validUntilDate\": null\n }\n}" }, { "name": "❌ 409 — CURP con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Solo valida la vigencia de derechos: no envía documento ni correo.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_validity.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd_validity\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.vdSc.curp\",\n \"error\": \"String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'\"\n }\n ]\n}" }, { "name": "❌ 409 — NSS de más de 11 dígitos", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Solo valida la vigencia de derechos: no envía documento ni correo.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_validity.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd_validity\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.vdSc.nss\",\n \"error\": \"String should have at most 11 characters\"\n }\n ]\n}" }, { "name": "❌ 400 — Datos reportados por el Seguro Social", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Solo valida la vigencia de derechos: no envía documento ni correo.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_validity.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd_validity\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"No se encontró un registro asociado a la CURP ni al NSS proporcionado\"\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Solo valida la vigencia de derechos: no envía documento ni correo.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/vd_validity.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"vd_validity\",\n \"vdSc\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "imss — no_dh_web", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Constancia de no derechohabiencia. `sendEmail` (default `true`) envía además un correo con formato de Consulta Única.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/no_dh.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"no_dh_web\",\n \"noDhWeb\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"userEmail\": \"amlo@gmail.com\",\n \"sendEmail\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Constancia generada", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Constancia de no derechohabiencia. `sendEmail` (default `true`) envía además un correo con formato de Consulta Única.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/no_dh.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"no_dh_web\",\n \"noDhWeb\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"userEmail\": \"amlo@gmail.com\",\n \"sendEmail\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"no_dh_web\",\n \"noDhWeb\": {\n \"message\": \"La constancia de no derechohabiencia se ha descargado y enviado al correo ingresado\",\n \"pdfUrl\": \"https://consultaunica.mx/static/pdf/imss/NODH_LOOA531113HTCPBN07_abc123.pdf\"\n }\n}" }, { "name": "❌ 409 — CURP con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Constancia de no derechohabiencia. `sendEmail` (default `true`) envía además un correo con formato de Consulta Única.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/no_dh.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"no_dh_web\",\n \"noDhWeb\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"userEmail\": \"amlo@gmail.com\",\n \"sendEmail\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.noDhWeb.curp\",\n \"error\": \"String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'\"\n }\n ]\n}" }, { "name": "❌ 409 — Correo con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Constancia de no derechohabiencia. `sendEmail` (default `true`) envía además un correo con formato de Consulta Única.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/no_dh.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"no_dh_web\",\n \"noDhWeb\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"userEmail\": \"amlo@gmail.com\",\n \"sendEmail\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.noDhWeb.userEmail\",\n \"error\": \"value is not a valid email address: An email address must have an @-sign.\"\n }\n ]\n}" }, { "name": "❌ 400 — Error del Seguro Social", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Constancia de no derechohabiencia. `sendEmail` (default `true`) envía además un correo con formato de Consulta Única.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/no_dh.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"no_dh_web\",\n \"noDhWeb\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"userEmail\": \"amlo@gmail.com\",\n \"sendEmail\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"La CURP ingresada sí cuenta con servicio médico en el Seguro Social\"\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Constancia de no derechohabiencia. `sendEmail` (default `true`) envía además un correo con formato de Consulta Única.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/no_dh.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"no_dh_web\",\n \"noDhWeb\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"userEmail\": \"amlo@gmail.com\",\n \"sendEmail\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "imss — reci", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Reporte personalizado de cotización (RECI).\n\nOtro mensaje del error 500: «El servicio de reporte de RECI no está disponible, favor de intentar más tarde».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/reci.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"reci\",\n \"reci\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\",\n \"userEmail\": \"amlo@gmail.com\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Reporte descargado", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Reporte personalizado de cotización (RECI).\n\nOtro mensaje del error 500: «El servicio de reporte de RECI no está disponible, favor de intentar más tarde».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/reci.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"reci\",\n \"reci\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\",\n \"userEmail\": \"amlo@gmail.com\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"reci\",\n \"reci\": {\n \"message\": \"Reporte RECI descargado\",\n \"pdfUrl\": \"https://consultaunica.mx/static/pdf/imss/RECI_LOOA531113HTCPBN07_abc123.pdf\"\n }\n}" }, { "name": "❌ 409 — CURP con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Reporte personalizado de cotización (RECI).\n\nOtro mensaje del error 500: «El servicio de reporte de RECI no está disponible, favor de intentar más tarde».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/reci.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"reci\",\n \"reci\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\",\n \"userEmail\": \"amlo@gmail.com\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.reci.curp\",\n \"error\": \"String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'\"\n }\n ]\n}" }, { "name": "❌ 409 — NSS de más de 11 dígitos", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Reporte personalizado de cotización (RECI).\n\nOtro mensaje del error 500: «El servicio de reporte de RECI no está disponible, favor de intentar más tarde».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/reci.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"reci\",\n \"reci\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\",\n \"userEmail\": \"amlo@gmail.com\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.reci.nss\",\n \"error\": \"String should have at most 11 characters\"\n }\n ]\n}" }, { "name": "❌ 409 — Correo con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Reporte personalizado de cotización (RECI).\n\nOtro mensaje del error 500: «El servicio de reporte de RECI no está disponible, favor de intentar más tarde».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/reci.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"reci\",\n \"reci\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\",\n \"userEmail\": \"amlo@gmail.com\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.reci.userEmail\",\n \"error\": \"value is not a valid email address: An email address must have an @-sign.\"\n }\n ]\n}" }, { "name": "❌ 400 — Datos reportados por el Seguro Social", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Reporte personalizado de cotización (RECI).\n\nOtro mensaje del error 500: «El servicio de reporte de RECI no está disponible, favor de intentar más tarde».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/reci.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"reci\",\n \"reci\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\",\n \"userEmail\": \"amlo@gmail.com\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"No se pudo suscribir al usuario para obtener el reporte\"\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/imss", "host": [ "{{baseUrl}}" ], "path": [ "v3", "imss" ] }, "description": "Reporte personalizado de cotización (RECI).\n\nOtro mensaje del error 500: «El servicio de reporte de RECI no está disponible, favor de intentar más tarde».\n\nDocumentación: https://docs.consultaunica.mx/services/imss/reci.html", "body": { "mode": "raw", "raw": "{\n \"type\": \"reci\",\n \"reci\": {\n \"curp\": \"LOOA531113HTCPBN07\",\n \"nss\": \"12345678901\",\n \"userEmail\": \"amlo@gmail.com\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "SC Premium", "item": [ { "name": "sc_premium", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\",\n \"webhookUrl\": \"https://tu-dominio.com/webhook/sc-premium\",\n \"parsePdf\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Solicitud recibida (modo webhook)", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\",\n \"webhookUrl\": \"https://tu-dominio.com/webhook/sc-premium\",\n \"parsePdf\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Remaining-Requests", "value": "97" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"message\": \"Solicitud recibida, pendiente de resultado\",\n \"curp\": \"AAAA800101HDFBBB01\",\n \"nss\": \"12345678901\",\n \"fullname\": \"Juan Pérez López\",\n \"redelivered\": false\n}" }, { "name": "✅ 200 — Solicitud recibida (modo polling-only)", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Remaining-Requests", "value": "97" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"message\": \"Solicitud recibida, pendiente de resultado\",\n \"curp\": \"AAAA800101HDFBBB01\",\n \"nss\": \"12345678901\",\n \"fullname\": \"Juan Pérez López\",\n \"redelivered\": false\n}" }, { "name": "❌ 400 — invalid_webhook_url", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\",\n \"webhookUrl\": \"https://tu-dominio.com/webhook/sc-premium\",\n \"parsePdf\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"webhookUrl debe ser https y apuntar a un host público accesible\",\n \"description\": \"La dirección web (URL) que configuraste para recibir el resultado no es válida.\",\n \"errorCode\": \"invalid_webhook_url\"\n}" }, { "name": "❌ 401 — unauthorized_user", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\",\n \"webhookUrl\": \"https://tu-dominio.com/webhook/sc-premium\",\n \"parsePdf\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Cuenta no válida, favor de verificar su clave de consulta\",\n \"description\": \"La clave no corresponde a una cuenta activa: puede ser incorrecta, o la cuenta está bloqueada, sin confirmar o desactivada.\",\n \"errorCode\": \"unauthorized_user\"\n}" }, { "name": "❌ 403 — api_key_requires_purchase", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\",\n \"webhookUrl\": \"https://tu-dominio.com/webhook/sc-premium\",\n \"parsePdf\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Tu clave de consulta requiere una compra activa para usar la API, adquiere un paquete en https://dash.consultaunica.mx/compras/nueva\",\n \"description\": \"Tu cuenta necesita al menos un paquete de consultas comprado para usar este servicio.\",\n \"errorCode\": \"api_key_requires_purchase\"\n}" }, { "name": "❌ 409 — bad_request (validación del payload)", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\",\n \"webhookUrl\": \"https://tu-dominio.com/webhook/sc-premium\",\n \"parsePdf\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.curp\",\n \"error\": \"String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'\"\n }\n ]\n}" }, { "name": "❌ 409 — concurrent_idempotent_request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\",\n \"webhookUrl\": \"https://tu-dominio.com/webhook/sc-premium\",\n \"parsePdf\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Ya se está procesando una consulta idéntica, espera un momento antes de reintentar\",\n \"description\": \"Enviaste dos peticiones idénticas casi al mismo tiempo; una ya se está procesando.\",\n \"errorCode\": \"concurrent_idempotent_request\"\n}" }, { "name": "❌ 500 — unknown", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sc_premium", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium" ] }, "description": "Envía la consulta y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/sc_premium/{uuid}`.\n\nConsume 3 créditos. Rate limit: 3 req / 2 s por `X-API-Key` (ráfaga de 3, ~90 req/min sostenido). Acepta el header opcional `Idempotency-Key` para no cobrar dos veces un reintento.\n\nDocumentación: https://docs.consultaunica.mx/services/imss/sc_premium.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"AAAA800101HDFBBB01\",\n \"webhookUrl\": \"https://tu-dominio.com/webhook/sc-premium\",\n \"parsePdf\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Ocurrió un error inesperado, favor de reintentar\",\n \"description\": \"Ocurrió un error inesperado al procesar tu consulta.\",\n \"errorCode\": \"unknown\"\n}" } ] }, { "name": "sc_premium/{uuid}", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/sc_premium/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium", ":uuid" ], "query": [ { "key": "parsePdf", "value": "true", "disabled": true } ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud. No consume créditos.\n\nA diferencia del webhook, aquí `parsePdf` se decide en cada lectura: puedes pedir el `documentData` aunque no lo hayas solicitado en el submit. Habilita el query param `parsePdf` para probarlo.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit." }, "response": [ { "name": "⏳ 200 — pending", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/sc_premium/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium", ":uuid" ], "query": [ { "key": "parsePdf", "value": "true", "disabled": true } ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud. No consume créditos.\n\nA diferencia del webhook, aquí `parsePdf` se decide en cada lectura: puedes pedir el `documentData` aunque no lo hayas solicitado en el submit. Habilita el query param `parsePdf` para probarlo.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"version\": 1,\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"status\": \"pending\",\n \"pdfBase64\": null,\n \"errorMessage\": null\n}" }, { "name": "✅ 200 — completed", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/sc_premium/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium", ":uuid" ], "query": [ { "key": "parsePdf", "value": "true", "disabled": true } ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud. No consume créditos.\n\nA diferencia del webhook, aquí `parsePdf` se decide en cada lectura: puedes pedir el `documentData` aunque no lo hayas solicitado en el submit. Habilita el query param `parsePdf` para probarlo.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"version\": 1,\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"status\": \"completed\",\n \"pdfBase64\": \"JVBERi0xLjQKJ...\",\n \"errorMessage\": null\n}" }, { "name": "❌ 200 — failed", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/sc_premium/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium", ":uuid" ], "query": [ { "key": "parsePdf", "value": "true", "disabled": true } ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud. No consume créditos.\n\nA diferencia del webhook, aquí `parsePdf` se decide en cada lectura: puedes pedir el `documentData` aunque no lo hayas solicitado en el submit. Habilita el query param `parsePdf` para probarlo.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"version\": 1,\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"status\": \"failed\",\n \"pdfBase64\": null,\n \"errorMessage\": \"La CURP ingresada no es válida, favor de verificar\"\n}" }, { "name": "✅ 200 — completed con parsePdf=true", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/sc_premium/:uuid?parsePdf=true", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium", ":uuid" ], "query": [ { "key": "parsePdf", "value": "true" } ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud. No consume créditos.\n\nA diferencia del webhook, aquí `parsePdf` se decide en cada lectura: puedes pedir el `documentData` aunque no lo hayas solicitado en el submit. Habilita el query param `parsePdf` para probarlo.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"version\": 1,\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"status\": \"completed\",\n \"pdfBase64\": \"JVBERi0xLjQKJ...\",\n \"errorMessage\": null,\n \"documentData\": {\n \"clientData\": {\n \"fullName\": \"JUAN MOCK PEREZ\",\n \"firstName\": \"JUAN\",\n \"paternalName\": \"MOCK\",\n \"maternalName\": \"PEREZ\",\n \"curp\": \"MOPJ800101HDFRRN09\",\n \"nss\": \"12345678901\"\n },\n \"weeksDetails\": {\n \"totalWeeks\": 726,\n \"contributedWeeks\": 762,\n \"discountedWeeks\": 36,\n \"reintegratedWeeks\": 0,\n \"summaryChips\": [\n {\n \"label\": \"Semanas Cotizadas\",\n \"value\": \"762\"\n },\n {\n \"label\": \"Semanas Descontadas\",\n \"value\": \"36\"\n }\n ]\n },\n \"records\": [\n {\n \"employerName\": \"AGROINDUSTRIAS MOCK S DE RL DE CV\",\n \"employerRegistry\": \"Y454322213\",\n \"employerEntity\": \"AGUASCALIENTES\",\n \"startDate\": \"2022-12-19\",\n \"endDate\": \"2023-04-03\",\n \"salary\": 277.1,\n \"movements\": [\n {\n \"movementType\": \"BAJA\",\n \"movementDate\": \"2023-04-03\",\n \"salary\": 277.1\n },\n {\n \"movementType\": \"MODIFICACION DE SALARIO\",\n \"movementDate\": \"2023-01-01\",\n \"salary\": 247.36\n },\n {\n \"movementType\": \"REINGRESO\",\n \"movementDate\": \"2022-12-19\",\n \"salary\": 246.38\n }\n ]\n }\n ],\n \"metadata\": {\n \"issuedDate\": \"2026-08-10\",\n \"originalChain\": \"|||Origen de Trámite:Internet (I)|Tipo Trámite:CONSTANCIA DE SEMANAS COTIZADAS|Fecha:10 de agosto 2026, 07:54:44|Apellido Paterno:MOCK|...||\",\n \"inquiryOrigin\": \"Internet (I)\",\n \"inquiryType\": \"CONSTANCIA DE SEMANAS COTIZADAS\",\n \"inquiryDate\": \"10 de agosto 2026, 07:54:44\",\n \"documentFolio\": \"10000000000000000000001\",\n \"digitalSign\": \"TW9ja0RpZ2l0YWxTaWduYXR1cmU...==\",\n \"notarialSequence\": \"00000000-0000-4000-8000-000000000001\",\n \"serialNumber\": \"00000000000000000001\"\n }\n }\n}" } ] }, { "name": "sc_premium/{uuid}/replay", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/v3/sc_premium/:uuid/replay", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium", ":uuid", "replay" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Reentrega al webhook el resultado de una solicitud ya resuelta. No consume créditos.\n\nNo acepta `parsePdf` propio: reentrega con la forma que pidió el submit. Si difiriera, el endpoint del cliente recibiría dos contratos distintos para el mismo `uuid`, que es justamente lo que el replay existe para evitar.\n\nCooldown de 60 s por `uuid`. Una solicitud en modo polling-only devuelve `422 replay_unavailable_polling_only`." }, "response": [ { "name": "✅ 202 — Reentrega programada", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/v3/sc_premium/:uuid/replay", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium", ":uuid", "replay" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Reentrega al webhook el resultado de una solicitud ya resuelta. No consume créditos.\n\nNo acepta `parsePdf` propio: reentrega con la forma que pidió el submit. Si difiriera, el endpoint del cliente recibiría dos contratos distintos para el mismo `uuid`, que es justamente lo que el replay existe para evitar.\n\nCooldown de 60 s por `uuid`. Una solicitud en modo polling-only devuelve `422 replay_unavailable_polling_only`." }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"scheduled\": true\n}" }, { "name": "❌ 429 — replay_cooldown_active", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/v3/sc_premium/:uuid/replay", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sc_premium", ":uuid", "replay" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Reentrega al webhook el resultado de una solicitud ya resuelta. No consume créditos.\n\nNo acepta `parsePdf` propio: reentrega con la forma que pidió el submit. Si difiriera, el endpoint del cliente recibiría dos contratos distintos para el mismo `uuid`, que es justamente lo que el replay existe para evitar.\n\nCooldown de 60 s por `uuid`. Una solicitud en modo polling-only devuelve `422 replay_unavailable_polling_only`." }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Retry-After", "value": "47" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Debes esperar antes de volver a solicitar la entrega de esta consulta\",\n \"description\": \"Ya solicitaste el reenvío de esta consulta hace menos de un minuto; espera un momento antes de pedir otro.\",\n \"errorCode\": \"replay_cooldown_active\"\n}" } ] } ], "description": "Reporte Premium de Semanas Cotizadas (asíncrono). Consume 3 créditos por submit. Omite `webhookUrl` para usar modo polling-only." } ], "description": "Consultas al Seguro Social. El campo `type` selecciona el tipo de consulta y determina qué sub-objeto debe enviarse. La consulta de NSS aparece dos veces porque el query param `_v` cambia su profundidad. El reporte Premium de Semanas Cotizadas vive en la subcarpeta **SC Premium** porque es asíncrono y tiene su propio endpoint." }, { "name": "AFORE", "item": [ { "name": "afore — encrypt", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/afore", "host": [ "{{baseUrl}}" ], "path": [ "v3", "afore" ] }, "description": "Detalles de Afore a partir de una CURP.\n\nOtros mensajes del error 422: «La CURP está duplicada, es necesario acercarte a tu Afore para corregir», «No se encontró una persona activa con los datos proporcionados», «La CURP es invalida para menores», «Existe una sesión abierta, favor de esperar 5 minutos para volver a intentar», «No se encontró un registro con estatus valido para la CURP proporcionada», «El servicio de RENAPO no está disponible, favor de volver a intentarlo más tarde», «El ahorrador tiene un trámite en proceso, favor de reintentarlo cuando culmine el trámite».\n\nDocumentación: https://docs.consultaunica.mx/services/afore/get_only_details.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"encrypt\",\n \"curp\": \"LOOA531113HTCPBN07\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Afore localizada", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/afore", "host": [ "{{baseUrl}}" ], "path": [ "v3", "afore" ] }, "description": "Detalles de Afore a partir de una CURP.\n\nOtros mensajes del error 422: «La CURP está duplicada, es necesario acercarte a tu Afore para corregir», «No se encontró una persona activa con los datos proporcionados», «La CURP es invalida para menores», «Existe una sesión abierta, favor de esperar 5 minutos para volver a intentar», «No se encontró un registro con estatus valido para la CURP proporcionada», «El servicio de RENAPO no está disponible, favor de volver a intentarlo más tarde», «El ahorrador tiene un trámite en proceso, favor de reintentarlo cuando culmine el trámite».\n\nDocumentación: https://docs.consultaunica.mx/services/afore/get_only_details.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"encrypt\",\n \"curp\": \"LOOA531113HTCPBN07\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"curp\": \"LOOA531113HTCPBN07\",\n \"afore\": \"AFORE SURA\",\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"maternalName\": \"OBRADOR\",\n \"sex\": \"H\",\n \"birthDate\": \"1953-11-13\",\n \"phoneNumber\": \"5512345678\",\n \"email\": \"amlo@gmail.com\",\n \"hasActiveApp\": true\n}" }, { "name": "❌ 422 — Error de Afore", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/afore", "host": [ "{{baseUrl}}" ], "path": [ "v3", "afore" ] }, "description": "Detalles de Afore a partir de una CURP.\n\nOtros mensajes del error 422: «La CURP está duplicada, es necesario acercarte a tu Afore para corregir», «No se encontró una persona activa con los datos proporcionados», «La CURP es invalida para menores», «Existe una sesión abierta, favor de esperar 5 minutos para volver a intentar», «No se encontró un registro con estatus valido para la CURP proporcionada», «El servicio de RENAPO no está disponible, favor de volver a intentarlo más tarde», «El ahorrador tiene un trámite en proceso, favor de reintentarlo cuando culmine el trámite».\n\nDocumentación: https://docs.consultaunica.mx/services/afore/get_only_details.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"encrypt\",\n \"curp\": \"LOOA531113HTCPBN07\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"No se encontró la CURP en RENAPO, favor de verificar\"\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/afore", "host": [ "{{baseUrl}}" ], "path": [ "v3", "afore" ] }, "description": "Detalles de Afore a partir de una CURP.\n\nOtros mensajes del error 422: «La CURP está duplicada, es necesario acercarte a tu Afore para corregir», «No se encontró una persona activa con los datos proporcionados», «La CURP es invalida para menores», «Existe una sesión abierta, favor de esperar 5 minutos para volver a intentar», «No se encontró un registro con estatus valido para la CURP proporcionada», «El servicio de RENAPO no está disponible, favor de volver a intentarlo más tarde», «El ahorrador tiene un trámite en proceso, favor de reintentarlo cuando culmine el trámite».\n\nDocumentación: https://docs.consultaunica.mx/services/afore/get_only_details.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"encrypt\",\n \"curp\": \"LOOA531113HTCPBN07\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"El servicio arrojó un error inesperado, favor de consultar nuevamente\"\n}" } ] } ] }, { "name": "Hacienda", "item": [ { "name": "sat — rfc_validation", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Verifica si un RFC es válido ante Hacienda. No devuelve documento ni datos personales.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_validation\",\n \"rfcValidation\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — RFC válido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Verifica si un RFC es válido ante Hacienda. No devuelve documento ni datos personales.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_validation\",\n \"rfcValidation\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"rfc_validation\",\n \"rfcValidation\": {\n \"rfc\": \"LOOA531113FI5\",\n \"isValid\": true\n }\n}" }, { "name": "❌ 400 — RFC no válido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Verifica si un RFC es válido ante Hacienda. No devuelve documento ni datos personales.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_validation\",\n \"rfcValidation\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"No se encontró un RFC válido\"\n}" }, { "name": "❌ 409 — RFC con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Verifica si un RFC es válido ante Hacienda. No devuelve documento ni datos personales.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_validation\",\n \"rfcValidation\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.rfcValidation.rfc\",\n \"error\": \"String should have at most 13 characters\"\n }\n ]\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Verifica si un RFC es válido ante Hacienda. No devuelve documento ni datos personales.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_validation\",\n \"rfcValidation\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "sat — rfc_search", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el RFC de una persona física a partir de su nombre completo y fecha de nacimiento.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_search\",\n \"rfcSearch\": {\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"maternalName\": \"OBRADOR\",\n \"birthDate\": \"1953-11-13\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — RFC encontrado y válido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el RFC de una persona física a partir de su nombre completo y fecha de nacimiento.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_search\",\n \"rfcSearch\": {\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"maternalName\": \"OBRADOR\",\n \"birthDate\": \"1953-11-13\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"rfc_search\",\n \"rfcSearch\": {\n \"rfc\": \"LOOA531113FI5\",\n \"isValid\": true\n }\n}" }, { "name": "❌ 400 — RFC no válido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el RFC de una persona física a partir de su nombre completo y fecha de nacimiento.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_search\",\n \"rfcSearch\": {\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"maternalName\": \"OBRADOR\",\n \"birthDate\": \"1953-11-13\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"No se encontró un RFC válido\"\n}" }, { "name": "❌ 409 — Fecha de nacimiento con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el RFC de una persona física a partir de su nombre completo y fecha de nacimiento.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_search\",\n \"rfcSearch\": {\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"maternalName\": \"OBRADOR\",\n \"birthDate\": \"1953-11-13\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.rfcSearch.birthDate\",\n \"error\": \"Input should be a valid date or datetime, day value is outside expected range\"\n }\n ]\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el RFC de una persona física a partir de su nombre completo y fecha de nacimiento.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/rfc_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"rfc_search\",\n \"rfcSearch\": {\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"maternalName\": \"OBRADOR\",\n \"birthDate\": \"1953-11-13\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "sat — tax_payer_search", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el nombre fiscal de una persona física o moral a partir de su RFC.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_search\",\n \"taxPayerSearch\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Persona física encontrada", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el nombre fiscal de una persona física o moral a partir de su RFC.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_search\",\n \"taxPayerSearch\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"tax_payer_search\",\n \"taxPayerSearch\": {\n \"entityType\": \"individual\",\n \"individual\": {\n \"name\": \"ANDRES MANUEL\",\n \"paternalName\": \"LOPEZ\",\n \"maternalName\": \"OBRADOR\"\n }\n }\n}" }, { "name": "✅ 200 — Persona moral encontrada", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el nombre fiscal de una persona física o moral a partir de su RFC.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_search\",\n \"taxPayerSearch\": {\n \"rfc\": \"COP920428Q20\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"tax_payer_search\",\n \"taxPayerSearch\": {\n \"entityType\": \"company\",\n \"company\": {\n \"name\": \"COPPEL\"\n }\n }\n}" }, { "name": "❌ 409 — RFC con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el nombre fiscal de una persona física o moral a partir de su RFC.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_search\",\n \"taxPayerSearch\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.taxPayerSearch.rfc\",\n \"error\": \"String should have at most 13 characters\"\n }\n ]\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Localiza el nombre fiscal de una persona física o moral a partir de su RFC.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_search.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_search\",\n \"taxPayerSearch\": {\n \"rfc\": \"LOOA531113FI5\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] }, { "name": "sat — tax_payer_validation", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Valida que el nombre del contribuyente, su RFC y su código postal coincidan con lo que tiene Hacienda.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_validation\",\n \"taxPayerValidation\": {\n \"rfc\": \"LOOA531113FI5\",\n \"taxPayer\": \"ANDRES MANUEL LOPEZ OBRADOR\",\n \"zipCode\": \"06066\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Contribuyente validado", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Valida que el nombre del contribuyente, su RFC y su código postal coincidan con lo que tiene Hacienda.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_validation\",\n \"taxPayerValidation\": {\n \"rfc\": \"LOOA531113FI5\",\n \"taxPayer\": \"ANDRES MANUEL LOPEZ OBRADOR\",\n \"zipCode\": \"06066\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"tax_payer_validation\",\n \"taxPayerValidation\": {\n \"rfc\": \"LOOA531113FI5\",\n \"taxPayer\": \"ANDRES MANUEL LOPEZ OBRADOR\",\n \"zipCode\": \"06066\",\n \"isValid\": false\n }\n}" }, { "name": "❌ 409 — RFC y código postal con formato inválido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Valida que el nombre del contribuyente, su RFC y su código postal coincidan con lo que tiene Hacienda.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_validation\",\n \"taxPayerValidation\": {\n \"rfc\": \"LOOA531113FI5\",\n \"taxPayer\": \"ANDRES MANUEL LOPEZ OBRADOR\",\n \"zipCode\": \"06066\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.taxPayerValidation.rfc\",\n \"error\": \"String should have at most 13 characters\"\n },\n {\n \"field\": \"body.taxPayerValidation.zipCode\",\n \"error\": \"String should have at most 5 characters\"\n }\n ]\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/sat", "host": [ "{{baseUrl}}" ], "path": [ "v3", "sat" ] }, "description": "Valida que el nombre del contribuyente, su RFC y su código postal coincidan con lo que tiene Hacienda.\n\nDocumentación: https://docs.consultaunica.mx/services/sat/tax_payer_validation.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"tax_payer_validation\",\n \"taxPayerValidation\": {\n \"rfc\": \"LOOA531113FI5\",\n \"taxPayer\": \"ANDRES MANUEL LOPEZ OBRADOR\",\n \"zipCode\": \"06066\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] } ] }, { "name": "Registro Civil", "description": "Actas del registro civil (nacimiento, matrimonio y defunción) por CURP. Servicio asíncrono con el mismo contrato que SC Premium: submit → webhook firmado → polling → replay.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "item": [ { "name": "actas", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"webhookUrl\": \"https://tu-dominio.com/webhook/actas\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Solicitud recibida (modo webhook)", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"webhookUrl\": \"https://tu-dominio.com/webhook/actas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Remaining-Requests", "value": "96" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Solicitud recibida, pendiente de resultado\",\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"redelivered\": false\n}" }, { "name": "✅ 200 — Solicitud recibida (modo polling-only)", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "X-Remaining-Requests", "value": "96" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Solicitud recibida, pendiente de resultado\",\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"redelivered\": false\n}" }, { "name": "❌ 403 — outside_business_hours", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"webhookUrl\": \"https://tu-dominio.com/webhook/actas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"El servicio de actas está disponible de 7:30 a 22:00 (hora del centro de México), favor de intentar dentro de ese horario\",\n \"description\": \"Las actas solo pueden solicitarse dentro del horario de atención del día; vuelve a intentarlo dentro de ese horario.\",\n \"errorCode\": \"outside_business_hours\"\n}" }, { "name": "❌ 503 — system_at_capacity", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"webhookUrl\": \"https://tu-dominio.com/webhook/actas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"El sistema se encuentra a máxima capacidad, favor de esperar unos minutos antes de reintentar\",\n \"description\": \"Hay mucha demanda en este momento y el servicio está saturado; reintenta en unos minutos.\",\n \"errorCode\": \"system_at_capacity\"\n}" }, { "name": "❌ 422 — duplicate_in_progress", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"webhookUrl\": \"https://tu-dominio.com/webhook/actas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Ya existe una consulta en curso para esta CURP y tipo de acta, espere a que termine antes de reintentar\",\n \"description\": \"Esta misma consulta ya está en proceso; espera a que termine antes de reintentar.\",\n \"errorCode\": \"duplicate_in_progress\"\n}" }, { "name": "❌ 422 — recent_query (sin re-entrega)", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"webhookUrl\": \"https://tu-dominio.com/webhook/actas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Ya cuentas con una consulta reciente para esta CURP y tipo de acta, espera unos minutos antes de reintentar\",\n \"description\": \"Ya hiciste esta misma consulta hace muy poco; espera un momento antes de repetirla para no pagarla dos veces.\",\n \"errorCode\": \"recent_query\"\n}" }, { "name": "❌ 400 — invalid_webhook_url", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"webhookUrl\": \"https://tu-dominio.com/webhook/actas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"webhookUrl debe ser https y apuntar a un host público accesible\",\n \"description\": \"La dirección web (URL) que configuraste para recibir el resultado no es válida.\",\n \"errorCode\": \"invalid_webhook_url\"\n}" }, { "name": "❌ 409 — bad_request (validación del payload)", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/actas", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas" ] }, "description": "Solicita un acta del registro civil por CURP y elige cómo recibir el resultado.\n\n- **Modo webhook**: incluye `webhookUrl` (HTTPS pública) y entregamos el PDF ahí, firmado con HMAC-SHA256.\n- **Modo polling-only**: omite `webhookUrl` y lee el resultado con `GET /v3/actas/{uuid}`.\n\n`actaType`: `nacimiento`, `matrimonio` o `defuncion`. `conFolio` pide la variante foliada (mismo costo).\n\nConsume 4 créditos, que se revierten si la solicitud termina en `failed`. Rate limit: 3 req / 2 s por `X-API-Key`. Acepta el header opcional `Idempotency-Key`.\n\n⚠️ Dos reglas propias de este servicio: solo se tramita de **07:30 a 22:00 hora del centro de México** (`403 outside_business_hours`) y hay un límite global de **5 solicitudes simultáneas** (`503 system_at_capacity`).\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html", "body": { "mode": "raw", "raw": "{\n \"curp\": \"CASE020722HTSRNDA8\",\n \"actaType\": \"nacimiento\",\n \"conFolio\": false,\n \"webhookUrl\": \"https://tu-dominio.com/webhook/actas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.actaType\",\n \"error\": \"Input should be 'nacimiento', 'matrimonio' or 'defuncion'\"\n }\n ]\n}" } ] }, { "name": "actas/{uuid}", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud de acta. No consume créditos.\n\nEs la única vía de obtener el resultado en modo polling-only, y la red de seguridad si el webhook no llegó.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "response": [ { "name": "⏳ 200 — pending", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud de acta. No consume créditos.\n\nEs la única vía de obtener el resultado en modo polling-only, y la red de seguridad si el webhook no llegó.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"version\": 1,\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"status\": \"pending\",\n \"pdfBase64\": null,\n \"errorMessage\": null\n}" }, { "name": "✅ 200 — completed", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud de acta. No consume créditos.\n\nEs la única vía de obtener el resultado en modo polling-only, y la red de seguridad si el webhook no llegó.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"version\": 1,\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"status\": \"completed\",\n \"pdfBase64\": \"JVBERi0xLjQKJeLjz9M...\",\n \"errorMessage\": null\n}" }, { "name": "❌ 200 — failed", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud de acta. No consume créditos.\n\nEs la única vía de obtener el resultado en modo polling-only, y la red de seguridad si el webhook no llegó.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"version\": 1,\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"status\": \"failed\",\n \"pdfBase64\": null,\n \"errorMessage\": \"No se localizó la CURP en RENAPO, revise que esté bien escrita\"\n}" }, { "name": "❌ 404 — request_not_found", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Estado actual de una solicitud de acta. No consume créditos.\n\nEs la única vía de obtener el resultado en modo polling-only, y la red de seguridad si el webhook no llegó.\n\nFrecuencia recomendada: máximo 1 request cada 5 s por `uuid`; empieza 30 s después del submit.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"No encontramos la consulta solicitada, favor de verificar el identificador\",\n \"description\": \"El identificador de la consulta no existe o no pertenece a tu cuenta; verifica que sea el que te devolvimos al enviarla.\",\n \"errorCode\": \"request_not_found\"\n}" } ] }, { "name": "actas/{uuid}/replay", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid/replay", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid", "replay" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Reentrega al `webhookUrl` del submit el resultado de una solicitud ya resuelta, firmado igual que la entrega original. No consume créditos.\n\nCooldown de 60 s por `uuid`. Sobre una solicitud polling-only devuelve `422 replay_unavailable_polling_only`.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "response": [ { "name": "✅ 202 — Reentrega programada", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid/replay", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid", "replay" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Reentrega al `webhookUrl` del submit el resultado de una solicitud ya resuelta, firmado igual que la entrega original. No consume créditos.\n\nCooldown de 60 s por `uuid`. Sobre una solicitud polling-only devuelve `422 replay_unavailable_polling_only`.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"uuid\": \"9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77\",\n \"scheduled\": true\n}" }, { "name": "❌ 429 — replay_cooldown_active", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid/replay", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid", "replay" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Reentrega al `webhookUrl` del submit el resultado de una solicitud ya resuelta, firmado igual que la entrega original. No consume créditos.\n\nCooldown de 60 s por `uuid`. Sobre una solicitud polling-only devuelve `422 replay_unavailable_polling_only`.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Retry-After", "value": "47" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Debes esperar antes de volver a solicitar la entrega de esta consulta\",\n \"description\": \"Ya solicitaste el reenvío de esta consulta hace menos de un minuto; espera un momento antes de pedir otro.\",\n \"errorCode\": \"replay_cooldown_active\"\n}" }, { "name": "❌ 422 — replay_unavailable_polling_only", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/v3/actas/:uuid/replay", "host": [ "{{baseUrl}}" ], "path": [ "v3", "actas", ":uuid", "replay" ], "variable": [ { "key": "uuid", "value": "9f2b7c1a-4d3e-4a5f-8b0c-2e1d0f9a8b77" } ] }, "description": "Reentrega al `webhookUrl` del submit el resultado de una solicitud ya resuelta, firmado igual que la entrega original. No consume créditos.\n\nCooldown de 60 s por `uuid`. Sobre una solicitud polling-only devuelve `422 replay_unavailable_polling_only`.\n\nDocumentación: https://docs.consultaunica.mx/services/registro-civil/actas.html" }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Esta consulta se envió sin webhookUrl, consulta su estado para obtener el resultado\",\n \"description\": \"Esta consulta se envió sin una dirección web para recibir el resultado, así que no hay a dónde reenviarlo; obtenlo consultando su estado.\",\n \"errorCode\": \"replay_unavailable_polling_only\"\n}" } ] } ] }, { "name": "Consumo", "item": [ { "name": "user-stats", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/user-stats", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user-stats" ] }, "description": "Saldo del cliente. No consume créditos. Rate limit: 10 req/s por `x-api-key`.\n\nPropaga los errores en vez de degradarlos a `remainingCredits: 0`: sin créditos recibes `200` con `remainingCredits: 0`; con una clave que ya no sirve recibes `401`.\n\nTras 10 respuestas `401` desde la misma IP en 15 minutos, las siguientes reciben `429` con `errorCode: too_many_invalid_keys` y header `Retry-After`.\n\nDocumentación: https://docs.consultaunica.mx/usage/" }, "response": [ { "name": "✅ 200 — Saldo disponible", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/user-stats", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user-stats" ] }, "description": "Saldo del cliente. No consume créditos. Rate limit: 10 req/s por `x-api-key`.\n\nPropaga los errores en vez de degradarlos a `remainingCredits: 0`: sin créditos recibes `200` con `remainingCredits: 0`; con una clave que ya no sirve recibes `401`.\n\nTras 10 respuestas `401` desde la misma IP en 15 minutos, las siguientes reciben `429` con `errorCode: too_many_invalid_keys` y header `Retry-After`.\n\nDocumentación: https://docs.consultaunica.mx/usage/" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"remainingCredits\": 42\n}" }, { "name": "✅ 200 — Saldo agotado", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/user-stats", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user-stats" ] }, "description": "Saldo del cliente. No consume créditos. Rate limit: 10 req/s por `x-api-key`.\n\nPropaga los errores en vez de degradarlos a `remainingCredits: 0`: sin créditos recibes `200` con `remainingCredits: 0`; con una clave que ya no sirve recibes `401`.\n\nTras 10 respuestas `401` desde la misma IP en 15 minutos, las siguientes reciben `429` con `errorCode: too_many_invalid_keys` y header `Retry-After`.\n\nDocumentación: https://docs.consultaunica.mx/usage/" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"remainingCredits\": 0\n}" }, { "name": "❌ 401 — unauthorized_user", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v3/user-stats", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user-stats" ] }, "description": "Saldo del cliente. No consume créditos. Rate limit: 10 req/s por `x-api-key`.\n\nPropaga los errores en vez de degradarlos a `remainingCredits: 0`: sin créditos recibes `200` con `remainingCredits: 0`; con una clave que ya no sirve recibes `401`.\n\nTras 10 respuestas `401` desde la misma IP en 15 minutos, las siguientes reciben `429` con `errorCode: too_many_invalid_keys` y header `Retry-After`.\n\nDocumentación: https://docs.consultaunica.mx/usage/" }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Cuenta no válida, favor de verificar su clave de consulta\",\n \"description\": \"La clave no corresponde a una cuenta activa: puede ser incorrecta, o la cuenta está bloqueada, sin confirmar o desactivada.\",\n \"errorCode\": \"unauthorized_user\"\n}" } ] } ], "description": "Saldo de la cuenta. No consume créditos. Documentado en la sección de Estadísticas del sitio." }, { "name": "Telefonía", "item": [ { "name": "phones — ifetel", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/phones", "host": [ "{{baseUrl}}" ], "path": [ "v3", "phones" ] }, "description": "Con un número de 10 dígitos devuelve el tipo de teléfono (fijo o móvil), la compañía telefónica, la lada y la ciudad de registro.\n\nDocumentación: https://docs.consultaunica.mx/services/ifetel.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"ifetel\",\n \"ifetel\": {\n \"phoneNumber\": \"5512345678\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "✅ 200 — Teléfono fijo", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/phones", "host": [ "{{baseUrl}}" ], "path": [ "v3", "phones" ] }, "description": "Con un número de 10 dígitos devuelve el tipo de teléfono (fijo o móvil), la compañía telefónica, la lada y la ciudad de registro.\n\nDocumentación: https://docs.consultaunica.mx/services/ifetel.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"ifetel\",\n \"ifetel\": {\n \"phoneNumber\": \"5512345678\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"ifetel\",\n \"ifetel\": {\n \"phoneType\": \"Fijo\",\n \"phoneCompany\": \"Telmez\",\n \"registrationCity\": null,\n \"lada\": null\n }\n}" }, { "name": "✅ 200 — Teléfono móvil", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/phones", "host": [ "{{baseUrl}}" ], "path": [ "v3", "phones" ] }, "description": "Con un número de 10 dígitos devuelve el tipo de teléfono (fijo o móvil), la compañía telefónica, la lada y la ciudad de registro.\n\nDocumentación: https://docs.consultaunica.mx/services/ifetel.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"ifetel\",\n \"ifetel\": {\n \"phoneNumber\": \"5512345678\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"variant\": \"ifetel\",\n \"ifetel\": {\n \"phoneType\": \"Móvil\",\n \"phoneCompany\": \"TELCEL\",\n \"registrationCity\": null,\n \"lada\": null\n }\n}" }, { "name": "❌ 409 — El teléfono no es de 10 dígitos", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/phones", "host": [ "{{baseUrl}}" ], "path": [ "v3", "phones" ] }, "description": "Con un número de 10 dígitos devuelve el tipo de teléfono (fijo o móvil), la compañía telefónica, la lada y la ciudad de registro.\n\nDocumentación: https://docs.consultaunica.mx/services/ifetel.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"ifetel\",\n \"ifetel\": {\n \"phoneNumber\": \"5512345678\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Datos inválidos, favor de verificar la información ingresada\",\n \"description\": \"Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.\",\n \"errorCode\": \"bad_request\",\n \"errors\": [\n {\n \"field\": \"body.ifetel.phoneNumber\",\n \"error\": \"String should have at least 10 characters\"\n }\n ]\n}" }, { "name": "❌ 422 — Error de la consulta de teléfono", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/phones", "host": [ "{{baseUrl}}" ], "path": [ "v3", "phones" ] }, "description": "Con un número de 10 dígitos devuelve el tipo de teléfono (fijo o móvil), la compañía telefónica, la lada y la ciudad de registro.\n\nDocumentación: https://docs.consultaunica.mx/services/ifetel.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"ifetel\",\n \"ifetel\": {\n \"phoneNumber\": \"5512345678\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"No se encontró un registro con los datos proporcionados\"\n}" }, { "name": "❌ 500 — Error desconocido", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/phones", "host": [ "{{baseUrl}}" ], "path": [ "v3", "phones" ] }, "description": "Con un número de 10 dígitos devuelve el tipo de teléfono (fijo o móvil), la compañía telefónica, la lada y la ciudad de registro.\n\nDocumentación: https://docs.consultaunica.mx/services/ifetel.html", "body": { "mode": "raw", "raw": "{\n \"variant\": \"ifetel\",\n \"ifetel\": {\n \"phoneNumber\": \"5512345678\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"message\": \"Algo falló durante la consulta, favor de consultar nuevamente\"\n}" } ] } ] } ] }