krimskrams-xyz Signal API

openapi: 3.2.0
info:
  title: UK and EU Business Status Change Signal 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: Signal
paths:
  /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_v1_signal_get
      parameters:
      - name: lei
        in: query
        required: true
        schema:
          type: string
          pattern: ^[A-Za-z0-9]{20}$
          title: Lei
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessSignal'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required
        '404':
          description: GLEIF has no record for the LEI
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.040000'
        protocols:
        - x402: {}
      tags:
      - Signal
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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