{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/fincore/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Reports","siteUrl":"https://docs.monato.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"reports","__idx":0},"children":["Reports"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how to receive notifications when a report file is ready and how to download it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Monato generates report files automatically on a daily and monthly basis. The flow has two steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monato generates the file → sends a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Report Webhook"]}," to notify you."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You receive the notification → call the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Download endpoint"]}," to get the file URL."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"end-to-end-flow","__idx":1},"children":["End-to-End Flow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n participant M as Monato\n participant Y as Your Server\n participant C as Your Client App\n\n M->>M: Generates report file
(daily or monthly)\n\n M->>Y: POST {your-webhook-url}
Report Webhook\n Note right of Y: {
\"file_type\": \"TRANSACTIONS\",
\"period\": \"DAILY\",
\"file_name\": \"transactions_daily_20260224.csv\",
\"created_at\": \"2026-02-24T10:30:15Z\"
}\n\n Y-->>M: HTTP 200 OK\n\n Y->>M: POST /v1/reports/clients/{client_id}/report/download\n Note right of M: {
\"report_type\": \"DAILY\",
\"operation_date\": \"2026-02-24\"
}\n\n M-->>Y: HTTP 200 OK\n Note right of Y: {
\"file_name\": \"transactions_daily_20260224.csv\",
\"download_url\": \"https://...\"
}\n\n Y->>C: Deliver file / notify availability\n","diagramHtml":"Your Client AppYour ServerMonatoYour Client AppYour ServerMonato{ \"file_type\": \"TRANSACTIONS\", \"period\": \"DAILY\", \"file_name\": \"transactions_daily_20260224.csv\", \"created_at\": \"2026-02-24T10:30:15Z\"}{ \"report_type\": \"DAILY\", \"operation_date\": \"2026-02-24\"}{ \"file_name\": \"transactions_daily_20260224.csv\", \"download_url\": \"https://...\"}Generates report file(daily or monthly)POST {your-webhook-url}Report WebhookHTTP 200 OKPOST /v1/reports/clients/{client_id}/report/downloadHTTP 200 OKDeliver file / notify availability","diagramHtmlDark":"Your Client AppYour ServerMonatoYour Client AppYour ServerMonato{ \"file_type\": \"TRANSACTIONS\", \"period\": \"DAILY\", \"file_name\": \"transactions_daily_20260224.csv\", \"created_at\": \"2026-02-24T10:30:15Z\"}{ \"report_type\": \"DAILY\", \"operation_date\": \"2026-02-24\"}{ \"file_name\": \"transactions_daily_20260224.csv\", \"download_url\": \"https://...\"}Generates report file(daily or monthly)POST {your-webhook-url}Report WebhookHTTP 200 OKPOST /v1/reports/clients/{client_id}/report/downloadHTTP 200 OKDeliver file / notify availability"},"children":["sequenceDiagram\n participant M as Monato\n participant Y as Your Server\n participant C as Your Client App\n\n M->>M: Generates report file
(daily or monthly)\n\n M->>Y: POST {your-webhook-url}
Report Webhook\n Note right of Y: {
\"file_type\": \"TRANSACTIONS\",
\"period\": \"DAILY\",
\"file_name\": \"transactions_daily_20260224.csv\",
\"created_at\": \"2026-02-24T10:30:15Z\"
}\n\n Y-->>M: HTTP 200 OK\n\n Y->>M: POST /v1/reports/clients/{client_id}/report/download\n Note right of M: {
\"report_type\": \"DAILY\",
\"operation_date\": \"2026-02-24\"
}\n\n M-->>Y: HTTP 200 OK\n Note right of Y: {
\"file_name\": \"transactions_daily_20260224.csv\",
\"download_url\": \"https://...\"
}\n\n Y->>C: Deliver file / notify availability\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"register-for-report-notifications","__idx":2},"children":["Register for Report Notifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before receiving the webhook, you must register the endpoint where Monato will send notifications."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v1/clients/{client_id}/webhooks\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Headers"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer \nContent-Type: application/json\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"client_id\": \"{{clientId}}\",\n \"url\": \"https://example.com/report-webhook\",\n \"token\": \"secretToken0123\",\n \"webhook_type\": \"REPORT\",\n \"auth_type\": \"AUTH\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}," — Status Code: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"id\": \"29806117-2b15-4682-87f0-350e6695fe91\",\n \"clientId\": \"c2d1d1e3-3340-4170-980e-e9269bbbc551\",\n \"url\": \"https://example.com/report-webhook\",\n \"token\": \"secretToken0123\",\n \"webhookType\": \"REPORT\",\n \"webhookStatus\": \"ACTIVE\",\n \"createdAt\": \"2026-02-24T10:30:15Z\",\n \"updatedAt\": \"2026-02-24T10:30:15Z\",\n \"deletedAt\": null,\n \"blockedAt\": null\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request body uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["snake_case"]}," (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_type"]},") while the response uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["camelCase"]}," (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookType"]},"). This is expected and consistent across the API."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"report-webhook","__idx":3},"children":["Report Webhook"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once registered, Monato sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," request to your endpoint every time a new report file is available for download. This can correspond to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transaction reports"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["account statements"]},", in daily or monthly periods."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payload","__idx":4},"children":["Payload"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"client_id\": \"9c6f6c8a-7c91-4b12-9a45-5cfdc78c22b1\",\n \"file_type\": \"TRANSACTIONS\",\n \"period\": \"DAILY\",\n \"file_name\": \"transactions_daily_20260224.csv\",\n \"created_at\": \"2026-02-24T10:30:15Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fields","__idx":5},"children":["Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier of the client."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Type of generated file. Values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TRANSACTIONS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCOUNT_STATEMENT"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["period"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Report period. Values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DAILY"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTHLY"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name of the generated file."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (ISO 8601)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date and time when the file was generated."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account identifier. Only present when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_type = ACCOUNT_STATEMENT"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example--transactions-report","__idx":6},"children":["Example — Transactions Report"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"client_id\": \"9c6f6c8a-7c91-4b12-9a45-5cfdc78c22b1\",\n \"file_type\": \"TRANSACTIONS\",\n \"period\": \"DAILY\",\n \"file_name\": \"transactions_daily_20260224.csv\",\n \"created_at\": \"2026-02-24T10:30:15Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example--account-statement","__idx":7},"children":["Example — Account Statement"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"client_id\": \"9c6f6c8a-7c91-4b12-9a45-5cfdc78c22b1\",\n \"file_type\": \"ACCOUNT_STATEMENT\",\n \"period\": \"MONTHLY\",\n \"file_name\": \"account_statement_1234567890_202602.csv\",\n \"created_at\": \"2026-03-01T02:10:00Z\",\n \"account_id\": \"1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]}," is only included in the payload when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_type = ACCOUNT_STATEMENT"]},". For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TRANSACTIONS"]}," files, this field is omitted."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"download-a-report","__idx":8},"children":["Download a Report"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this endpoint to retrieve the download URL for a report file. You can call it after receiving the webhook notification, or proactively to check if a file exists for a given date and type."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v1/reports/clients/{client_id}/report/download\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Headers"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer \nContent-Type: application/json\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Path Parameters"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier of the client (UUID)."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Body"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Type of report. See allowed values below."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation_date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]}," format."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clabe_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DAILY_ACCOUNT_STATEMENT"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTHLY_ACCOUNT_STATEMENT"]},". Must belong to the client."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"report_type-values","__idx":9},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report_type"]}," values"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DAILY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Daily transactions report."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTHLY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monthly transactions report."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DAILY_ACCOUNT_STATEMENT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Daily account statement."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTHLY_ACCOUNT_STATEMENT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monthly account statement."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"date-normalization","__idx":10},"children":["Date Normalization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTHLY"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTHLY_ACCOUNT_STATEMENT"]},", the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation_date"]}," is automatically normalized to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["last day of the month"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2025-08-25"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2025-08-31"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request--daily-account-statement","__idx":11},"children":["Example Request — Daily account statement"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"clabe_number\": \"123456789012345678\",\n \"report_type\": \"DAILY_ACCOUNT_STATEMENT\",\n \"operation_date\": \"2025-08-25\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request--daily-transactions-report","__idx":12},"children":["Example Request — Daily transactions report"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"report_type\": \"DAILY\",\n \"operation_date\": \"2025-08-25\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}," — Status Code: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"file_name\": \"daily_account_statement_123456789012345678_20260224.csv\",\n \"download_url\": \"https://...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If no matching file is found, both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_name"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["download_url"]}," are returned ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["empty"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"error-scenarios--400-bad-request","__idx":13},"children":["Error Scenarios — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Message"},"children":["Message"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cause"},"children":["Cause"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Invalid UUID format for client_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_id"]}," is not a valid UUID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Invalid report_type: "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report_type"]}," value is not one of the 4 allowed values."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clabe_number is required for account statement reports"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clabe_number"]}," missing for account statement types."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Invalid clabe number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clabe_number"]}," does not belong to the client."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation_date must use format YYYY-MM-DD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date format is incorrect."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation_date must be a valid date with format YYYY-MM-DD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Format is correct but the date itself is invalid."]}]}]}]}]}]},"headings":[{"value":"Reports","id":"reports","depth":1},{"value":"End-to-End Flow","id":"end-to-end-flow","depth":2},{"value":"Register for Report Notifications","id":"register-for-report-notifications","depth":2},{"value":"Report Webhook","id":"report-webhook","depth":2},{"value":"Payload","id":"payload","depth":3},{"value":"Fields","id":"fields","depth":3},{"value":"Example — Transactions Report","id":"example--transactions-report","depth":3},{"value":"Example — Account Statement","id":"example--account-statement","depth":3},{"value":"Download a Report","id":"download-a-report","depth":2},{"value":"report_type values","id":"report_type-values","depth":3},{"value":"Date Normalization","id":"date-normalization","depth":3},{"value":"Example Request — Daily account statement","id":"example-request--daily-account-statement","depth":3},{"value":"Example Request — Daily transactions report","id":"example-request--daily-transactions-report","depth":3},{"value":"Error Scenarios — 400 Bad Request","id":"error-scenarios--400-bad-request","depth":3}],"frontmatter":{"seo":{"title":"Reports"}},"lastModified":"2026-04-21T16:55:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/fincore/guides/reports","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}