Skip to main content
GET
/
organizations
List organizations
curl --request GET \
  --url https://api.openfiskal.com/v1/organizations \
  --header 'Authorization: Bearer <token>'
{
  "object": "<string>",
  "data": [
    {
      "legal_name": "Mustermann GmbH",
      "country": "DE",
      "tax_id": "DE123456789",
      "trade_name": "Mustermann Café",
      "address": {
        "line1": "Friedrichstraße 42",
        "line2": "<string>",
        "city": "Berlin",
        "state": "<string>",
        "postal_code": "10117",
        "country": "DE"
      },
      "metadata": {},
      "id": "org_01HXYZ",
      "object": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": "<string>"
}

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.

Query Parameters

​
limit
integer
default:50

Maximum number of results to return per page.

Required range: 1 <= x <= 200
​
cursor
string

Pagination cursor from a previous response's cursor field. Omit to start from the beginning.

Response

Paginated list of organizations

​
object
string
Allowed value: "list"
​
data
object[]
​
cursor
string | null