Token.io

Token.io Eidas API

The eidas API from Token.io — 5 operation(s) for eidas.

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /eidas/recovery/operations Recover an eIDAS-onboarded business member · Recover an eIDAS-verified member #
Ask an LLM
“Can I recover a business member that was originally onboarded with an eIDAS certificate?”
“What's needed to regain access to an eIDAS-registered member under a bank realm?”
Tell an agent
Recover the eIDAS member using signed payload {payload}.
Run eIDAS member recovery with payload {payload} and signature {signature}.
PUT /eidas/register Create and register a business member with eIDAS · Create and register a business member with an eIDAS certificate #
Ask an LLM
“How do I onboard a new business member using an eIDAS certificate?”
“Is eIDAS registration handled asynchronously?”
Tell an agent
Register a new business member with eIDAS payload {payload}.
Create an eIDAS-registered member from payload {payload} signed with {signature}.
GET /eidas/status Check the status of my eIDAS certificate · Get a status of the current eIDAS certificate #
Ask an LLM
“Is the eIDAS certificate on file for my member still valid?”
“Can I retrieve the certificate itself along with its status?”
Tell an agent
Get the status of my current eIDAS certificate.
Show the eIDAS certificate on file and its status.
POST /eidas/verifications Submit an eIDAS certificate for verification · Submit an eIDAS certificate for verification #
Ask an LLM
“Can I submit an eIDAS certificate to verify a business member under a bank realm?”
“What does an eIDAS verification request need?”
Tell an agent
Submit eIDAS certificate payload {payload} for verification.
Verify eIDAS payload {payload} with signature {signature}.
GET /eidas/verifications/{verificationId} Check the outcome of an eIDAS verification · Get a status of an eIDAS verification #
Ask an LLM
“Did my eIDAS verification succeed?”
“Can I see the submitted certificate and alias for a verification id?”
Tell an agent
Get the status of eIDAS verification {verification_id}.
Check whether eIDAS verification {verification_id} passed.

Documentation

📖
Documentation
https://docs.token.io/products/tpp/api/reference
📖
Documentation
https://docs.token.io/api-definitions/openapi/external/bnpp-refunds
📖
Documentation
https://docs.token.io/api-definitions/openapi/external/token-bank-integration

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/openapi/token-io-eidas-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-io-token-proto-gateway-get-eidas-verification-status-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-io-token-proto-gateway-verify-eidas-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-io-token-proto-gateway-register-with-eidas-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-io-token-proto-gateway-get-eidas-certificate-status-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-io-token-proto-gateway-recover-eidas-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-io-token-proto-gateway-verify-eidas-request-schema.json

Other Resources

🔗
OpenAPISource
https://api.token.io/swagger.json
🔗
Reference
https://reference.token.io/

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/token-io:token-io-eidas-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

token-io-eidas-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Token Eidas API
  version: 1.0.0
  description: Token REST API.
servers:
- url: https://api.token.io/v1
tags:
- name: eidas
paths:
  /eidas/recovery/operations:
    post:
      operationId: GatewayService.RecoverEidasMember
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/io.token.proto.gateway.RecoverEidasResponse'
      tags:
      - eidas
      summary: Recover an eIDAS-verified member
      description: 'Recover a business member that was onboarded with an eIDAS certificate under a realm of a bank.**See also:**

        RecoverEidasMember

        Certificate and payload signature format'
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/io.token.proto.gateway.RecoverEidasRequest'
        required: true
  /eidas/register:
    put:
      operationId: GatewayService.RegisterWithEidas
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/io.token.proto.gateway.RegisterWithEidasResponse'
      tags:
      - eidas
      summary: Create and register a business member with an eIDAS certificate
      description: 'Create and asynchronously onboard a business member under realm of a bank.

        **See also:**

        RegisterWithEidas

        Certificate and payload signature format'
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/io.token.proto.gateway.RegisterWithEidasRequest'
        required: true
  /eidas/status:
    get:
      operationId: GatewayService.getEidasCertificateStatus
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/io.token.proto.gateway.GetEidasCertificateStatusResponse'
      tags:
      - eidas
      summary: Get a status of the current eIDAS certificate
      description: 'Get a status of an eIDAS certificate on file together with the certificate itself.**See also:**

        GetEidasCertificateStatus'
      deprecated: false
  /eidas/verifications:
    post:
      operationId: GatewayService.VerifyEidas
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/io.token.proto.gateway.VerifyEidasResponse'
      tags:
      - eidas
      summary: Submit an eIDAS certificate for verification
      description: 'Submit an eIDAS certificate for a business member registered under the realm of a bank.

        **See also:**

        VerifyEidas

        Certificate and payload signature format'
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/io.token.proto.gateway.VerifyEidasRequest'
        required: true
  /eidas/verifications/{verificationId}:
    get:
      operationId: GatewayService.GetEidasVerificationStatus
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/io.token.proto.gateway.GetEidasVerificationStatusResponse'
      parameters:
      - name: verificationId
        in: path
        required: true
        schema:
          type: string
      tags:
      - eidas
      summary: Get a status of an eIDAS verification
      description: 'Given a verificationId, get a status of the eIDAS verification together with submitted certificate and alias value.

        **See also:**

        GetEidasVerificationStatus'
      deprecated: false
components:
  schemas:
    io.token.proto.common.eidas.RegisterWithEidasPayload:
      type: object
      properties:
        bankId:
          type: string
        certificate:
          type: string
    io.token.proto.gateway.RegisterWithEidasResponse:
      type: object
      properties:
        keyId:
          type: string
        memberId:
          type: string
        verificationId:
          type: string
    io.token.proto.common.eidas.EidasCertificateStatus:
      enum:
      - INVALID_CERTIFICATE_STATUS
      - CERTIFICATE_VALID
      - CERTIFICATE_INVALID
      - CERTIFICATE_NOT_FOUND
      default: INVALID_CERTIFICATE_STATUS
      type: string
    io.token.proto.gateway.GetEidasVerificationStatusResponse:
      type: object
      properties:
        aliasValue:
          type: string
        certificate:
          type: string
        eidasStatus:
          $ref: '#/components/schemas/io.token.proto.common.eidas.EidasVerificationStatus'
        statusDetails:
          type: string
    io.token.proto.gateway.GetEidasCertificateStatusResponse:
      type: object
      properties:
        certificate:
          type: string
        status:
          $ref: '#/components/schemas/io.token.proto.common.eidas.EidasCertificateStatus'
    io.token.proto.common.security.Key:
      type: object
      properties:
        algorithm:
          $ref: '#/components/schemas/io.token.proto.common.security.Key.Algorithm'
        expiresAtMs:
          format: string
          type: string
        id:
          type: string
        level:
          $ref: '#/components/schemas/io.token.proto.common.security.Key.Level'
        publicKey:
          type: string
    io.token.proto.gateway.VerifyEidasResponse:
      type: object
      properties:
        eidasStatus:
          $ref: '#/components/schemas/io.token.proto.common.eidas.EidasVerificationStatus'
        statusDetails:
          type: string
        verificationId:
          type: string
    io.token.proto.common.eidas.VerifyEidasPayload:
      type: object
      properties:
        algorithm:
          $ref: '#/components/schemas/io.token.proto.common.security.Key.Algorithm'
        alias:
          $ref: '#/components/schemas/io.token.proto.common.alias.Alias'
        certificate:
          type: string
        memberId:
          type: string
    io.token.proto.gateway.RegisterWithEidasRequest:
      type: object
      properties:
        payload:
          $ref: '#/components/schemas/io.token.proto.common.eidas.RegisterWithEidasPayload'
        signature:
          type: string
    io.token.proto.common.alias.Alias:
      type: object
      properties:
        realm:
          type: string
        realmId:
          type: string
        type:
          $ref: '#/components/schemas/io.token.proto.common.alias.Alias.Type'
        value:
          type: string
    io.token.proto.common.security.Signature:
      type: object
      properties:
        keyId:
          type: string
        memberId:
          type: string
        signature:
          type: string
    io.token.proto.common.alias.Alias.Type:
      enum:
      - INVALID
      - UNKNOWN
      - EMAIL
      - PHONE
      - DOMAIN
      - USERNAME
      - BANK
      - CUSTOM
      - EIDAS
      default: INVALID
      type: string
    io.token.proto.gateway.RecoverEidasResponse:
      type: object
      properties:
        recoveryEntry:
          $ref: '#/components/schemas/io.token.proto.common.member.MemberRecoveryOperation'
    io.token.proto.common.member.MemberRecoveryOperation.Authorization:
      type: object
      properties:
        memberId:
          type: string
        memberKey:
          $ref: '#/components/schemas/io.token.proto.common.security.Key'
        prevHash:
          type: string
    io.token.proto.common.eidas.EidasVerificationStatus:
      enum:
      - INVALID_EIDAS_STATUS
      - EIDAS_STATUS_SUCCESS
      - EIDAS_STATUS_FAILURE
      - EIDAS_STATUS_ERROR
      - EIDAS_STATUS_PENDING
      default: INVALID_EIDAS_STATUS
      type: string
    io.token.proto.common.security.Key.Level:
      enum:
      - INVALID_LEVEL
      - PRIVILEGED
      - STANDARD
      - LOW
      default: INVALID_LEVEL
      type: string
    io.token.proto.gateway.RecoverEidasRequest:
      type: object
      properties:
        payload:
          $ref: '#/components/schemas/io.token.proto.common.eidas.EidasRecoveryPayload'
        signature:
          type: string
    io.token.proto.gateway.VerifyEidasRequest:
      type: object
      properties:
        payload:
          $ref: '#/components/schemas/io.token.proto.common.eidas.VerifyEidasPayload'
        signature:
          type: string
    io.token.proto.common.eidas.EidasRecoveryPayload:
      type: object
      properties:
        algorithm:
          $ref: '#/components/schemas/io.token.proto.common.security.Key.Algorithm'
        certificate:
          type: string
        key:
          $ref: '#/components/schemas/io.token.proto.common.security.Key'
        memberId:
          type: string
    io.token.proto.common.security.Key.Algorithm:
      enum:
      - INVALID_ALGORITHM
      - ED25519
      - ECDSA_SHA256
      - RS256
      - RS512
      default: INVALID_ALGORITHM
      type: string
    io.token.proto.common.member.MemberRecoveryOperation:
      type: object
      properties:
        agentSignature:
          $ref: '#/components/schemas/io.token.proto.common.security.Signature'
        authorization:
          $ref: '#/components/schemas/io.token.proto.common.member.MemberRecoveryOperation.Authorization'