Skip to main content
GET
/
locations
/
{locationId}
/
registers
List registers at a location
curl --request GET \
  --url https://api.openfiskal.com/v1/locations/{locationId}/registers \
  --header 'Authorization: Bearer <token>'
{
  "object": "<string>",
  "data": [
    {
      "label": "Kasse 1",
      "jurisdiction": "IT",
      "serial_number": "<string>",
      "metadata": {},
      "id": "reg_01HXYZ",
      "object": "<string>",
      "location_id": "<string>",
      "state": "active",
      "active_fiscal_unit": {
        "id": "fu_01HXYZ",
        "object": "<string>",
        "register_id": "reg_01HXYZ",
        "state": "provisioning",
        "jurisdiction": "IT",
        "fiscal_registration": {
          "regime": "<string>",
          "tse_serial": "abc123def456",
          "client_id": "Kasse 1",
          "signature_algorithm": "ecdsa-plain-SHA384",
          "time_format": "utcTime",
          "registered_at": "2023-11-07T05:31:56Z"
        },
        "reason": "TSE hardware end-of-life",
        "replaces": "fu_00HXYZ",
        "replaced_by": "fu_02HXYZ",
        "provisioned_at": "2023-11-07T05:31:56Z",
        "decommissioned_at": "2023-11-07T05:31:56Z",
        "created_at": "2023-11-07T05:31:56Z"
      },
      "fiscal_state": "pending",
      "fiscal_registration": {
        "regime": "<string>",
        "tse_serial": "abc123def456",
        "client_id": "Kasse 1",
        "signature_algorithm": "ecdsa-plain-SHA384",
        "time_format": "utcTime",
        "registered_at": "2023-11-07T05:31:56Z"
      },
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

Authorization
string
header
required

Platform API key sent as Authorization: Bearer ofk_platform_.... Platform integrators also pass OpenFiskal-Organization: org_xxx to act on behalf of a merchant.

Headers

OpenFiskal-Organization
string

Merchant organization ID. Required for platform integrators acting on behalf of a specific merchant. Omit when using an organization-scoped API key directly.

Path Parameters

locationId
string
required

Response

List of registers

object
string
Allowed value: "list"
data
object[]