Skip to main content
GET
/
apps
/
gov-fr
/
v1
/
reports
/
{silo_entry_id}
Fetch the e-reporting summary for a party
curl --request GET \
  --url https://api.invopop.com/apps/gov-fr/v1/reports/{silo_entry_id} \
  --header 'Authorization: Bearer <token>'
{
  "silo_entry_id": "5b45453c-cdd0-11ed-afa1-0242ac120002",
  "siren": "123456789",
  "enabled": true,
  "regime": "real_normal_monthly",
  "kinds": [
    {
      "kind": "tx",
      "cadence": "ten_day",
      "open_period_start": "2026-07-01",
      "open_period_end": "2026-07-10",
      "next_due_period_start": "2026-06-21",
      "next_due_period_end": "2026-06-30",
      "next_due_deadline": "2026-07-10T23:59:59+02:00",
      "last_period_end": "2026-06-20",
      "last_filed_period": {
        "id": "018f9e2a-7c31-7a10-9b44-2f9d1e6c8a01",
        "siren": "123456789",
        "flux_kind": "tx",
        "role": "seller",
        "period_start": "2026-06-11",
        "period_end": "2026-06-20",
        "sequence": 1,
        "status": "filed",
        "flux_code": "PPF206_1025_000123",
        "ack_ref": "300",
        "submitted_at": "2026-06-21T08:15:00Z",
        "created_at": "2026-06-21T08:00:00Z",
        "updated_at": "2026-06-21T08:20:00Z"
      }
    },
    {
      "kind": "py",
      "cadence": "monthly",
      "open_period_start": "2026-07-01",
      "open_period_end": "2026-07-31",
      "next_due_period_start": "2026-06-01",
      "next_due_period_end": "2026-06-30",
      "next_due_deadline": "2026-07-10T23:59:59+02:00",
      "last_period_end": "",
      "last_filed_period": null
    }
  ]
}
Each kind reports two distinct windows. open_period_* is the window currently being accumulated against (what the party is filling right now); next_due_period_* is the window the platform will generate a report for next, together with its filing next_due_deadline. After a report is generated for the open window, next_due_* advances while open_* stays put until the calendar rolls over. Always returns 200. When the party exists but reporting was never enabled (or was disabled), enabled is false and kinds is empty — this lets callers tell “party not found” (404) apart from “party not reporting”.

Authorizations

​
Authorization
string
header
required

Authenticate using a valid Invopop enrollment token in the Bearer scheme.

Example: Authorization: Bearer <token>

Path Parameters

​
silo_entry_id
string
required

ID of the org.Party silo entry being onboarded.

Example:

"5b45453c-cdd0-11ed-afa1-0242ac120002"

Response

Reporting summary for the party.

A party's Flux 10 e-reporting status across all report kinds.

​
silo_entry_id
string
required

Silo entry (party) the summary is for.

Example:

"5b45453c-cdd0-11ed-afa1-0242ac120002"

​
siren
string
required

9-digit French SIREN of the party.

Example:

"123456789"

​
enabled
boolean
required

Whether e-reporting is currently enabled for the party.

Example:

true

​
kinds
object[]
required

Per-kind status blocks. Empty when reporting is not enabled.

​
regime
enum<string>

VAT regime driving the reporting cadences. Omitted when reporting is not enabled.

  • real_normal_monthly - Réel normal mensuel.
  • real_normal_quarterly - Réel normal trimestriel.
  • simplified - Réel simplifié.
  • vat_franchise - Franchise en base.
Available options:
real_normal_monthly,
real_normal_quarterly,
simplified,
vat_franchise
Example:

"real_normal_monthly"