Maesn

Maesn Auth API

The auth API from Maesn — 4 operation(s) for auth.

GitHub OpenAPI

Operations 5

GET /auth/{TARGET_SYSTEM} System login url #
POST /auth/{TARGET_SYSTEM} System login url #
POST /auth/accounts/{TARGET_SYSTEM} Create end user account #
GET /auth/environments Get environments #
GET /auth/companies Get companies #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/maesn/refs/heads/main/openapi/maesn-auth-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/maesn/refs/heads/main/json-schema/maesn-vendor-credit-response-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/maesn/refs/heads/main/json-schema/maesn-bill-response-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/maesn/refs/heads/main/json-schema/maesn-invoice-response-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/maesn/refs/heads/main/json-schema/maesn-create-vendor-credit-request-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/maesn/refs/heads/main/json-schema/maesn-update-bill-request-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/maesn/refs/heads/main/json-schema/maesn-create-bill-request-dto-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/maesn:maesn-auth-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

maesn-auth-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Maesn unified Auth API
  description: The Maesn unified API description
  version: '1.0'
  contact: {}
servers:
- url: https://api.maesn.dev
tags:
- name: Auth
paths:
  /auth/{TARGET_SYSTEM}:
    get:
      operationId: systemLoginUrl
      parameters:
      - name: TARGET_SYSTEM
        required: true
        in: path
        schema:
          type: string
      - name: X-API-KEY
        description: API key
        in: header
        schema:
          type: string
        required: true
      - name: callbackUrl
        required: false
        in: query
        schema:
          type: string
      - name: cancelCallbackUrl
        required: false
        in: query
        schema:
          type: string
      - name: companyId
        required: false
        in: query
        schema:
          type: string
      - name: tenantId
        required: false
        in: query
        schema:
          type: string
      - name: environmentSelection
        required: false
        in: query
        schema:
          type: boolean
      - name: include_signature
        required: false
        in: query
        schema:
          type: boolean
      - name: locale
        description: BCP-47 language tag (for example de or de-DE) the authentication pages should be shown in. Falls back to the texts configured without a locale. The locale travels with the flow, so the company selection page is shown in the same language.
        required: false
        in: query
        schema:
          type: string
          example: de
      responses:
        '200':
          description: Successful response
          content:
            text/html:
              schema:
                type: string
                example: https://login-url.com
      tags:
      - Auth
      summary: System login url
      x-summary-source: derived
    post:
      operationId: postAuthByTARGETSYSTEM
      parameters:
      - name: TARGET_SYSTEM
        required: true
        in: path
        schema:
          type: string
      - name: X-API-KEY
        description: API key
        in: header
        schema:
          type: string
        required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAuthRequestDto'
      responses:
        '201':
          description: Successful response
          content:
            text/html:
              schema:
                type: string
                example: https://login-url.com
      tags:
      - Auth
      summary: System login url
      x-summary-source: derived
      x-operation-id-source: normalized
      x-operation-id-original: systemLoginUrl
  /auth/accounts/{TARGET_SYSTEM}:
    post:
      operationId: createEndUserAccount
      parameters:
      - name: TARGET_SYSTEM
        required: true
        in: path
        schema:
          type: string
      - name: X-API-KEY
        description: API key
        in: header
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEndUserRequestDto'
      responses:
        '201':
          description: ''
      tags:
      - Auth
      summary: Create end user account
      x-summary-source: derived
  /auth/environments:
    get:
      operationId: getEnvironments
      parameters:
      - name: X-API-KEY
        description: API key
        in: header
        schema:
          type: string
        required: true
      - name: X-ACCOUNT-KEY
        description: Account key
        in: header
        schema:
          type: string
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/BaseResponseDto'
                - properties:
                    data:
                      type: object
                      $ref: '#/components/schemas/EnvironmentResponseDto'
      tags:
      - Auth
      summary: Get environments
      x-summary-source: derived
  /auth/companies:
    get:
      operationId: getCompanies
      parameters:
      - name: environmentName
        in: query
        schema:
          type: string
        required: false
      - name: X-API-KEY
        description: API key
        in: header
        schema:
          type: string
        required: true
      - name: X-ACCOUNT-KEY
        description: Account key
        in: header
        schema:
          type: string
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/BaseResponseDto'
                - properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/CompanyResponseDto'
      tags:
      - Auth
      summary: Get companies
      x-summary-source: derived
components:
  schemas:
    BaseResponseDto:
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/MetaResponse'
        data:
          oneOf:
          - type: object
          - type: array
    SubscriptionDto:
      type: object
      properties:
        id:
          type: string
          example: ACCOUNTING
        active:
          type: boolean
          example: true
        name:
          type: string
          example: Accounting
        status:
          type: string
          example: paying
    EnvironmentResponseDto:
      type: object
      properties:
        applicationFamily:
          type: string
          example: BusinessCentral
        countryCode:
          type: string
          example: DE
        name:
          type: string
          example: string
        tenantId:
          type: string
          example: string
        type:
          type: string
          example: Production
    PaginationResponse:
      type: object
      properties:
        total:
          type: number
          example: 125
        perPage:
          type: number
          example: 50
        currentPage:
          type: number
          example: 1
        totalPages:
          type: number
          example: 3
    PostAuthRequestDto:
      type: object
      properties:
        baseUrl:
          type: string
          example: https://entity-api1-4.abacus.ch
        callBackUrl:
          type: string
          example: https://your-app.com/callback
        cancelCallbackUrl:
          type: string
          example: https://your-app.com/cancel
        includeSignature:
          type: boolean
          example: false
        tenantId:
          type: string
          example: tenant_abc123
        webhookCallbackUrl:
          type: string
          example: https://your-app.com/webhooks/account-key
        locale:
          type: string
          description: BCP-47 language tag (for example de or de-DE) the authentication pages should be shown in. Falls back to the texts configured without a locale.
          example: de
      required:
      - webhookCallbackUrl
    CreateEndUserRequestDto:
      type: object
      properties:
        apiKey:
          type: string
          example: api key
        baseUrl:
          type: string
          example: https://entity-api1-4.demo.abacus.ch
        clientName:
          type: string
          example: client name
        clientSecret:
          type: string
          example: client secret
        mandant:
          type: string
          example: '7777'
        password:
          type: string
          example: ServiceUserPassword123
        tenantId:
          type: string
          example: tenant id
        username:
          type: string
          example: Rob_Smith
    MetaResponse:
      type: object
      properties:
        warnings:
          type: array
          items:
            type: string
            example: Field not used by target system
        pagination:
          $ref: '#/components/schemas/PaginationResponse'
    CompanyResponseDto:
      type: object
      properties:
        id:
          type: string
          example: string
        client_number:
          type: number
          example: '1'
        consultant_number:
          type: number
          example: '223344'
        environmentId:
          type: string
          example: string
        name:
          type: string
          example: string
        subscription:
          type: array
          items:
            $ref: '#/components/schemas/SubscriptionDto'