Skip to main content
POST
/
organizations
Create an organization
curl --request POST \
  --url https://api.openfiskal.com/v1/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --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": {}
}
'
{
  "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"
}

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.

Body

application/json
​
legal_name
string
required
Example:

"Mustermann GmbH"

​
country
string
required
Example:

"DE"

​
tax_id
string
required
Example:

"DE123456789"

​
trade_name
string | null
Example:

"Mustermann Café"

​
address
object
​
metadata
object

Response

Organization created

​
legal_name
string
required
Example:

"Mustermann GmbH"

​
country
string
required
Example:

"DE"

​
tax_id
string
required
Example:

"DE123456789"

​
trade_name
string | null
Example:

"Mustermann Café"

​
address
object
​
metadata
object
​
id
string
Example:

"org_01HXYZ"

​
object
string
Allowed value: "organization"
​
created_at
string<date-time>
​
updated_at
string<date-time>