openapi: 3.0.3
info:
  title: Formance Stack API
  description: |
    Open, modular foundation for unique payments flows

    # Introduction
    This API is documented in **OpenAPI format**.

    # Authentication
    Formance Stack offers one forms of authentication:
      - OAuth2
    OAuth2 - an open protocol to allow secure authorization in a simple
    and standard method from web, mobile and desktop applications.
    <SecurityDefinitions />
  contact:
    name: Formance
    url: https://www.formance.com
    email: support@formance.com
  x-logo:
    url: https://avatars.githubusercontent.com/u/84325077?s=200&v=4
    altText: Formance
  version: "SDK_VERSION"

servers:
- url: http://localhost
  description: local server

security:
  - Authorization: []

components:
  securitySchemes:
    Authorization:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: '/api/auth/oauth/token'
          refreshUrl: '/api/auth/oauth/token'
          scopes: {}

  schemas:
    Version:
      type: object
      properties:
        name:
          type: string
        version:
          type: string
        health:
          type: boolean
      required:
      - name
      - version
      - health
    GetVersionsResponse:
      type: object
      properties:
        region:
          type: string
        env:
          type: string
        versions:
          type: array
          items:
            $ref: '#/components/schemas/Version'
      required:
      - region
      - env
      - versions

x-tagGroups:
  - name: Auth
    tags:
      - auth.v1
  - name: Ledger
    tags:
      - ledger.v1
      - ledger.v2
  - name: Payments
    tags:
      - payments.v1
  - name: Search
    tags:
      - search.v1
  - name: Wallets
    tags:
      - wallets.v1
  - name: Webhooks
    tags:
      - webhooks.v1
  - name: Flows
    tags:
      - orchestration.v1
      - orchestration.v2
  - name: Reconciliation
    tags:
      - reconciliation.v1

paths:
  /versions:
    get:
      summary: Show stack version information
      operationId: getVersions
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVersionsResponse'