krimskrams-xyz Business Registry Changes API

openapi: 3.2.0
info:
  title: UK and EU Business Status Change Business Registry Changes…
  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 Changes
paths:
  /mpp/v1/changes:
    get:
      summary: Get observed entity and LEI status changes
      description: '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.'
      operationId: changes_mpp_mpp_v1_changes_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityChanges'
        '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 Changes
components:
  schemas:
    ChangedFields:
      properties:
        entity_status:
          anyOf:
          - $ref: '#/components/schemas/ChangeValue'
          - type: 'null'
        lei_status:
          anyOf:
          - $ref: '#/components/schemas/ChangeValue'
          - type: 'null'
      type: object
      title: ChangedFields
    EntityChanges:
      properties:
        lei:
          type: string
          title: Lei
        observation_count:
          type: integer
          title: Observation Count
        history_start:
          type: string
          format: date-time
          title: History Start
        history_message:
          type: string
          title: History Message
        served_from:
          type: string
          enum:
          - owned_store
          - live_source
          title: Served From
        current:
          $ref: '#/components/schemas/CurrentStatus'
        last_change:
          anyOf:
          - $ref: '#/components/schemas/StatusChange'
          - type: 'null'
        changes:
          items:
            $ref: '#/components/schemas/StatusChange'
          type: array
          title: Changes
      type: object
      required:
      - lei
      - observation_count
      - history_start
      - history_message
      - served_from
      - current
      - last_change
      - changes
      title: EntityChanges
      description: Observed changes to the GLEIF entity and LEI states.
    ChangeValue:
      properties:
        previous:
          type: string
          title: Previous
        current:
          type: string
          title: Current
      type: object
      required:
      - previous
      - current
      title: ChangeValue
    CurrentStatus:
      properties:
        entity_status:
          type: string
          title: Entity Status
        lei_status:
          type: string
          title: Lei Status
        observed_at:
          type: string
          format: date-time
          title: Observed At
        observation_age_seconds:
          type: integer
          title: Observation Age Seconds
        source_last_update:
          type: string
          format: date-time
          title: Source Last Update
        source_url:
          type: string
          title: Source Url
      type: object
      required:
      - entity_status
      - lei_status
      - observed_at
      - observation_age_seconds
      - source_last_update
      - source_url
      title: CurrentStatus
    StatusChange:
      properties:
        change_observed_at:
          type: string
          format: date-time
          title: Change Observed At
        previous_observed_at:
          type: string
          format: date-time
          title: Previous Observed At
        source_last_update:
          type: string
          format: date-time
          title: Source Last Update
        fields:
          $ref: '#/components/schemas/ChangedFields'
        source_url:
          type: string
          title: Source Url
      type: object
      required:
      - change_observed_at
      - previous_observed_at
      - source_last_update
      - fields
      - source_url
      title: StatusChange
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