v1

latestOpenAPI 3.0.1Proprietary2026-07-146923125.8 KB
Customer Company

Retrieve customer companies

get/userCompany

Query parameters

searchstring

Fuzzy filter by name or slug

pageNumberinteger

Page number to retrieve

Page number to retrieve

pageSizeinteger

Number of elements for the requested page

Number of elements for the requested page

sortDirection'ASC' | 'DESC'

Elements sort direction

Elements sort direction

sortFieldstring

Field to sort by

Response

OK

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

publicAdministrationboolean

Mark this Company as public administration

delayedPaymentboolean

If this customer can pay later, only for admin/reseller

Example response

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