v1

OpenAPI 3.0.1Proprietary2026-07-146923125.8 KB

Vendor Company

Retrieve all the companies

get/company

Query parameters

pageNumberinteger

Page number to retrieve

pageSizeinteger

Number of elements for the requested page

sortDirection'ASC' | 'DESC'

Elements sort direction

sortFieldstring

Field to sort by

emailstring

Filter by Company email

companyNamestring

Filter by Company name

enabledboolean

Filter enabled Companies - admin only

Response

idinteger

namestring required

A descriptive name of the resource

selfstring

taxValidation'VALID, NOT_CHECKED, EMPTY, MISMATCH, NOT_FOUND'

Validation of tax code for a company

taxValidationMessagestring

Detailed validation message

companyDescriptionstring

Description of the company, displayed on the marketplace

taxCodestring

Tax code

slugstring

Auto-generated string uniquely identifying the company

phoneNumberstring

Phone number

emailAddressstring required

Email address

languagestring

Preferred company language

enabledboolean

syndicationEndpointstring

Receives event notifications targeted to all the company products

reastring

Repertorio economico amministrativo - corporate data for Italian companies

ristring

Registro imprese - corporate data for Italian companies

technicalEmailAddressstring

Email address that will receive technical notifications

publicKeystring

SSH RSA public keys for every employee

currentPublishedProductsinteger

Counts the published products on the marketplace for the company

externalIdstring

An externalId if the company is synchronized from an external system

companyUrlstring

Website of the company

notificationSecretTokenstring

Shared secret used to sign events

Example response

[
  {
    "self": "subscription/123",
    "logoFile": {
      "url": "resourceName/ID"
    },
    "users": [
      {
        "url": "resourceName/ID"
      }
    ]
  }
]