openapi: 3.0.0
info:
  title: AcquireEU Enterprise API
  description: Secure API for retrieving normalized, T+1 European insolvency and restructuring filings.
  version: "1.0.0"
servers:
  - url: https://acquireeu.com/api/v1
    description: Production Server
  - url: http://localhost:3000/api/v1
    description: Local Development
paths:
  /insolvencies:
    get:
      summary: Get recent insolvency filings
      description: Returns a list of the most recent insolvency, restructuring, and liquidation filings across 20+ covered European jurisdictions.
      security:
        - BearerAuth: []
      parameters:
        - in: query
          name: country
          schema:
            type: string
          description: Two-letter ISO country code (e.g., UK, FR, DE)
        - in: query
          name: limit
          schema:
            type: integer
            maximum: 1000
            default: 50
          description: Number of records to return per request (pagination)
        - in: query
          name: date_from
          schema:
            type: string
            format: date
          description: Filter for records filed on or after this date (YYYY-MM-DD)
      responses:
        '200':
          description: A JSON array of insolvency records
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique record identifier
                        name:
                          type: string
                          description: Legal entity name
                        country:
                          type: string
                          description: ISO 2-letter country code
                        stage:
                          type: string
                          description: Classification of insolvency event (e.g., Liquidation, Administration)
                        filed_date:
                          type: string
                          description: Date the event was published by the local registry
                        registrationId:
                          type: string
                          description: National company registration number (e.g., UK Company Number, SIREN)
                        sector:
                          type: string
                          description: Extracted industry sector
                  meta:
                    type: object
                    properties:
                      count:
                        type: integer
                      limit:
                        type: integer
                      timestamp:
                        type: string
                        format: date-time
        '401':
          description: Unauthorized - Invalid or missing API Key
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer