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 User API

The User API from Hevn Inc — 21 operation(s) for user.

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

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

This API exposes 23 operations across 21 paths, and defines 69 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.

23 operations 21 paths 69 schemas 1 DELETE10 GET1 PATCH8 POST3 PUT

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 User 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 23

Across 21 paths, the API surfaces 23 operations — 1 DELETE, 10 GET, 1 PATCH, 8 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

User 23
PUT
/api/v1/user/kyc
Create or get current user
update_user_kyc_data_api_v1_user_kyc_put body → 201422
GET
/api/v1/user
Get current user
get_current_user_api_v1_user_get 4 params → 200422
POST
/api/v1/user/kyc_link
Submit KYC data
submit_kyc_api_v1_user_kyc_link_post 1 param → 200422
GET
/api/v1/user/kyc/status
Get KYC status
get_kyc_status_api_v1_user_kyc_status_get 2 params → 200422
GET
/api/v1/user/geo
Geocode address
geocode_address_api_v1_user_geo_get 1 param → 200422
POST
/api/v1/user/event
Track user event
track_user_event_api_v1_user_event_post 1 param body → 200422
GET
/api/v1/user/settings
Get user settings
get_user_settings_api_v1_user_settings_get 1 param → 200422
PUT
/api/v1/user/settings
Update user settings
update_settings_api_v1_user_settings_put 1 param body → 200422
PUT
/api/v1/user/bank_requested
Update requested bank rails
update_bank_requested_api_v1_user_bank_requested_put 1 param body → 200422
GET
/api/v1/user/notifications
Get recent notifications
get_notifications_api_v1_user_notifications_get 3 params → 200422
POST
/api/v1/user/avatar
Upload user avatar
upload_avatar_api_v1_user_avatar_post 1 param body → 200422
POST
/api/v1/user/share_kyb_link
Share KYB link
share_kyb_link_api_v1_user_share_kyb_link_post 1 param body → 200422
POST
/api/v1/user/invite
Send invite
send_legacy_user_invite_api_v1_user_invite_post 1 param body → 200422
POST
/api/v1/user/contact/bank/validate
Prevalidate bank contact details
validate_bank_contact_api_v1_user_contact_bank_validate_post body → 200422
GET
/api/v1/user/contacts
Get user contacts
get_contacts_api_v1_user_contacts_get 3 params → 200422
GET
/api/v1/user/contact/preview
Preview contact by wallet or email
preview_contact_api_v1_user_contact_preview_get 3 params → 200422
POST
/api/v1/user/contact
Create contact
create_contact_api_v1_user_contact_post 1 param body → 201422
PATCH
/api/v1/user/contacts/{contact_id}
Update contact name
update_contact_api_v1_user_contacts__contact_id__patch 2 params body → 200422
DELETE
/api/v1/user/contacts/{contact_id}
Delete contact
delete_contact_api_v1_user_contacts__contact_id__delete 2 params → 204422
GET
/api/v1/user/invite_code
Get invite code for current user
get_invite_code_api_v1_user_invite_code_get 1 param → 200422
GET
/api/v1/user/invited
Get users invited by current user
get_invited_users_api_v1_user_invited_get 1 param → 200422
GET
/api/v1/user/rewards
Get referral rewards earned by current user
get_rewards_api_v1_user_rewards_get 3 params → 200422
POST
/api/v1/kyb/user/share_kyb_link
Share KYB link
share_kyb_link_package_alias_api_v1_kyb_user_share_kyb_link_post 1 param body → 200422

Schemas 69

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

USAccountDetails
object
US domestic account details (ACH).
2 properties 2 required
FiatRailResponse
object
Response schema for a user's fiat rail registration.
4 properties 1 required
ContactCryptoResponse
object
Crypto payment details for contact.
3 properties 1 required
EmailAccountInput
object
Email contact input.
2 properties 1 required
ContactResponse
object
Contact response with full structure for transfer.
10 properties 4 required
InviteFlow
string
Invite flow types.
InvitedListResponse
object
List of invited users.
2 properties 2 required
AvatarUploadResponse
object
Response schema for avatar upload.
1 property 1 required
InviteBonuses
object
Bonus configuration for the referral program.
2 properties 2 required
BankRequestedSettings-Output
object
User bank-rail interest settings.
1 property
NotificationsSettings
object
User notification preferences grouped by category. Categories are UI groupings over NotificationType. Mapping lives in NOTIFICATIONTYPECATEGORY. Defaults to al…
9 properties
IBANAccountDetails-Output
object
IBAN (SEPA) external account.
14 properties 4 required
OnchainAccountInput
object
Onchain wallet contact input.
5 properties 3 required
KycStatus
string
KYC verification status.
RewardsListResponse
object
List of referral rewards earned by the current user.
3 properties 2 required
TransactionType
string
Transaction type - payment rail. Includes all FiatPaymentType values (sepa/swift/ach/uaefts) plus extended fiat variants (wire/swift-usd/swift-eur/fedwire/pix)…
IBANAccountDetails-Input
object
IBAN (SEPA) external account.
13 properties 3 required
USExternalAccountDetails-Output
object
US domestic (ACH) external account.
13 properties 4 required
AchAccountInput
object
ACH bank contact input.
11 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…
UserSettings-Input
object
User settings.
5 properties
NotificationChannelPrefs
object
Per-channel toggles for a single notification category.
2 properties
RewardItem
object
A single referral reward earned by the current user.
7 properties 6 required
InvitedStatus
string
Status of an invited user along the KYB funnel.
KycStatusResponse
object
Response schema for KYC status check.
11 properties 3 required
ContactLinkedUserResponse
object
Linked HEVN user preview for contact.
2 properties
app__schemas__routers__user__contact__ContactRelationship
string
Relationship between the current user and the contact.
SwiftDetails
object
SWIFT (international wire) account details.
3 properties 2 required
AvatarUploadRequest
object
Request schema for uploading user avatar.
1 property 1 required
UserCreateRequest
object
Request schema for creating a user.
13 properties
FiatProvider
string
Supported fiat payment providers.
BankValidationRequest
object
Request to prevalidate bank details before creating a contact.
6 properties 1 required
USExternalAccountDetails-Input
object
US domestic (ACH) external account.
12 properties 3 required
ShareKybLinkRequest
object
Request schema for sharing a KYB link via email.
1 property 1 required
BankRequestedSettings-Input
object
User bank-rail interest settings.
1 property
BankValidationResponse
object
Result of bank detail validation.
4 properties 1 required
AppearancePreference
string
Appearance theme preference.
UaeAccountInput
object
UAE FTS bank contact input.
11 properties 3 required
SwiftAccountDetails-Output
object
SWIFT (international wire) external account.
13 properties 4 required
ContactListResponse
object
List of contacts response.
2 properties 2 required
NotificationListResponse
object
List of notifications response.
2 properties 2 required
ValidationError
object
3 properties 3 required
CountryCode
string
ISO 3166-1 alpha-2 country codes.
UserSettings-Output
object
User settings.
5 properties
UserEventRequest
object
Request schema for tracking user events.
2 properties 1 required
ContactCreateRequest
object
Request to create a contact.
8 properties
NotificationType
string
Notification type — matches the kind of event being notified.
InviteVolumeBonus
object
Volume-based bonus tier with a threshold.
3 properties 2 required
ContactPreviewResponse
object
Lightweight user preview for contact lookup.
4 properties 1 required
AlignAccountHolderType
string
Account holder type.
BankRequestedRailSettings
object
User interest in a bank rail group.
2 properties
OneClickChain
string
1click chain codes.
NotificationChannel
string
Notification delivery channel.
SwiftAccountDetails-Input
object
SWIFT (international wire) external account.
12 properties 3 required
RewardType
string
Referral reward type.
ContactUpdateRequest
object
Request to update a contact.
8 properties
InviteBonus
object
A single referral bonus tier.
2 properties 1 required
BankRequestedRails
object
Rails the user is interested in opening.
4 properties
SwiftAccountInput
object
SWIFT bank contact input.
13 properties 5 required
UserResponse
object
Schema for user response.
22 properties 6 required
ContactCryptoInput
object
Crypto contact input.
3 properties 3 required
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
InvitedUserResponse
object
A single invited user.
8 properties 4 required
ReferrerInfo
object
Lightweight info about the user who referred this user.
3 properties 2 required
InviteCodeResponse
object
Response for invite code.
3 properties 1 required
NotificationResponse
object
Single notification response.
8 properties 5 required
HTTPValidationError
object
1 property
SepaAccountInput
object
SEPA bank contact input.
11 properties 4 required
InviteRequest
object
Request schema for sending an invite.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hevn-inc-user-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 Banks 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
Where this information came from

This is an independent, third-party profile of Hevn Inc User 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.