---
title: "Retrieve a customer company for the given ID"
method: GET
path: "/userCompany/{id}"
tags: ["Customer Company"]
---

# Retrieve a customer company for the given ID

`GET /userCompany/{id}`

## Path parameters

- `id` integer, required

## Response `200`

OK

- UserCompanyDTO — Company data of a business customer
  - `id` integer
  - `name` string, required — A descriptive name of the resource
  - `self` string
  - `taxValidation` 'VALID, NOT_CHECKED, EMPTY, MISMATCH, NOT_FOUND' — Validation of tax code for a company
  - `taxValidationMessage` string — Detailed validation message
  - `companyDescription` string — Description of the company, displayed on the marketplace
  - `logoFile` UrlEntityDTO — Reference to a related resource
    - `url` string, required — Reference to another resource
  - `address` AddressDTO — A physical address
    - `id` integer
    - `country` string — Country name
    - `city` string — City name
    - `address` string — Street name, with number
    - `zipCode` string — Local postal code
    - `state` string — Province/State code
    - `countryCode` string — Country code
  - `taxCode` string — Tax code
  - `slug` string — Auto-generated string uniquely identifying the company
  - `phoneNumber` string — Phone number
  - `emailAddress` string, required — Email address
  - `language` string — Preferred company language
  - `enabled` boolean
  - `syndicationEndpoint` string — Receives event notifications targeted to all the company products
  - `rea` string — Repertorio economico amministrativo - corporate data for Italian companies
  - `ri` string — Registro imprese - corporate data for Italian companies
  - `technicalEmailAddress` string — Email address that will receive technical notifications
  - `publicKey` string — SSH RSA public keys for every employee
  - `currentPublishedProducts` integer — Counts the published products on the marketplace for the company
  - `externalId` string — An externalId if the company is synchronized from an external system
  - `companyUrl` string — Website of the company
  - `notificationSecretToken` string — Shared secret used to sign events
  - `users` UrlEntityDTO[] — Users of the company
    - `url` string, required — Reference to another resource
  - `vatExemption` VatExemptionDTO — Details of a VAT Exemption document valid under Italian laws
    - `declarationNumber` string — The reference number of the document
    - `declarationDate` string, date-time — The declaration date of the document
    - `internalProtocolNumber` string — The internal protocol number of the document
  - `italianElectronicInvoicing` ItalianElectronicInvoicingDTO — Electronic invoicing data for Italian business companies
    - `sdiCode` string — Codice univoco ufficio/Codice destinatario
    - `pec` string — Posta elettronica certificata
  - `publicAdministration` boolean — Mark this Company as public administration
  - `delayedPayment` boolean — If this customer can pay later, only for admin/reseller
  - `resellerCatalog` UrlEntityDTO — Reference to a related resource
    - `url` string, required — Reference to another resource

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/cloudesire/apis/cloudesire-users-api.md) · [All operations](https://skmtc.net/cloudesire/apis/cloudesire-users-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudesire/cloudesire-users-api/versions/3d64889e8ae7/schema)