Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Holvi Consent API

PSU authentication and consent token exchange.

Holvi Consent API is one of 4 APIs that Holvi publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Consent. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 2 operations across 2 paths, and defines 1 schema. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against a single base URL, https://api.psd2.holvi.com.

2 operations 2 paths 1 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://api.psd2.holvi.com
Authentication
API Key, API Key, API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 4

Holvi Consent API declares 4 security schemes for authenticating requests. An API key is passed in the header as X-Holvi-Client-Id (HolviClientId). An API key is passed in the header as X-Holvi-Client-Secret (HolviClientSecret). An API key is passed in the header as Signature (HolviSignatureHeader). It accepts HTTP bearer tokens (JWT) (HolviBearer). By default, every request must be authenticated.

  • HolviClientId — Client ID identifying the TPP application (from approved onboarding).
  • HolviClientSecret — Client Secret authenticating the TPP (from approved onboarding).
  • HolviSignatureHeader — Application-level HTTP message signature (Draft Cavage HTTP Signatures v10, RSA-SHA256, key = 2048-bit) over (request-target), Host, Date [, Content-Type, Dige…
  • HolviBearer — PSU consent JWT access token from the consent token exchange.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Consent 2

PSU authentication and consent token exchange.

POST
/api/v2/consent/initiate/usernamepassword/
Initiate a user consent access token
initiateConsentUsernamePassword → 200401
GET
/api/v2/consent/token/{code}/exchange/
Exchange an authorization code for a JWT token
exchangeConsentToken 1 param → 200401404

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is ConsentTokenResponse (3 properties). Each schema is shown below with its type and property counts.

ConsentTokenResponse
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

holvi-consent-api-openapi.yml Raw ↑

Other APIs Holvi publishes across the network.

Holvi Account Information API
Holvi Payment Initiation API
Holvi Third Party Provider API