{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"c94b80db-98a6-4a5c-ab3a-4f46de26b72d","name":"Monibyte API","description":"Bienvenido a las APIs públicas de Monibyte. Este conjunto de APIs permite que\nlas aplicaciones y sistemas de un cliente —sistemas contables, ERPs o\nherramientas internas— consuman de forma segura la información que Monibyte\nadministra, para automatizar procesos que hoy se realizan de forma manual.\n\nLa primera API disponible expone la **exportación de transacciones\nconfirmadas**: permite descargar, con múltiples filtros, un archivo (CSV/XLSX)\nlisto para conciliar o importar en el sistema contable del cliente.\n\nTodas las APIs se consumen sobre HTTPS, se autentican con un **API Key** y están\npensadas para integrarse desde cualquier lenguaje o plataforma.\n\n## Ambientes\n\nEl API cuenta con dos ambientes:\n\n- **Sandbox:** `https://sandbox.monibyte.com`\n- **Producción:** `https://api.monibyte.com`\n\nDurante el desarrollo de la integración se recomienda usar el **Sandbox**, para\nprobar sin afectar datos de producción. Una vez que la integración esté lista y\nprobada, cambiar a **Producción**.\n\n## Prerrequisitos\n\nAntes de consumir el API es necesario generar un **API Key** desde la consola de\nMonibyte. Al crearlo se definen también las **IPs permitidas** y los **permisos**\nde acceso.\n\n> El módulo de API Keys puede requerir la activación del paquete correspondiente.\n> Si no aparece en la consola, ponerse en contacto con su asesor de ventas o con\n> el equipo de Monibyte para solicitar su habilitación.\n\n### Generar un API Key\n\n1. En la consola de Monibyte, seleccionar **Integraciones**.\n2. Abrir la pestaña **Configuración de API Key**.\n3. En la parte inferior derecha, presionar **Crear API Key**.\n4. Ingresar el **nombre** del API Key.\n5. Definir la **expiración**: sin expiración, o con una **fecha de expiración**.\n6. Agregar las **IPs permitidas** con el botón correspondiente (se pueden agregar\n   varias). Solo esas IPs podrán consumir el API.\n7. Seleccionar los **permisos** requeridos para este API: **Transacciones\n   generales** y **Exportar reporte de transacciones**.\n8. Presionar **Siguiente**. El sistema envía un **código OTP** al correo.\n9. Copiar el OTP recibido y presionar **Verificar token**.\n10. En el último paso se muestra el **token** (el API Key). Copiarlo y guardarlo\n    en un lugar seguro: **se muestra una sola vez**.\n11. Una vez guardado, presionar **Ya guardé el token**.\n\nEse token es el que se envía en el header `x-api-key` (ver Autenticación).\n\n## Autenticación\n\nEl API se autentica con un **API Key** enviado en el header `x-api-key`. El API\nKey es el token que se genera desde la consola de Monibyte (ver Prerrequisitos).\n\nEjemplo del header:\n\n```\nx-api-key: <API Key>\n```\n\n## Manejo de errores\n\nAnte un error, el servicio responde con un código HTTP y un mensaje. Los\nprincipales:\n\n| HTTP | Mensaje | Causa | Cómo resolverlo |\n| --- | --- | --- | --- |\n| 400 | `startDate/endDate must be in format YYYY-MM-DD` | Formato de fecha inválido | Enviar las fechas en formato `YYYY-MM-DD`. |\n| 400 | `DATE_RANGE_EXCEEDS_MAX_PERIOD (max: 1 year)` | El rango supera 1 año | Reducir el rango a máximo 1 año. |\n| 404 | `NOT_FOUND_REPORT_ID` | El `templateId` no existe | Verificar el identificador de la plantilla. |\n| 401 / 403 | (auth) | API Key ausente o inválida | Enviar un `x-api-key` válido. |\n| 403 | (IP no autorizada) | La IP no está en la lista blanca | Registrar la IP en la lista blanca. |\n| 429 | (límite excedido) | Se superó el límite de peticiones | Reintentar más tarde o revisar la velocity. |\n\n> ⚠️ Pendiente de confirmar el **status y cuerpo exactos** que devuelve el\n> Gateway para: API Key inválida, IP no autorizada y límite de peticiones.\n\n## Disponibilidad por país\n\nEl API está disponible actualmente en los siguientes países:\n\n| País | Disponible |\n| --- | :---: |\n| Costa Rica | ✓ |\n| México | ✓ |\n| Guatemala | ✓ |\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"17879691","team":134944,"collectionId":"c94b80db-98a6-4a5c-ab3a-4f46de26b72d","publishedId":"2sBYB1P8SW","public":true,"publicUrl":"https://developer.monibyte.com","privateUrl":"https://go.postman.co/documentation/17879691-c94b80db-98a6-4a5c-ab3a-4f46de26b72d","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/926ff879-cbaa-461a-a969-ea345216cbad/bG9nby1hcHAucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/926ff879-cbaa-461a-a969-ea345216cbad/bG9nby1hcHAucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.12","publishDate":"2026-09-24T17:26:37.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/926ff879-cbaa-461a-a969-ea345216cbad/bG9nby1hcHAucG5n","logoDark":"https://content.pstmn.io/926ff879-cbaa-461a-a969-ea345216cbad/bG9nby1hcHAucG5n"}},"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/8ab36c2b55569a91137be74ff9af2b0029350cdbfdc63f2fd202d42f228d707b","favicon":"https://monibyte.com/favicon.ico"},"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://developer.monibyte.com/view/metadata/2sBYB1P8SW"}