Skip to content

Omnizon Public REST API (v1.0.0)

This is the Omnizon Platform Public REST API specification. For access and API Keys please contact your Omnizon Platform representative.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server
https://omnizon-public-api.redocly.app/_mock/openapi
U-DEV testing environment
https://{tenant}.u-dev.omnizon.network/api

Organizations

Company registration and management operations

Operations

Register a company

Request

Accepts a JSON payload to register a company with required and optional company data.

Security
PublicApiKey
Bodyapplication/jsonrequired
companyVatNumberstringrequired

The company's unique identifier (OIB, 11 digits).

Example: "12345678901"
companyNamestringrequired

The official name of the company.

Example: "Example Ltd."
companyAddressStreetstringrequired

Company street and street number.

Example: "Main Street 123"
companyAddressCitystringrequired

Company city.

Example: "Zagreb"
companyAddressPostalCodestringrequired

Company postal code.

Example: "10000"
companyAddressStatestringrequired

Company state.

Example: "Grad Zagreb"
companyAddressCountrystringrequired

Company country.

Example: "HR"
mpsRegisterbooleanrequired

Indicates whether MPS register required.

Example: true
emailstring

Contact email address (optional).

Example: "info@example.com"
companyWebsitestring

Website URL of the company (optional).

Example: "https://www.example.com"
ibanstring

IBAN of the company (optional).

Example: "HR1234567890123456789"
routingAddressstringrequired

Routing address for the company.

Example: "00000000000"
curl -i -X POST \
  https://omnizon-public-api.redocly.app/_mock/openapi/rest/v1/organizations/register \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "companyVatNumber": "12345678901",
    "companyName": "Example Ltd.",
    "companyAddressStreet": "Main Street 123",
    "companyAddressCity": "Zagreb",
    "companyAddressPostalCode": "10000",
    "companyAddressState": "Grad Zagreb",
    "companyAddressCountry": "HR",
    "mpsRegister": true,
    "email": "info@example.com",
    "companyWebsite": "https://www.example.com",
    "iban": "HR1234567890123456789",
    "routingAddress": "00000000000"
  }'

Responses

Company registered successfully.

Bodyapplication/json
organizationIdstringrequired

Unique identifier for the organization.

Example: "6787a98e15306d37eed688a8"
Response
application/json
{
  "organizationId": "6787a98e15306d37eed688a8"
}

Find organization by vat number

Request

Find organization by vat number.

Security
PublicApiKey
Bodyapplication/jsonrequired
vatNumberstringrequired
curl -i -X POST \
  https://omnizon-public-api.redocly.app/_mock/openapi/rest/v1/organizations/findByVatNumber \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "vatNumber": "string"
  }'

Responses

Company registered successfully.

Bodyapplication/json
fullNamestring
vatNumberstring
localBusinessIdstring
dunsNumberstring
glnstring
peppolIdstring
addressContactstring
addressCitystring
addressPostalCodestring
addressStatestring
addressExtraLine1string
addressExtraLine2string
addressExtraLine3string
webAddressstring
organizationIdstring
Response
application/json
{
  "fullName": "string",
  "vatNumber": "string",
  "localBusinessId": "string",
  "dunsNumber": "string",
  "gln": "string",
  "peppolId": "string",
  "addressContact": "string",
  "addressCity": "string",
  "addressPostalCode": "string",
  "addressState": "string",
  "addressExtraLine1": "string",
  "addressExtraLine2": "string",
  "addressExtraLine3": "string",
  "webAddress": "string",
  "organizationId": "string"
}

Check AMS registration status for organization

Request

Check if an organization is registered in AMS (Asset Management System) by VAT number.

Security
PublicApiKey
Bodyapplication/jsonrequired
vatNumberstringrequired
curl -i -X POST \
  https://omnizon-public-api.redocly.app/_mock/openapi/rest/v1/organizations/amsCheck \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "vatNumber": "string"
  }'

Responses

AMS registration status check completed successfully.

Bodyapplication/json
isAmsRegisteredbooleanrequired

Indicates whether the organization is registered in AMS (Asset Management System)

Response
application/json
{
  "isAmsRegistered": true
}

Documents

Invoice/document processing and status management

Operations

Users

User account management operations

Operations

Billing

Usage metrics and billing information

Operations

ApiKeys

API key generation and management

Operations

Schemas

Schemas