The legal-entity resource

Legal-entities are often named “legal-units” in graphical interfaces.

Representation of a legal entity, i.e. an organization that is subject to legal responsibilities in a given jurisdiction (country).

A legal-entity may be comprised of several business-establishments which represent geographically localized structures where the actual work is done. One of which is marked as the legal-entity headquarters.

string

Minimum string length: 1

type

string

Allowed value: "legal-entity"

url

string<uri>

legalName

string

Must be unique. Legal name of the legal-entity.

Required string length: 1 - 255

remoteId

null | string

The third-party API ID of the matching object.

Required string length: 1 - 50

isArchived

boolean

If this legal-entity is archived. Only possible if there are no more business-establishment attached.

countryCode

enum<string>

Three letters ISO 3166-1 alpha-3 country code. Lucca uses restcountries.com to map these codes to the country names displayed in the UI.

Available options:

FRA,

ESP,

DEU,

CHE,

ITA,

GBR,

USA,

BEL,

CAN,

AFG,

ALA,

ALB,

DZA,

ASM,

AND,

AGO,

AIA,

ATA,

ATG,

ARG,

ARM,

ABW,

AUS,

AUT,

AZE,

BHS,

BHR,

BGD,

BRB,

BLR,

BLZ,

BEN,

BMU,

BTN,

BOL,

BIH,

BWA,

BVT,

BRA,

VGB,

IOT,

BRN,

BGR,

BFA,

BDI,

KHM,

CMR,

CPV,

CYM,

CAF,

TCD,

CHL,

CHN,

HKG,

MAC,

CXR,

CCK,

COL,

COM,

COG,

COD,

COK,

CRI,

CIV,

HRV,

CUB,

CYP,

CZE,

DNK,

DJI,

DMA,

DOM,

ECU,

EGY,

SLV,

GNQ,

ERI,

EST,

ETH,

FLK,

FRO,

FJI,

FIN,

GUF,

PYF,

ATF,

GAB,

GMB,

GEO,

GHA,

GIB,

GRC,

GRL,

GRD,

GLP,

GUM,

GTM,

GGY,

GIN,

GNB,

GUY,

HTI,

HMD,

VAT,

HND,

HUN,

ISL,

IND,

IDN,

IRN,

IRQ,

IRL,

IMN,

ISR,

JAM,

JPN,

JEY,

JOR,

KAZ,

KEN,

KIR,

PRK,

KOR,

KWT,

KGZ,

LAO,

LVA,

LBN,

LSO,

LBR,

LBY,

LIE,

LTU,

LUX,

MKD,

MDG,

MWI,

MYS,

MDV,

MLI,

MLT,

MHL,

MTQ,

MRT,

MUS,

MYT,

MEX,

FSM,

MDA,

MCO,

MNG,

MNE,

MSR,

MAR,

MOZ,

MMR,

NAM,

NRU,

NPL,

NLD,

NCL,

NZL,

NIC,

NER,

NGA,

NIU,

NFK,

MNP,

NOR,

OMN,

PAK,

PLW,

PSE,

PAN,

PNG,

PRY,

PER,

PHL,

PCN,

POL,

PRT,

PRI,

QAT,

REU,

ROU,

RUS,

RWA,

BLM,

SHN,

KNA,

LCA,

MAF,

SXM,

SPM,

VCT,

WSM,

SMR,

STP,

SAU,

SEN,

SRB,

SYC,

SLE,

SGP,

SVK,

SVN,

SLB,

SOM,

ZAF,

SGS,

SSD,

LKA,

SDN,

SUR,

SJM,

SWZ,

SWE,

SYR,

TWN,

TJK,

TZA,

THA,

TLS,

TGO,

TKL,

TON,

TTO,

TUN,

TUR,

TKM,

TCA,

TUV,

UGA,

UKR,

ARE,

UMI,

URY,

UZB,

VUT,

VEN,

VNM,

VIR,

WLF,

ESH,

YEM,

ZMB,

ZWE

Required string length: 3

Examples:

"FRA"

"DEU"

currencyCode

enum<string>

ISO-4217 currency code

Available options:

EUR,

CHF,

GBP,

USD,

CAD,

JPY,

BBD,

XAF,

AUD,

PLN,

STN,

NOK,

XBA,

XBB,

ADP,

GWP,

ITL,

IEP,

ILR,

LUC,

LUL,

ROL,

RUR,

VEF,

ZWN,

DKK,

PEN,

XCD,

XSU,

TND,

VUV,

PEI,

PLZ,

ESA,

BOB,

KPW,

MGA,

OMR,

RWF,

SLL,

SGD,

XPF,

RON,

ZAL,

ESP,

VEB,

VNC,

BTN,

CNY,

SVC,

HKD,

LSL,

MUR,

ZAR,

NZD,

XAU,

HRK,

LAJ,

BGN,

GEL,

KES,

MNT,

SHP,

UAH,

YUD,

DJF,

GTQ,

ANG,

BUK,

FRF,

MXP,

NLG,

UGW,

YUN,

BHD,

CLF,

ERN,

GYD,

PAB,

XOF,

XTS,

ARP,

LTT,

MZM,

PTE,

CSD,

ZMK,

BZD,

FKP,

MXV,

SBD,

CHW,

TWD,

TTD,

TRY,

UYU,

BEC,

BEL,

GRD,

IDR,

ZRZ,

BYN,

ISK,

LRD,

ARA,

DDM,

GHC,

SDP,

UAK,

BSD,

LAK,

MDL,

MZN,

SSP,

UYI,

BYR,

CSJ,

GWE,

LUF,

HTG,

KRW,

QAR,

NIC,

SIT,

SDG,

CHC,

AOA,

PHP,

WST,

BAD,

BRN,

BRR,

CYP,

GNS,

LTL,

MTP,

UYN,

DZD,

AWG,

KYD,

SYP,

TZS,

FIM,

MVQ,

SUR,

USS,

ZRN,

KHR,

CRC,

INR,

NIO,

LKR,

SRD,

UYW,

XAG,

DEM,

XFU,

CVE,

CLP,

CDF,

CUC,

CHE,

XBD,

ALK,

BGK,

EEK,

GEK,

LVR,

TRL,

AZN,

CZK,

UGX,

USN,

XPT,

BRB,

BGL,

LSM,

PEH,

UYP,

XRE,

BMD,

BOV,

BWP,

BIF,

DOP,

KZT,

RSD,

ZMW,

BEF,

BRC,

CSK,

GQE,

GHP,

ISJ,

LVL,

TPE,

UGS,

XFO,

MVR,

PGK,

AED,

UZS,

AYM,

BOP,

BGJ,

SKK,

AFN,

KMF,

GMD,

IRR,

ILS,

KGS,

NPR,

SAR,

VES,

XXX,

HRD,

ROK,

ALL,

GNF,

JOD,

MWK,

SEK,

XPD,

BRE,

ECV,

STD,

TMM,

CUP,

MAD,

NGN,

AFA,

ECS,

PES,

COU,

KWD,

LBP,

ATS,

BYB,

ZWD,

AMD,

GIP,

MKD,

MYR,

MXN,

RUB,

THB,

TOP,

TMT,

ARY,

XEU,

ARS,

ETB,

XDR,

IQD,

XUA,

NAD,

PKR,

TJS,

YER,

ZWL,

AOK,

RHD,

YUM,

BND,

GHS,

SOS,

ZWR,

BAM,

COP,

HUF,

JMD,

LYD,

XBC,

MLF,

SDD,

ZWC,

EGP,

SZL,

MOP,

MMK,

VND,

AON,

MTL,

MRO,

MZE,

SRG,

YDD,

BDT,

BRL,

FJD,

HNL,

MRU,

PYG,

SCR,

AOR,

AZM,

GNE,

ILP,

MGF,

ESB,

TJR

taxIdentificationNumber

object

Identifier of the legal-entity in its local jurisdiction.

France: SIREN (Système d'identification du répertoire des entreprises)
Germany: SN (Steuernummer).
Spain: N.I.F (Número de Identificación Fiscal)

Show child attributes

industryCode

object

The industry (classification) code identifies the main type of activity of this legal-entity.

France: APE or NAF code.
Spain: CNAE.
Germany: WZ (Die Klassifikation der Wirtschaftszweige).
U.S.A.: NAICS (North American Industry Classification System).

Show child attributes

createdAt

string<date-time-offset>

Read-only. UTC timestamp of the moment this object was created.

Example:

"2023-01-23T12:45:23.1234Z"

lastUpdatedAt

string<date-time>

Read-only. UTC timestamp of the moment this object was last updated. Set upon creation, update or deletion of the object.

Example:

"2023-01-23T12:45:23.1234Z"

lastArchivedAt

string<date-time> | null

Read-only. UTC timestamp of the moment this object was last archived through its isArchived property.

Example:

"2023-01-23T12:45:23.1234Z"

links

object

Show child attributes