--- title: "Retrieves the e-reports filed for a declarant" method: GET path: "/api/v1/e-reports" tags: ["E-reports"] --- # Retrieves the e-reports filed for a declarant `GET /api/v1/e-reports` ## Request - Base URL: `https://partner-api.monta.com` - URL: `https://partner-api.monta.com/api/v1/e-reports` - Auth: HTTP bearer Required scope: `e-reports:read`
Organization authorization: `supported`
Results are ordered newest first and paginated by cursor. Follow `meta.after` for the next page and stop when it comes back null. `meta.itemCount` counts the rows on the page you were given, not the total across pages.
`periodFrom`/`periodTo` match whole declaration windows: a report is returned only when its entire window falls inside the range. A window running 2026-08-01 to 2026-08-10 is not returned for `periodFrom=2026-08-05`, so pass calendar-month or wider bounds.
A rectificative (`typeCode` `RE`) restates its window in full rather than declaring a delta, so read only the highest `revision` per window. ## Query parameters - `ownerType` 'team' | 'operator', required: Whether a declarant is a team or an operator - `ownerId` integer, required: Id of the declarant, as returned by `/e-reports/declarants` - `periodFrom` string, date, nullable: Filter to declaration windows starting on or after this date - `periodTo` string, date, nullable: Filter to declaration windows ending on or before this date - `perPage` integer, nullable: The maximum number of results to return - `before` integer, nullable: Cursor (e-report id) to retrieve results ordered before a certain e-report. Use this with a cursor from `meta.before` to retrieve the previous page of results. - `after` integer, nullable: Cursor (e-report id) to retrieve results ordered after a certain e-report. Use this with a cursor from `meta.after` to retrieve the next page of results. ## Response `200` E-reports successfully retrieved - CursorBasedResponse5 - `data` EReport[], required - `id` integer, required: Monta's id for the e-report - `documentId` string, nullable: The id DGFiP assigned to the declaration. Null until the declaration is accepted. - `typeCode` 'IN' | 'RE', required: `IN` for an initial declaration, `RE` for a rectificative that restates it in full - `revision` integer, required: Revision of the declaration for this window. A rectificative restates the whole window, so only the highest revision is current. - `periodFrom` string, date-time, required: Start of the declaration window, inclusive - `periodTo` string, date-time, required: End of the declaration window, exclusive - `status` 'PENDING' | 'DRAFT' | 'PROCESSING' | 'DELIVERED' | 'FAILED' - `errorDetails` string, nullable: Why the transmission failed, present when `status` is `FAILED` - `submittedAt` string, date-time, nullable: When the declaration was transmitted - `deliveredAt` string, date-time, nullable: When DGFiP acknowledged the declaration - `declarant` EReportDeclarant - `ownerType` 'team' | 'operator', required: Whether a declarant is a team or an operator - `ownerId` integer, required: Id of the declarant - `companyName` string, required: Registered company name of the declarant - `countryCode` string, required: Country the declarant is registered in - `identifiers` EReportIdentifier[], required: Registration identifiers held for the declarant - `scheme` string, required: Identifier scheme - `id` string, required: Identifier value - `b2cLines` EReportB2cLine[], required: Domestic B2C sales, aggregated per day, category and rate - `date` string, date, required: Day the sales were made - `category` 'GOODS' | 'SERVICES', required: Whether a domestic B2C line declares goods or services - `currencyCode` string, required: Currency of the amounts on this line - `transactionCount` integer, required: How many transactions the line aggregates - `netAmount` number, required: Net amount, in major units - `vatAmount` number, required: VAT amount, in major units - `taxSubtotals` EReportB2cTaxSubtotal[], required: The line split by VAT rate - `vatPercentage` number, required: VAT rate applied, as a percentage - `netAmount` number, required: Net amount at this rate, in major units - `vatAmount` number, required: VAT amount at this rate, in major units - `transactionCount` integer, required: How many transactions fell at this rate - `crossBorderInvoices` EReportCrossBorderInvoice[], required: Cross-border sales, declared one invoice at a time - `invoiceNumber` string, required: Invoice number as issued - `issueDate` string, date, required: Date the invoice was issued - `currencyCode` string, required: Currency of the amounts on this invoice - `buyerName` string, required: Registered name of the buyer - `buyerCountryCode` string, required: Country the buyer is registered in - `buyerIdentifierScheme` string, required: Identifier scheme the buyer was identified by - `buyerIdentifierValue` string, required: Identifier value the buyer was identified by - `netAmount` number, required: Net amount, in major units - `vatAmount` number, required: VAT amount, in major units - `taxSubtotals` EReportCrossBorderTaxSubtotal[], required: The invoice split by tax category and rate - `taxCategory` 'STANDARD' | 'EXPORT' | 'EXEMPT' | 'REVERSE_CHARGE' | 'ZERO_RATED', required - `vatPercentage` number, required: VAT rate applied, as a percentage - `netAmount` number, required: Net amount at this rate, in major units - `vatAmount` number, required: VAT amount at this rate, in major units - `meta` CursorBasedPageMeta, required - `itemCount` integer, nullable: The number of items in the result - `perPage` integer: The requested maximum number of items returned - `after` string, nullable: A cursor to retrieve the next page of items in a new request - `before` string, nullable: A cursor to retrieve the previous page of items in a new request ## Other responses - `400`: The request is invalid - `401`: Consumer with provided credentials was not found - `403`: Consumer does not have access to the specified declarant - `404`: Entity with the provided id was not found ## Changes - **2026-11-03** `0ca400461c52`: 1 info - endpoint added [Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/e-reports/get.md) --- [API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)