# Get Company

Get a specific company.

Endpoint: GET /api/v1/company
Version: 1.0

## Response 200 fields (application/json):

  - `id` (integer, required)
    Unique identifier of the entity
    Example: 1

  - `name` (string)
    Company name.
    Example: "CLAVEi"

  - `cif` (string)
    Company tax identification code.
    Example: "B12345678"

  - `emailAddress` (string)
    Main company email address.
    Example: "info@clavei.es"

  - `emailHost` (string)
    SMTP email host.
    Example: "smtp.clavei.es"

  - `emailPort` (integer)
    SMTP email server port.
    Example: 587

  - `emailUsername` (string)
    SMTP username for outgoing email.
    Example: "user@clavei.es"

  - `emailPasswordKey` (string)
    Encrypted key for the email password.
    Example: "ENCRYPTED_KEY_123"

  - `emailReplyToAddress` (string)
    Reply-to email address used in communications.
    Example: "support@clavei.es"

  - `emailSignature` (string)
    Email signature in HTML or plain text.

  - `emailEnableTls` (boolean)
    If true, TLS is enabled for outgoing emails.
    Example: true

  - `createdBy` (string)
    User who created the record.
    Example: "admin"

  - `modifiedBy` (string)
    User who last modified the record.
    Example: "johndoe"

  - `createdOn` (string)
    Timestamp when the record was created. Format: yyyy-MM-dd'T'HH:mm:ss
    Example: "2024-01-03T08:15:45"

  - `modifiedOn` (string)
    Timestamp when the record was last modified. Format: yyyy-MM-dd'T'HH:mm:ss
    Example: "2024-08-07T17:35:00"

  - `additionalInfo` (object)
    Additional information of the company. See ApiCompanyInfoReadDto.java for structure.

  - `additionalInfo.code` (string, required)
    Unique code of the company.
    Example: "C100"

  - `additionalInfo.commercialName` (string, required)
    Commercial name of the company.
    Example: "Clavei"

  - `additionalInfo.cif` (string)
    Tax Identification Code (CIF) of the company.
    Example: "B12345678"

  - `additionalInfo.name` (string, required)
    Full legal name of the company.
    Example: "Clavei S.L."

  - `additionalInfo.address` (string)
    Address of the company.
    Example: "Avda. Salamanca 7"

  - `additionalInfo.country` (object, required)
    Country details. See ApiCountryListReadDto.java

  - `additionalInfo.country.code` (string, required)
    Country code (usually ISO numeric or similar).
    Example: 724

  - `additionalInfo.country.description` (string, required)
    Country description or name.
    Example: "Spain"

  - `additionalInfo.country.isoCode` (string)
    ISO Alpha-2 code for the country.
    Enum: "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW"

  - `additionalInfo.country.customerVatType` (string)
    Type of VAT scheme for customers in this country.
    Example: "GENERAL"

  - `additionalInfo.country.geographicalLocation` (string, required)
    Geographical location of the country. See ApiGeographicalLocation enum for values.
    Enum: "CEUTA_MELILLA_CANARIAS", "COMMUNITY", "NATIONAL", "OTHERS"

  - `additionalInfo.state` (object)
    State/Province details. See ApiStateListReadDto.java

  - `additionalInfo.state.code` (string, required)

  - `additionalInfo.state.description` (string)

  - `additionalInfo.state.country` (object)

  - `additionalInfo.state.isoCode` (string)

  - `additionalInfo.postalCode` (string)
    Postal code.
    Example: "03203"

  - `additionalInfo.city` (string)
    City where the company is located.
    Example: "Elche"

  - `additionalInfo.phone1` (string)
    Primary contact phone number.
    Example: "+34 966 610 442"

  - `additionalInfo.phone2` (string)
    Secondary contact phone number.
    Example: "+34 966 610 443"

  - `additionalInfo.email` (string)
    Contact email address.
    Example: "info@clavei.es"

  - `additionalInfo.website` (string)
    Company website.
    Example: "https://www.clavei.es"

  - `additionalInfo.commercialRegistry` (string)
    Company commercial registry information.
    Example: "Volume 1234, Sheet 56, Inscription 1"

  - `additionalInfo.observations` (string)
    Any additional observations about the company.
    Example: "Leading software provider in Alicante"

  - `additionalInfo.logo` (string)
    URL or file name for the company logo image.
    Example: "logo.png"

  - `additionalInfo.logoToken` (string)
    Token associated with the company logo.
    Example: "token-1a2b3c"

  - `additionalInfo.activeB2B` (boolean)
    Indicates whether B2B is active for the company.
    Example: true

  - `additionalInfo.backgroundImage` (string)
    URL or file name of the company background image.
    Example: "background.jpg"

  - `additionalInfo.backgroundImageToken` (string)
    Token for the background image.
    Example: "token-bg"

  - `additionalInfo.blockchainAccount` (string)
    Blockchain account of the company.
    Example: "0x342acbd88491ca"

  - `additionalInfo.blockchainPrivateKey` (string)
    Private key for the blockchain account.
    Example: "PRIVKEY123"

  - `additionalInfo.ropoCode` (string)
    ROPO code of the company.
    Example: "ROPOCODE456"

  - `additionalInfo.customerVatType` (object)
    VAT type for customers. See ApiCustomerVatTypeListReadDto.java

  - `additionalInfo.customerVatType.code` (string, required)
    VAT type code. Example: GENERAL, REDUCED, EXEMPT, etc.
    Example: "GENERAL"

  - `additionalInfo.customerVatType.description` (string)
    Description of the VAT type.
    Example: "General VAT type"

  - `additionalInfo.paymentMethod` (object)
    Preferred payment method. See ApiPaymentMethodListReadDto.java

  - `additionalInfo.paymentMethod.code` (integer, required)
    Código único del método de pago
    Example: 1

  - `additionalInfo.paymentMethod.description` (string, required)
    Descripción del método de pago
    Example: "Transferencia bancaria"

  - `additionalInfo.paymentMethod.document` (string)
    Documento asociado al método de pago
    Example: "Contrato"

  - `additionalInfo.paymentMethod.firstTerm` (integer)
    Primer plazo de pago en días
    Example: 30

  - `additionalInfo.paymentMethod.terms` (integer)
    Número total de plazos
    Example: 3

  - `additionalInfo.paymentMethod.daysTerms` (integer)
    Días entre plazos
    Example: 30

  - `additionalInfo.paymentMethod.remittance` (boolean)
    Indica si es una remesa
    Example: true

  - `additionalInfo.paymentMethod.addToCustomerBase` (boolean)
    Indica si se debe añadir a la base de clientes
    Example: true

  - `additionalInfo.paymentMethod.serveFullPrePaid` (boolean)
    Indica si sirve como pago anticipado completo

  - `additionalInfo.paymentMethod.observations` (string)
    Observaciones adicionales
    Example: "Requiere verificación bancaria"

  - `additionalInfo.paymentMethod.icon` (string)
    Icono representativo del método de pago
    Example: "fa-credit-card"

  - `additionalInfo.paymentMethod.facturaECode` (string)
    Código de factura electrónica asociado
    Enum: "NOT_SPECIFIED", "CASH", "DOMICILED_RECEIPT", "RECEIPT", "TRANSFER", "ACCEPTED_LETTER", "LETTER_OF_CREDIT", "CONTRACT_AWARD", "BILL_OF_EXCHANGE", "PROMISORY_NOTE_IN_ORDER", "PROMISORY_NOTE_NOT_IN_ORDER", "CHECK_NOTE", "REPLACEMENT", "SPECIALS", "COMPENSATION", "POSTAL_ORDER", "FORMED_CHECK", "BANK_CHECK", "CASH_ON_DELIVERY_PAYMENT", "PAYMENT_BY_CARD"

  - `additionalInfo.unitType` (object)
    Default unit type for the company. See ApiUnitTypeListReadDto.java

  - `additionalInfo.unitType.isoCode` (string)
    Defines the unit ISO codes.
    Enum: "DMK", "FOT", "FTK", "LM", "MIL", "MTK", "MTR", "NMP", "PR", "B5", "C62"

  - `additionalInfo.warehouse` (object)
    Default warehouse for the company. See ApiWarehouseListReadDto.java

  - `additionalInfo.warehouse.code` (string, required)
    Warehouse code (unique per warehouse).
    Example: "ALM01"

  - `additionalInfo.warehouse.description` (string, required)
    Warehouse description.
    Example: "Central warehouse"

  - `additionalInfo.rateCode` (object)
    Rate code information. See ApiRateCodeListReadDto.java

  - `additionalInfo.rateCode.taxesIncluded` (boolean)

  - `additionalInfo.salesAccount` (object)
    Sales account information. See ApiChartAccountBasicReadDto.java

  - `additionalInfo.salesAccount.code` (string)
    Code of the chart account
    Example: 1000

  - `additionalInfo.salesAccount.description` (string)
    Description of the chart account
    Example: "Cash account"

  - `additionalInfo.purchasingAccount` (object)
    Purchasing account information. See ApiChartAccountBasicReadDto.java

  - `additionalInfo.bank` (object)
    Bank information. See ApiBankListReadDto.java

  - `additionalInfo.bank.code` (string, required)
    Unique code for the bank.
    Example: "ES1234"

  - `additionalInfo.bank.name` (string, required)
    Bank name.
    Example: "CLAVEI BANK"

  - `additionalInfo.bank.iban` (string)
    IBAN account code.
    Example: "ES9820385778983000760236"

  - `additionalInfo.bank.swift` (string)
    SWIFT/BIC code.
    Example: "BSABESBBXXX"

  - `additionalInfo.bank.inactive` (boolean)
    Indicates if the bank is inactive.

  - `additionalInfo.bank.riskGranted` (number)
    Granted risk limit for the bank.
    Example: 25000

  - `additionalInfo.bank.riskConsumed` (number)
    Consumed risk for the bank.
    Example: 13000.55

  - `additionalInfo.bank.accountingAccount` (string)
    Accounting account reference.
    Example: 5720001234

  - `additionalInfo.bank.policyAccount` (string)
    Policy account reference.
    Example: 5720009999

  - `additionalInfo.bank.picture` (string)
    URL or name of the main picture.
    Example: "bank_logo.png"

  - `additionalInfo.bank.pictureToken` (string)
    Security token for picture.
    Example: "1f8e3ac9d89d"

  - `additionalInfo.bank.defaultBank` (boolean)
    Indicates if this is the default bank.
    Example: true

  - `additionalInfo.bank.balance` (number)
    Bank balance value.
    Example: 15400.8

  - `additionalInfo.bank.income` (number)
    Bank income amount.
    Example: 9671.22

  - `additionalInfo.bank.expenses` (number)
    Bank expenses amount.
    Example: 5400.13

  - `additionalInfo.bank.synchronizable` (boolean)
    Indicates if the bank is synchronizable.

  - `additionalInfo.bank.showSummary` (boolean)
    Indicates if the summary should be shown.
    Example: true

  - `additionalInfo.bank.token` (string)
    Token value related to the bank.
    Example: "token-885b"

  - `additionalInfo.billingSeriesSale` (object)
    Billing series for sales. See ApiBillingSeriesListReadDto.java

  - `additionalInfo.billingSeriesSale.type` (string, required)
    Type of the billing series. See ApiBillingSeriesTypeEnum for possible values.
    Enum: "PURCHASE", "PURCHASE_TICKET", "SALE", "SALE_TICKET", "INVOICE_DRAFT"

  - `additionalInfo.billingSeriesSale.code` (string, required)
    Billing series code.
    Example: "SER2025"

  - `additionalInfo.billingSeriesSale.description` (string)
    Description of the billing series.
    Example: "Main invoice series"

  - `additionalInfo.billingSeriesSale.deposit` (boolean)
    Indicates if this is the default series.
    Example: true

  - `additionalInfo.billingSeriesSale.corrective` (boolean)

  - `additionalInfo.billingSeriesSaleTicket` (object)
    Billing series for sale tickets. See ApiBillingSeriesListReadDto.java

  - `additionalInfo.billingSeriesPurchase` (object)
    Billing series for purchases. See ApiBillingSeriesListReadDto.java

  - `additionalInfo.billingSeriesPurchaseTicket` (object)
    Billing series for purchase tickets. See ApiBillingSeriesListReadDto.java

  - `additionalInfo.billingSeriesInvoiceDraft` (object)
    Billing series for invoice drafts. See ApiBillingSeriesListReadDto.java

  - `additionalInfo.currency` (object)
    Default currency for the company. See ApiCurrencyListReadDto.java

  - `additionalInfo.currency.nomenclature` (string)

  - `additionalInfo.currency.isoCode` (string)
    Defines the ISO currency codes.
    Enum: "AED", "AFA", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZM", "BAM", "BBD", "BDT", "BGL", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYR", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CVE", "CYP", "CZK", "DJF", "DKK", "DOP", "DZD", "EEK", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GGP", "GHC", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "IMP", "INR", "IQD", "IRR", "ISK", "JEP", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LVL", "LYD", "MAD", "MDL", "MGF", "MKD", "MMK", "MNT", "MOP", "MRO", "MTL", "MUR", "MVR", "MWK", "MXN", "MYR", "MZM", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "ROL", "RUR", "RWF", "SAR", "SBD", "SCR", "SDD", "SEK", "SGD", "SHP", "SIT", "SKK", "SLL", "SOS", "SPL", "SRG", "STD", "SVC", "SYP", "SZL", "THB", "TJS", "TMM", "TND", "TOP", "TRL", "TTD", "TVD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VEB", "VND", "VUV", "WST", "XAF", "XAG", "XAU", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "YER", "YUM", "ZAR", "ZMK", "ZWD", "RUB", "TRY"

  - `additionalInfo.currency.changeValue` (number)

  - `additionalInfo.currency.significantDecimalsDocuments` (integer)

  - `additionalInfo.currency.intermediateDecimalsDocuments` (integer)

  - `additionalInfo.currency.decimalsCalculatePrices` (integer)

  - `additionalInfo.currency.decimalsCalculateCosts` (integer)

  - `additionalInfo.shippingTerm` (object)
    Default shipping term for the company. See ApiShippingTermListReadDto.java

  - `additionalInfo.shippingTerm.customerPays` (boolean)

  - `additionalInfo.shippingTerm.intrastatCode` (string)

  - `additionalInfo.secondaryCurrency` (object)
    Secondary currency for the company. See ApiCurrencyListReadDto.java

  - `additionalInfo.customersAccount` (object)
    Chart account for customers.
    Example: 430000

  - `additionalInfo.suppliersAccount` (object)
    Chart account for suppliers.
    Example: 400000

  - `additionalInfo.creditorVatAccount` (object)
    Creditor VAT account.
    Example: 477000

  - `additionalInfo.debtorVatAccount` (object)
    Debtor VAT account.
    Example: 475000

  - `additionalInfo.supInternalOpAccount` (object)
    Supplier internal operations account.
    Example: 600100

  - `additionalInfo.supRecAccount` (object)
    Supplier received account.
    Example: 600200

  - `additionalInfo.supAssetsAccount` (object)
    Supplier assets account.
    Example: 213000

  - `additionalInfo.supServicesAccount` (object)
    Supplier services account.
    Example: 621000

  - `additionalInfo.supImportsAccount` (object)
    Supplier imports account.
    Example: 600300

  - `additionalInfo.supIrpfLeasesAccount` (object)
    Supplier IRPF leases account.
    Example: 622000

  - `additionalInfo.supIrpfProfessionalAccount` (object)
    Supplier IRPF professional services account.
    Example: 623000

  - `additionalInfo.supIrpfAgroAccount` (object)
    Supplier IRPF agricultural account.
    Example: 624000

  - `additionalInfo.outInternalOpAccount` (object)
    Outgoing internal operations account.
    Example: 700100

  - `additionalInfo.outRecAccount` (object)
    Outgoing received account.
    Example: 700200

  - `additionalInfo.outAssetsAccount` (object)
    Outgoing assets account.
    Example: 213100

  - `additionalInfo.outServicesAccount` (object)
    Outgoing services account.
    Example: 621100

  - `additionalInfo.outImportsAccount` (object)
    Outgoing imports account.
    Example: 700300

  - `additionalInfo.outReverseChargeAccount` (object)
    Outgoing reverse charge account.
    Example: 477100

  - `additionalInfo.outWithholdingAccount` (object)
    Outgoing withholding account.
    Example: 475100

  - `additionalInfo.salesConcept` (object)
    Sales concept. See ApiConceptListReadDto.java
    Example: "SALE_GENERAL"

  - `additionalInfo.salesConcept.code` (string)
    Code of the concept
    Example: "CON001"

  - `additionalInfo.salesConcept.description` (string)
    Description of the concept
    Example: "Sales revenue"

  - `additionalInfo.purchasingConcept` (object)
    Purchasing concept. See ApiConceptListReadDto.java
    Example: "PURCHASE_GENERAL"

  - `additionalInfo.igic` (boolean)
    Indicates if IGIC is applicable.

  - `additionalInfo.companyType` (string)
    Type of company. See ApiCompanyTypeEnum.java
    Enum: "LEGAL_PERSON", "NATURAL_PERSON"

  - `additionalInfo.ticketbaiTaxAuthority` (string)
    Tax authority for TicketBAI. See TicketAuthorityEnum.java
    Enum: "ALAVA", "VIZCAYA", "GUIPUZCOA"

  - `additionalInfo.underEquivalenceSurchargeRegime` (boolean)
    Indicates if the company is under the equivalence surcharge regime.
    Example: true

  - `additionalInfo.numericFormatStyle` (string)
    Numeric format style. See ApiNumericFormatStyleEnum.java
    Enum: "US_WITH_GROUPING", "EU_WITH_GROUPING", "US_NO_GROUPING", "EU_NO_GROUPING"

  - `additionalInfo.ticketbaiActive` (boolean)
    Indicates if TicketBAI is active.
    Example: true

  - `additionalInfo.ticketbaiConditionDate` (string)
    Date when TicketBAI condition starts.
    Example: "2025-01-01"

  - `additionalInfo.ticketbaiConditionName` (string)
    Name associated with TicketBAI condition.
    Example: "Clavei S.L."

  - `additionalInfo.ticketbaiConditionVatId` (string)
    VAT ID associated with TicketBAI condition.
    Example: "B12345678"

  - `additionalInfo.ticketbaiConditionAddress` (string)
    Address associated with TicketBAI condition.
    Example: "Avda. Salamanca 7, Elche"

  - `additionalInfo.defaultInvoiceDescription` (string)
    Default description for invoices.
    Example: "Software development services"

  - `additionalInfo.ticketbaiTest` (boolean)
    Indicates if TicketBAI is in test mode.

  - `additionalInfo.vatOperationType` (object)
    VAT operation type. See ApiVatOperationTypeListReadDto.java
    Example: "GENERAL"

  - `additionalInfo.vatOperationType.code` (string, required)
    Unique code of the VAT operation type
    Example: "E01"

  - `additionalInfo.vatOperationType.description` (string, required)
    Description of the VAT operation type
    Example: "Intra-community acquisition of goods"

  - `additionalInfo.vatOperationType.model347` (boolean)
    Indicates if the operation type is included in model 347
    Example: true

  - `additionalInfo.vatOperationType.model349` (boolean)
    Indicates if the operation type is included in model 349

  - `additionalInfo.verifactuActive` (boolean)
    Indicates if Verifactu is active.
    Example: true

  - `additionalInfo.verifactuTest` (boolean)
    Indicates if Verifactu is in test mode.

  - `additionalInfo.verifactuStartDate` (string)
    Start date for Verifactu.
    Example: "2025-06-01"

  - `additionalInfo.verifactuEndDate` (string)
    End date for Verifactu.
    Example: "2025-12-31"

  - `additionalInfo.receiptConcept` (object)
    Concept for receipts. See ApiConceptListReadDto.java
    Example: "RECEIPT_GENERAL"

  - `additionalInfo.purchaseReceiptConcept` (object)
    Concept for purchase receipts. See ApiConceptListReadDto.java
    Example: "PURCHASE_RECEIPT"

  - `additionalInfo.modeVerifactu` (boolean)
    Indicates if Verifactu is in special mode.

  - `additionalInfo.verifactuExemptCause` (string)
    Exempt cause for Verifactu. See ApiVerifactuExemptCauseEnum.java
    Enum: "SII", "TICKETBAI", "OUTSIDE_SPAIN", "NAVARRA", "NOT_APPLICABLE", "OTHER", "TRANSITORY"

  - `additionalInfo.verifactuExemptDate` (string)
    Date of Verifactu exemption.
    Example: "2025-07-01"

  - `additionalInfo.openingConcept` (object)
    Concept for opening operations. See ApiConceptListReadDto.java
    Example: "OPENING"

  - `additionalInfo.closingConcept` (object)
    Concept for closing operations. See ApiConceptListReadDto.java
    Example: "CLOSING"

  - `additionalInfo.operatingClosingConcept` (object)
    Concept for operating closing operations. See ApiConceptListReadDto.java
    Example: "OPERATING_CLOSING"

  - `posModuleActive` (boolean)
    Indicates if the POS module is active for the company.
    Example: true

  - `posModuleTrial` (boolean)
    Indicates if the POS module is in trial mode for the company.