Global FinReg

Creates a Global FinReg account for a user from their email address, so they can order and manage LEIs. GFR emails the address a link to set a password; you get no access to the account from this tool. After the user has set a password, register for access with /auth.md and use the account tools. If the address already has an account nothing changes, and the answer is the same. Ask the user for their email address, first name and last name, and confirm them with them before calling.

{
  "type": "object",
  "properties": {
    "email": {
      "description": "The user's email address. The account and all GFR emails use it.",
      "type": "string"
    },
    "firstName": {
      "description": "The user's first name, as the user gave it. Required.",
      "type": "string"
    },
    "lastName": {
      "description": "The user's last name, as the user gave it. Required.",
      "type": "string"
    },
    "languageCode": {
      "description": "Language code for the account, e.g. en, da, nn (Norwegian), sv, de, fr. The welcome email is in en, da, nn or sv, otherwise English. Default en.",
      "type": "string",
      "default": "en"
    },
    "currencyCode": {
      "description": "Currency for prices and invoices, e.g. EUR, DKK, SEK, NOK, USD, GBP. Default EUR.",
      "type": "string",
      "default": "EUR"
    }
  },
  "required": [
    "email",
    "firstName",
    "lastName"
  ]
}

Looks up an entity legal form (ISO 20275 ELF code list) in a country: by ELF code first, otherwise by the legal form's local name, optionally within a region of the country.

{
  "type": "object",
  "properties": {
    "countryCode": {
      "description": "ISO 3166-1 alpha-2 country code, e.g. DK.",
      "type": "string"
    },
    "elfCode": {
      "description": "The 4-character ELF code, e.g. H8VP.",
      "type": "string",
      "default": null
    },
    "localName": {
      "description": "The legal form's local name, e.g. Anpartsselskab.",
      "type": "string",
      "default": null
    },
    "regionCode": {
      "description": "ISO 3166-2 region code, for countries whose legal forms differ by region.",
      "type": "string",
      "default": null
    }
  },
  "required": [
    "countryCode"
  ]
}

Returns Global FinReg's LEI prices in every supported currency, excluding VAT: for a new registration and for a renewal, for 1, 3 and 5 years, each as pricePerYear and total for the whole period; and the optional fully assisted service. For the exact total for one LEI, including VAT, use get_registration_quote or get_renewal_quote.

{
  "type": "object",
  "properties": {}
}

Searches the global LEI register by legal entity name. Returns matching entities with their LEI, country and a link to the entity's GlobalFinReg lookup page.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "The legal name (or part of it) of the entity, at least 3 characters.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of results, 1 to 50.",
      "type": "integer",
      "default": 10
    }
  },
  "required": [
    "query"
  ]
}

Returns the registration record of an LEI from the global LEI register: legal name, legal and headquarters address, jurisdiction, legal form, entity and registration status, registration and renewal dates and the managing LOU.

{
  "type": "object",
  "properties": {
    "lei": {
      "description": "The 20-character Legal Entity Identifier, e.g. 89450060XX5ILUURV330.",
      "type": "string"
    }
  },
  "required": [
    "lei"
  ]
}