Organization identifications

Numeral fully supports the standard list of External Organisation Identification Code as defined by the ISO 20022 External Code Sets, ensuring greater interoperability and standardization, simplifying your integration efforts and enabling seamless communication with a wider range of financial systems.

Objects supporting organization identifications are:

Internal accounts
External accounts

ISO code	Numeral attribute	Description
LEI	`legal_entity_identifier`	Legal Entity Identifier is a code allocated to a party as described in ISO 17442 "Financial Services - Legal Entity Identifier (LEI)".
AnyBIC	`business_identification_code`	Code allocated to a financial or non-financial institution by the ISO 9362 Registration Authority, as described in ISO 9362: 2014 - "Banking - Banking telecommunication messages - Business identifier code (BIC)".
	`default_other_identifier`	Optional attribute that defines the default type/value to use in the others object. Its value must match the an existing type in the others array.
Othr	`others`	Type value array containing a list of organization identifiers according to its Numeral code

{
  "object": "internal_account",
  
  //Other attributes removed for the sake of clarity
  
  "organization_identification": {
    "legal_entity_identifier": "5493001KJHG78Y4TCF23",
    "business_identification_code": null,
    "default_other_identifier_type": "siren",
    "others": [
      {
        "type": "siren",
        "value": "123456789"
      },
      {
        "type": "siret",
        "value": "123456789123"
      }
    ]
  }
}

{
  "object": "external_account",
  
  //Other attributes removed for the sake of clarity
  
  "organization_identification": {
    "legal_entity_identifier": "5493001KJHG78Y4TCF23",
    "business_identification_code": null,
    "default_other_identifier_type": "siren",
    "others": [
      {
        "type": "siren",
        "value": "123456789"
      },
      {
        "type": "siret",
        "value": "123456789123"
      }
    ]
  }
}

Can be stored in others the following identifications:

ISO code	Numeral attribute	Description
BANK	`bank_identification`	Unique and unambiguous assignment made by a specific bank or similar financial institution to identify a relationship as defined between the bank and its client.
CBID	`central_bank_identification`	A unique identification number assigned by a central bank to identify an organisation
CHID	`clearing_house_identification`	A unique identification number assigned by a clearing house to identify an organisation
CINC	`company_incorporation_number`	A unique identification number assigned by a designated authority to a certificate of incorporation and used to identify an organisation
COID	`company_identification`	Country authority given organisation identification (e.g., corporate registration number)
CUST	`customer_number`	Number assigned by an issuer to identify a customer. Number assigned by a party to identify a creditor or debtor relationship.
DUNS	`duns_number`	A unique identification number provided by Dun & Bradstreet to identify an organisation.
EMPL	`employee_number`	Number assigned by a registration authority to an employer.
GS1G	`global_location_number`	Global Location Number. A non-significant reference number used to identify legal entities, functional entities, or physical entities according to GS1 numbering scheme rules.The number is used to retrieve detailed information that is linked to it.
SREN	`siren`	The SIREN number is a 9 digit code assigned by INSEE, the French National Institute for Statistics and Economic Studies, to identify an organisation in France.
SRET	`siret`	The SIRET number is a 14 digit code assigned by INSEE, the French National Institute for Statistics and Economic Studies, to identify an organisation unit in France. It consists of the SIREN number, followed by a five digit classification number, to identify the local geographical unit of that entity
TXID	`tax_number`	Number assigned by a tax authority to identify an organisation
BDID	`business_domain_identification`	Identifier of the business domain in which the organisation is active
BOID	`other_identification`	Other identification of the organisation.