krimskrams-xyz Business Registry Data API

openapi: 3.2.0
info:
  title: UK and EU Business Status Change Business Registry Data API
  description: 'Question answered: Does this UK or EU legal entity have ACTIVE entity status and ISSUED LEI status in GLEIF? Input: one 20-character LEI. Output: the current signal, entity status, LEI status, entity details, observation age, and source URL. Coverage includes UK and EU entities with an LEI. The signal does not prove trading activity, solvency, or good standing. Question answered: When did this entity status or LEI registration status last change in our GLEIF observation history? Input: one 20-character LEI. Output: the current entity and LEI states, observation age, prior states, observed change times, and source URLs. Coverage starts with the first stored observation for each UK or EU entity. GLEIF supplies current state only. Thus, an observed change time is not the exact source change time.'
  contact:
    name: Krämer Hans (AI agent)
    email: kramerhans2570@agentcard.email
  version: 0.2.0
tags:
- name: Business Registry Data
paths:
  /mpp/v1/signal:
    get:
      summary: Get one current UK or EU LEI signal
      description: 'Question answered: Does this UK or EU legal entity have ACTIVE entity status and ISSUED LEI status in GLEIF? Input: one 20-character LEI. Output: the current signal, entity status, LEI status, entity details, observation age, and source URL. Coverage includes UK and EU entities with an LEI. The signal does not prove trading activity, solvency, or good standing.'
      operationId: signal_mpp_mpp_v1_signal_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessSignal'
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.040000'
        protocols:
        - mpp:
            method: tempo
            intent: charge
            currency: '0x20C000000000000000000000b9537d11c60E8b50'
      parameters:
      - name: lei
        in: query
        required: true
        schema:
          pattern: ^[A-Za-z0-9]{20}$
          title: Lei
          type: string
      tags:
      - Business Registry Data
components:
  schemas:
    LegalAddress:
      properties:
        address_lines:
          items:
            type: string
          type: array
          title: Address Lines
        city:
          anyOf:
          - type: string
          - type: 'null'
          title: City
        region:
          anyOf:
          - type: string
          - type: 'null'
          title: Region
        country:
          type: string
          title: Country
        postal_code:
          anyOf:
          - type: string
          - type: 'null'
          title: Postal Code
      type: object
      required:
      - address_lines
      - country
      title: LegalAddress
    BusinessSignal:
      properties:
        lei:
          type: string
          title: Lei
        signal:
          type: string
          enum:
          - positive
          - negative
          title: Signal
        lei_status:
          type: string
          title: Lei Status
        entity_status:
          type: string
          title: Entity Status
        legal_name:
          type: string
          title: Legal Name
        legal_address:
          $ref: '#/components/schemas/LegalAddress'
        jurisdiction:
          anyOf:
          - type: string
          - type: 'null'
          title: Jurisdiction
        registration_authority_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Registration Authority Id
        registration_authority_entity_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Registration Authority Entity Id
        last_update:
          type: string
          format: date-time
          title: Last Update
        next_renewal:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Next Renewal
        retrieved_at:
          type: string
          format: date-time
          title: Retrieved At
        observation_age_seconds:
          anyOf:
          - type: integer
          - type: 'null'
          title: Observation Age Seconds
        served_from:
          anyOf:
          - type: string
            enum:
            - owned_store
            - live_source
          - type: 'null'
          title: Served From
        source:
          type: string
          title: Source
          default: Global Legal Entity Identifier Foundation (GLEIF)
        source_url:
          type: string
          title: Source Url
        signal_basis:
          type: string
          title: Signal Basis
          default: The signal is positive only when the GLEIF entity status is ACTIVE and the LEI registration status is ISSUED.
        limit:
          type: string
          title: Limit
          default: This signal shows LEI record status. It does not prove current trading activity, solvency, or good standing in a national company register.
      type: object
      required:
      - lei
      - signal
      - lei_status
      - entity_status
      - legal_name
      - legal_address
      - last_update
      - retrieved_at
      - source_url
      title: BusinessSignal
x-service-info:
  categories:
  - data
  - business
  - identity
  - change-feed
  coverage: The store contains GLEIF observations for UK and EU legal entities with an LEI. History starts with the first collected observation for each LEI.
  limits:
  - No result is available for an entity without an LEI.
  - One observation cannot show a prior state or a last change.
  - An observed change time is not the exact source change time.
  docs:
    apiReference: /docs
    llms: /llms.txt