How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hevn Inc Banks API

The Banks API from Hevn Inc — 14 operation(s) for banks.

Hevn Inc Banks API is one of 31 APIs that Hevn publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Banks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 14 operations across 14 paths, and defines 31 schemas. It is described by OpenAPI 3.2.0, at version 0.1.2.

Requests are made against a single base URL, https://api.hevn.finance.

14 operations 14 paths 31 schemas 2 GET12 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.2
Base URL
https://api.hevn.finance/api/v1
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Hevn Inc Banks API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer). An API key is passed in the header as x-api-key (ApiKeyAuth).

  • ApiKeyAuth — Alternative HEVN API key header. The CLI defaults to Authorization Bearer unless configured with HEVNAPIKEYHEADER=X-Api-Key.

Paths & Operations 14

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

Banks 14
POST
/api/v1/bank/{rail}/pre-approve
Pre-approve a bank rail
pre_approve_bank_api_v1_bank__rail__pre_approve_post 2 params → 200422
POST
/api/v1/bank/{rail}/activate
Activate a bank rail
activate_bank_api_v1_bank__rail__activate_post 2 params → 200422
POST
/api/v1/banks/payin/quote
Get a pooled bank payin quote
create_bank_payin_quote_api_v1_banks_payin_quote_post 1 param body → 200422
POST
/api/v1/banks/payin/quote/submit
Submit a pooled bank payin quote
submit_bank_payin_quote_api_v1_banks_payin_quote_submit_post 1 param body → 200422
POST
/api/v1/banks/payin/quote/{quote_id}/cancel
Cancel a locally tracked bank payin quote
cancel_bank_payin_quote_api_v1_banks_payin_quote__quote_id__cancel_post 2 params → 200422
POST
/api/v1/banks/activate
Activate multiple bank rails
activate_banks_api_v1_banks_activate_post 1 param body → 200422
GET
/api/v1/banks
List all bank rails
list_banks_api_v1_banks_get 1 param → 200422
POST
/api/v1/accounts/bank/{rail}/pre-approve
Pre-approve a bank rail
pre_approve_bank_package_alias_api_v1_accounts_bank__rail__pre_approve_post 2 params → 200422
POST
/api/v1/accounts/bank/{rail}/activate
Activate a bank rail
activate_bank_package_alias_api_v1_accounts_bank__rail__activate_post 2 params → 200422
POST
/api/v1/accounts/banks/payin/quote
Get a pooled bank payin quote
create_bank_payin_quote_package_alias_api_v1_accounts_banks_payin_quote_post 1 param body → 200422
POST
/api/v1/accounts/banks/payin/quote/submit
Submit a pooled bank payin quote
submit_bank_payin_quote_package_alias_api_v1_accounts_banks_payin_quote_submit_post 1 param body → 200422
POST
/api/v1/accounts/banks/payin/quote/{quote_id}/cancel
Cancel a locally tracked bank payin quote
cancel_bank_payin_quote_package_alias_api_v1_accounts_banks_payin_quote__quote_id__cancel_post 2 params → 200422
POST
/api/v1/accounts/banks/activate
Activate multiple bank rails
activate_banks_package_alias_api_v1_accounts_banks_activate_post 1 param body → 200422
GET
/api/v1/accounts/banks
List all bank rails
list_banks_package_alias_api_v1_accounts_banks_get 1 param → 200422

Schemas 31

The contract defines 31 schemas that model the data the API accepts and returns. The most detailed are BankResponse (20 properties), IBANAccountDetails-Output (14 properties), USExternalAccountDetails-Output (13 properties), BankPayinQuoteResponse (13 properties). Each schema is shown below with its type and property counts.

USAccountDetails
object
US domestic account details (ACH).
2 properties 2 required
BankActivateRailsRequest
object
Bulk bank activation request.
1 property 1 required
IBANAccountDetails-Output
object
IBAN (SEPA) external account.
14 properties 4 required
KycStatus
string
KYC verification status.
USExternalAccountDetails-Output
object
US domestic (ACH) external account.
13 properties 4 required
app__schemas__base__ContactRelationship
string
Unified contact relationship / transfer purpose. Values match Align AlignTransferPurpose (the more granular set). Mapped to Swipelux AccountHolderRelationship…
BankPreApproveResponse
object
Read-only KYC info for a rail. Does not mutate Bank rows.
5 properties
BankPayinQuoteSubmitRequest
object
Submit a previously created Swipelux bank payin quote.
1 property 1 required
BankActivateRailResult
object
Per-rail bulk activation result.
4 properties 2 required
SwiftDetails
object
SWIFT (international wire) account details.
3 properties 2 required
BankRail
string
Bank account route: provider rail + bank id ({rail}-{bank}).
FiatProvider
string
Supported fiat payment providers.
BankPayinQuoteCancelResponse
object
Response after canceling a locally tracked bank payin quote.
3 properties 3 required
SwiftAccountDetails-Output
object
SWIFT (international wire) external account.
13 properties 4 required
BankResponse
object
Bank row as returned to clients. Merges static rail metadata (from BANKINFO) with per-user state. For rails the user hasn't activated yet, id / externalaccount…
20 properties 13 required
BankTimeToOpen
string
Expected wait time before a bank rail becomes usable.
ValidationError
object
3 properties 3 required
CountryCode
string
ISO 3166-1 alpha-2 country codes.
BankPayinQuoteResponse
object
Swipelux payin quote response normalized for bank payins.
13 properties 8 required
BankActivateRailsResponse
object
Bulk bank activation response.
1 property 1 required
AlignAccountHolderType
string
Account holder type.
BankRequestedRailSettings
object
User interest in a bank rail group.
2 properties
BanksListResponse
object
List bank rails plus user's requested rail preferences.
3 properties 2 required
IBANStatus
string
IBAN account status. State machine: notstarted → requested → documentrequested → approved → pending → active - notstarted — default for every rail until the us…
BankPayinQuoteSubmitResponse
object
Swipelux payin instructions returned after quote submit.
4 properties 1 required
BankRequestedRails
object
Rails the user is interested in opening.
4 properties
UserAddress
object
Address schema for user. Canonical field names: streetaddress, addressline2, city, state, country, zip. Accepts legacy Align/IBAN field names (streetline1, str…
6 properties
FiatPaymentType
string
Canonical fiat payment rail used for accounttype discrimination, bank-rail methods, and contact/transaction type alignment.
HTTPValidationError
object
1 property
BankPayinQuoteRequest
object
Request a Swipelux payin quote for a pooled bank rail.
3 properties 2 required
BankActivateRailError
object
Per-rail bulk activation error.
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hevn-inc-banks-api-openapi.yml Raw ↑

Other APIs Hevn publishes across the network.

Hevn Inc Activity API
Hevn Inc Apps API
Hevn Inc Apps Transfer API
Hevn Inc Auth API
Hevn Inc Balance API
Hevn Inc Cards API
Hevn Inc Chat API
Hevn Inc Contracts API
Hevn Inc Devices API
Hevn Inc Documents API
Hevn Inc Exports API
Hevn Inc Health API
Where this information came from

This is an independent, third-party profile of Hevn Inc Banks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.