E-reports

Retrieves the e-reports filed for a declarant

Changed on

Required scope: e-reports:read </br>Organization authorization: supported</br>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.</br>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.</br>A rectificative (typeCode RE) restates its window in full rather than declaring a delta, so read only the highest revision per window.

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

Query parameters

ownerType'team' | 'operator' required

Whether a declarant is a team or an operator

ownerIdinteger required

Id of the declarant, as returned by /e-reports/declarants

Example:5938
periodFromstring date nullable

Filter to declaration windows starting on or after this date

Example:2026-08-01
periodTostring date nullable

Filter to declaration windows ending on or before this date

Example:2026-08-31
perPageinteger nullable

The maximum number of results to return

Example:20
beforeinteger 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.

Example:412
afterinteger 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.

Example:412

Response

E-reports successfully retrieved

Example response

{
  "data": [
    {
      "id": 412,
      "documentId": "FR12345678900011-20260801-20260810-IN-1",
      "revision": 1,
      "periodFrom": "2026-08-01T00:00:00Z",
      "periodTo": "2026-08-11T00:00:00Z",
      "errorDetails": "Declarant identifier is not registered with the tax authority",
      "submittedAt": "2026-08-11T08:40:03.058Z",
      "deliveredAt": "2026-08-11T17:33:37.314Z",
      "declarant": {
        "ownerId": 5938,
        "companyName": "Monta France SAS",
        "countryCode": "FR",
        "identifiers": [
          {
            "scheme": "FR:SIRENE",
            "id": "123456789"
          }
        ]
      },
      "b2cLines": [
        {
          "date": "2026-08-03",
          "currencyCode": "EUR",
          "transactionCount": 184,
          "netAmount": 41.32,
          "vatAmount": 8.68,
          "taxSubtotals": [
            {
              "vatPercentage": 20,
              "netAmount": 41.32,
              "vatAmount": 8.68,
              "transactionCount": 184
            }
          ]
        }
      ],
      "crossBorderInvoices": [
        {
          "invoiceNumber": "2170695-4",
          "issueDate": "2026-08-03",
          "currencyCode": "EUR",
          "buyerName": "EMBUILD",
          "buyerCountryCode": "BE",
          "buyerIdentifierScheme": "BE:VAT",
          "buyerIdentifierValue": "BE0406479092",
          "netAmount": 41.32,
          "taxSubtotals": [
            {
              "netAmount": 41.32
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "itemCount": 10,
    "perPage": 50,
    "after": "1290",
    "before": "1200"
  }
}

Changes