Skip to main content
GET
/
apps
/
gov-fr
/
v1
/
reports
/
{silo_entry_id}
/
periods
List e-reporting periods for a party
curl --request GET \
  --url https://api.invopop.com/apps/gov-fr/v1/reports/{silo_entry_id}/periods \
  --header 'Authorization: Bearer <token>'
{
  "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
}
Each period is one submission window for a (kind, role) tuple; corrective re-submissions of the same window appear as separate periods with an incrementing sequence. Filter by report kind with kind. Paginate with offset and limit (default 50, maximum 200). When more results remain, the response carries a next_offset to pass on the next call; it is omitted on the last page.

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"

Query Parameters

​
kind
enum<string>

Restrict the results to a single report kind:

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

Omit to return both kinds.

Available options:
tx,
py
Example:

"tx"

​
offset
integer
default:0

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

Required range: x >= 0
Example:

0

​
limit
integer
default:50

Maximum number of periods to return. Values outside the 1–200 range fall back to the default of 50.

Required range: 1 <= x <= 200
Example:

50

Response

One page of report periods.

One page of report periods, most recent first.

​
periods
object[]
required

The report periods on this page.

​
next_offset
integer

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

Example:

50