EditalMD Auth API

The Auth API from EditalMD — 6 operation(s) for auth.

GitHub OpenAPI

Operations 6

1 of 6 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file

GET /api/auth/bootstrap Prepares the browser to sign in to the global account conformant #
POST /api/auth/logout Revokes this product session #
POST /api/auth/wallet/agent/start Starts the wallet credential of an agent without an account #
POST /api/auth/wallet/agent/token Gets the wallet credential (mmw_…) of this product #
POST /api/auth/claim/wallets Moves to the account what its wallets did without an account #
POST /api/auth/claim Moves to the account what the guest created: the Saved searches, Alerts and… #

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/editalmd:editalmd-auth-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

editalmd-auth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: EditalMD Auth API
  version: 1d751aaf
servers:
- url: https://editalmd.com
tags:
- name: Auth
paths:
  /api/auth/bootstrap:
    get:
      operationId: get_api_auth_bootstrap
      summary: Prepares the browser to sign in to the global account
      description: 'Sets an HttpOnly cookie restricted to the host. CSRF is bound to the current session. No CORS.

        Returns: { csrf, context }'
      responses:
        '200':
          description: '{ csrf, context }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  csrf:
                    type: string
                    description: X-CSRF-Token
                  context:
                    type: string
                    description: Opaque view context, also in X-MM-Context; not a credential.
                required:
                - csrf
                - context
        '400':
          description: invalid_request
        '403':
          description: invalid_origin / invalid_csrf
        '503':
          description: 'auth_unavailable: the previous session is preserved'
      security: []
      tags:
      - Auth
  /api/auth/logout:
    post:
      operationId: post_api_auth_logout
      summary: Revokes this product session
      description: 'Requires the bootstrap/CSRF of this browser and session. The sessions of other products stay active.

        Returns: { ok }'
      responses:
        '200':
          description: '{ ok }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    description: 'true'
                required:
                - ok
        '400':
          description: invalid_request
        '403':
          description: invalid_origin / invalid_csrf
        '503':
          description: 'auth_unavailable: the previous session is preserved'
      security:
      - globalAccount: []
      tags:
      - Auth
  /api/auth/wallet/agent/start:
    post:
      operationId: post_api_auth_wallet_agent_start
      summary: Starts the wallet credential of an agent without an account
      description: 'Without an account: the wallet proves ownership by signing the message (EIP-4361). Signing does not pay or transfer anything. The message names this product and is valid for 5 minutes. Sign with personal_sign and send it to /api/auth/wallet/agent/token.

        Returns: { message, issuedAt, expiresIn }'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                address:
                  type: string
                  description: 0x…, the wallet (an EOA or a contract on Base)
              required:
              - address
            example:
              address: '0x2c7536E3605D9C16a7a3D7b1898e529396a65c23'
      responses:
        '200':
          description: '{ message, issuedAt, expiresIn }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: EIP-4361
                  issuedAt:
                    type: number
                    description: segundos / seconds
                  expiresIn:
                    type: number
                    description: '300'
                required:
                - message
                - issuedAt
                - expiresIn
        '400':
          description: invalid_wallet_address
        '503':
          description: auth_unavailable
      security: []
      tags:
      - Auth
  /api/auth/wallet/agent/token:
    post:
      operationId: post_api_auth_wallet_agent_token
      summary: Gets the wallet credential (mmw_…) of this product
      description: 'The wallet signature of the start message, checked here (own key) or on Base (contract, EIP-1271/6492). The credential is valid for 30 days: send `Authorization: Bearer mmw_…` to the routes that accept the wallet as owner (owner `x402:`). When the wallet is linked to an account, what it did here moves to the account when the person signs in.

        Returns: { token, owner, expiresAt }'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                address:
                  type: string
                  description: 0x…, the same wallet as in start
                issuedAt:
                  type: number
                  description: the issuedAt of start
                signature:
                  type: string
                  description: personal_sign (0x…)
              required:
              - address
              - issuedAt
              - signature
            example:
              address: '0x2c7536E3605D9C16a7a3D7b1898e529396a65c23'
              issuedAt: 1791400000
              signature: 0x…
      responses:
        '200':
          description: '{ token, owner, expiresAt }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  token:
                    type: string
                    description: mmw_…
                  owner:
                    type: string
                    description: x402:0x…
                  expiresAt:
                    type: number
                    description: segundos / seconds
                required:
                - token
                - owner
                - expiresAt
        '400':
          description: invalid_body
        '401':
          description: invalid_wallet
        '429':
          description: wallet_limited
        '503':
          description: wallet_unavailable / auth_unavailable
      security: []
      tags:
      - Auth
  /api/auth/claim/wallets:
    post:
      operationId: post_api_auth_claim_wallets
      summary: Moves to the account what its wallets did without an account
      description: 'The sign-in window calls this after every sign-in. For each wallet linked to the account: the rights bought here through x402 (owner x402:) and what this product keeps for that owner. Repeating moves nothing.

        Returns: { carteiras, direitos }'
      responses:
        '200':
          description: '{ carteiras, direitos }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  carteiras:
                    type: number
                    description: wallets
                  direitos:
                    type: number
                    description: rights moved
                required:
                - carteiras
                - direitos
        '401':
          description: invalid_session
        '503':
          description: auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Auth
  /api/auth/claim:
    post:
      operationId: post_api_auth_claim
      summary: 'Moves to the account what the guest created: the Saved searches, Alerts and…'
      description: 'Requires the bootstrap/CSRF of this browser; the page does this right after sign-in. It moves only what the guest still has, in one transaction, and what conflicts with what the account already has stays with the guest. What the guest bought moves too. An old token without a signature that owns nothing here is refused. Repeating does no harm (it moves zero).

        Returns: { ok, claimed }'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                guest_token:
                  type: string
                  description: Convidado `edm_…` deste navegador.
              required:
              - guest_token
            example:
              guest_token: edm_…
      responses:
        '200':
          description: '{ ok, claimed }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    description: Whether the guest was recognized and let through.
                  claimed:
                    type: object
                    description: '`product.movidos` (lines that changed owner, per table), `product.apagados` (discarded guest duplicates) and `product.direitos` (purchases that moved).'
                required:
                - ok
                - claimed
        '400':
          description: invalid_product_claim / invalid_body
        '401':
          description: invalid_session
        '403':
          description: invalid_origin / invalid_csrf
        '409':
          description: unknown_guest (in `claimed.reason`)
        '503':
          description: product_claim_pending / auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Auth
components:
  securitySchemes:
    globalAccount:
      type: apiKey
      in: cookie
      name: __Host-mm-auth
      description: Global session in the product's HttpOnly cookie; writes require exact Origin and X-CSRF-Token.
    contaChaveApi:
      type: http
      scheme: bearer
      bearerFormat: mmk_…
      description: 'Account API key: `Authorization: Bearer mmk_…` or `X-Api-Key: mmk_…`. Created on the account page (API keys), valid only in the product where it was created; it acts as the account (or the organization that owns it).'
    carteiraAgente:
      type: http
      scheme: bearer
      bearerFormat: mmw_…
      description: 'Wallet credential of an agent without an account (`Authorization: Bearer mmw_…`, 30 days, this product only): POST /api/auth/wallet/agent/start, sign the message with the wallet, POST /api/auth/wallet/agent/token. The owner is `x402:<address>`.'
x-service-info:
  categories:
  - public-procurement
  - documents
  - data
  docs:
    homepage: https://editalmd.com/
    apiReference: https://editalmd.com/developers
    llms: https://editalmd.com/llms.txt