{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","description":"Servicio de validación de datos de personas naturales y empresas de Ecuador. Las consultas son realizadas en tiempo real en el instante en el que usted la solicita, obteniendo información completa y verificada. [www.webservices.ec](http://www.webservices.ec)\n\n## 🔐 Autenticación\n\nTodos los endpoints requieren un **Bearer Token** en el header `Authorization`.\n\n```\nAuthorization: Bearer TU_TOKEN_AQUI\n\n ```\n\nPuedes obtener tu token desde [webservices.ec](https://webservices.ec) → **API Tokens**.\n\n## ⚙️ Configuración\n\n1. Importa esta colección en Postman\n    \n2. Configura las variables:\n    \n    - `base_url`: `https://webservices.ec`\n        \n    - `token`: Tu token de API personal\n        \n\n## 💰 Precios por Consulta\n\n| Endpoint | Costo |\n| --- | --- |\n| Cédula | $0.05 |\n| RUC | $0.04 |\n| RUC Lite | $0.05 |\n| SENESCYT | $0.10 |\n| Bachiller | $0.10 |\n| Placas | $0.08 |\n| WhatsApp Check | $0.02 |\n| SRI Comprobantes | $0.004/doc |\n\n## 📋 Permisos por Endpoint\n\n| Endpoint | Permiso |\n| --- | --- |\n| `/api/cedula/{cedula}` | `api:cedula` |\n| `/api/ruc/{ruc}` | `api:ruc` |\n| `/api/ruclite/{ruc}` | `api:ruc_lite` |\n| `/api/senescyt/{cedula}` | `api:senescyt` |\n| `/api/bachiller/{cedula}` | `api:bachiller` |\n| `/api/placas/{placa}` | `api:placas` |\n| `/api/checkwhatsapp/{phone}` | `api:whatsapp_check_phone` |\n| `/api/sri/comprobantes` | `api:sri_comprobantes` |\n| `/api/tokens` | `api:create_tokens` |\n\n## ❌ Códigos de Error Comunes\n\n| Código | Error | Descripción |\n| --- | --- | --- |\n| 401 | Unauthenticated | Token inválido, expirado o no proporcionado |\n| 402 | Insufficient Balance | Saldo insuficiente. Recargue en webservices.ec |\n| 403 | Invalid ability provided | El token no tiene el permiso necesario para este endpoint |\n| 403 | Forbidden | Acceso denegado por restricción de IP o permisos |\n| 404 | Not Found | Identificación no encontrada en registros públicos |\n| 422 | Validation Error | Parámetros inválidos o formato incorrecto |\n| 429 | Query Limit Reached | El token alcanzó su límite de consultas |\n| 500 | Server Error | Error interno del servicio público consultado |\n\n### Ejemplo Error 401 - Token Inválido\n\n``` json\n{ \"message\": \"Unauthenticated.\" }\n\n ```\n\n### Ejemplo Error 402 - Saldo Insuficiente\n\n``` json\n{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n\n ```\n\n### Ejemplo Error 402 - Sin Saldo Global\n\n``` json\n{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n\n ```\n\n### Ejemplo Error 403 - Sin Permiso\n\n```\nHTTP 403 Forbidden - Invalid ability provided.\n\n ```\n\n### Ejemplo Error 429 - Límite de Consultas\n\n``` json\n{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n\n ```\n\n## 📞 Soporte\n\n[soporte@webservices.ec](https://mailto:soporte@webservices.ec)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"12557860","team":4368364,"collectionId":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","publishedId":"2sBXqGr2Jc","public":true,"publicUrl":"https://documenter-api.postman.tech/view/12557860/2sBXqGr2Jc","privateUrl":"https://go.postman.co/documentation/12557860-72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"871eff"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":"Servicio de validación de datos de personas naturales y empresas de Ecuador. Las consultas son realizadas en tiempo real en el instante en el que usted la solicita, obteniendo información completa y verificada."},{"name":"title","value":"WebServices API Documentación"}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":"https://content.pstmn.io/12b9ddd8-8274-4194-9d74-61dd4a1c6514/MTI4eDEyOC5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"871eff"}},{"name":"light","logo":"https://content.pstmn.io/9a203482-872f-465d-9925-8a6c6bddc23d/MTI4eDEyOC5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"871eff"}}]}},"version":"8.10.1","publishDate":"2026-04-26T00:32:40.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"WebServices API Documentación","description":"Servicio de validación de datos de personas naturales y empresas de Ecuador. Las consultas son realizadas en tiempo real en el instante en el que usted la solicita, obteniendo información completa y verificada."},"logos":{"logoLight":"https://content.pstmn.io/9a203482-872f-465d-9925-8a6c6bddc23d/MTI4eDEyOC5wbmc=","logoDark":"https://content.pstmn.io/12b9ddd8-8274-4194-9d74-61dd4a1c6514/MTI4eDEyOC5wbmc="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/92a7a1816cdd1da9a80aa7e91d0c124032e902ff5fa7342a3c4fbfe841c4f825","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sBXqGr2Jc"}