Serbia Company Data Search API

openapi: 3.2.0
info:
  title: Serbia Company Data Search API
  version: 0.1.0
  description: Normalized Serbian company registry and latest financial-statement summaries from official APR high-value open data.
  license:
    name: Serbian Open Data License 1.0
    identifier: SODL-1.0
    url: https://data.gov.rs/sr/terms/
  contact:
    url: https://serbia-company-x402.vercel.app
  x-guidance: Use exact lookup when you have an 8-digit Serbian registration number. Use name search for discovery, including Serbian Latin or Cyrillic. All monetary fields use thousand_RSD.
servers:
- url: https://serbia-company-x402.vercel.app
tags:
- name: Search
paths:
  /api/search:
    get:
      operationId: searchSerbianCompanies
      summary: Search Serbian companies by registered business name
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 3
          maxLength: 100
        example: Air Serbia
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 10
          default: 5
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Ranked official company matches
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        registrationNumber:
                          type: string
                          pattern: ^\d{8}$
                        businessName:
                          type:
                          - string
                          - 'null'
                        status:
                          type:
                          - string
                          - 'null'
                        incorporationDate:
                          type:
                          - string
                          - 'null'
                          format: date
                        legalForm:
                          type:
                          - string
                          - 'null'
                        activityCode:
                          type:
                          - string
                          - number
                          - 'null'
                        latestFinancialStatement:
                          type:
                          - object
                          - 'null'
                          description: Latest public APR summary. Monetary values are in thousands of Serbian dinars (RSD).
        '402':
          description: Payment Required
      tags:
      - Search