v1

latestOpenAPI 3.0.0Apache 2.02026-07-267057121.5 KB

List e-reporting periods for a party

Returns the party's Flux 10 report periods, most recent first (created_at descending).

get/apps/gov-fr/v1/reports/{silo_entry_id}/periods

Path parameters

silo_entry_idstring required
Example:5b45453c-cdd0-11ed-afa1-0242ac120002

ID of the org.Party silo entry being onboarded.

Query parameters

kind'tx' | 'py'
Example:tx

Restrict the results to a single report kind:

  • tx - Transactions (invoice data).
  • py - Payments.

Omit to return both kinds.

offsetinteger

Number of periods to skip, for pagination. Must be non-negative.

limitinteger
Example:50

Maximum number of periods to return. Values outside the 1200 range fall back to the default of 50.

Response

One page of report periods.

next_offsetinteger

Offset to pass on the next call to fetch the following page. Omitted on the last page.

Example response

{
  "periods": [
    {
      "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"
    }
  ],
  "next_offset": 50
}