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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/hevn-inc:hevn-inc-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
openapi: 3.2.0
info:
title: HEVN Auth API
description: Backend API for HEVN mobile neobank
version: 0.1.2
servers:
- url: https://api.hevn.finance
description: Production
tags:
- name: Auth
paths:
/api/v1/auth/start:
post:
tags:
- Auth
summary: Auth Start
description: 'Start authentication: verify TEE signature, then send OTP to email.'
operationId: auth_start_api_v1_auth_start_post
parameters:
- name: device-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Device-Id
- name: user-agent
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User-Agent
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AuthStartRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AuthStartResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/auth/email_otp:
post:
tags:
- Auth
summary: Auth Email Otp
description: Verify email OTP code. Sets email_otp_validated flag on session.
operationId: auth_email_otp_api_v1_auth_email_otp_post
parameters:
- name: device-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Device-Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AuthEmailOtpRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StatusResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/auth/totp:
post:
tags:
- Auth
summary: Auth Totp
description: Verify TOTP code. Sets totp_validated flag on session.
operationId: auth_totp_api_v1_auth_totp_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TotpLoginRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StatusResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/auth/submit_signed_jwt:
post:
tags:
- Auth
summary: Submit Signed Jwt
description: 'Verify TEE-signed Google JWT attestation. Sets tee_validated flag on session.
Checks:
- msg in auth_payload == session_key (binds attestation to this session)
- hash_email matches session email
- Ed25519 signature is valid using TEE_PUBLIC_KEY'
operationId: submit_signed_jwt_api_v1_auth_submit_signed_jwt_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SubmitSignedJwtRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StatusResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/auth:
post:
tags:
- Auth
summary: Auth Complete
description: 'Complete auth: issue refresh token if all required steps are validated.'
operationId: auth_complete_api_v1_auth_post
security:
- HTTPBearer: []
parameters:
- name: user-agent
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User-Agent
- name: cf-ipcountry
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cf-Ipcountry
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AuthCompleteRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AuthSessionResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/auth/privy:
post:
tags:
- Auth
summary: Auth Privy
description: 'Authenticate via Privy embedded wallet signature.
1. Recover signer from signature of "I am the owner of {email}"
2. Verify via Privy API that this address is the embedded wallet for the email
3. Get or create user, save privy_address, deploy smart wallet if needed
4. Return HEVN refresh token'
operationId: auth_privy_api_v1_auth_privy_post
security:
- HTTPBearer: []
parameters:
- name: device-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Device-Id
- name: device-name
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Device-Name
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PrivyLoginRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PrivyLoginResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/auth/refresh:
post:
tags:
- Auth
summary: Refresh Session
description: 'Exchange a refresh token for a short-lived session token (10 min).
If user_id differs from the token owner, checks team membership
and issues a delegated session token (sub=owner, uid=target).'
operationId: refresh_session_api_v1_auth_refresh_post
security:
- HTTPBearer: []
parameters:
- name: user-agent
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User-Agent
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RefreshRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SessionTokenResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/auth/challenge:
post:
tags:
- Auth
summary: Start a developer-key login and receive the payload to sign
description: Start developer-key authentication. Sign the returned payload with the registered key and exchange it once through `POST /auth/token` before it expires.
operationId: start_challenge_auth_challenge_post
security:
- HTTPBearer: []
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ChallengeRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ChallengeResponse'
'422':
description: Request validation failed
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformErrorResponse'
/auth/token:
post:
tags:
- Auth
summary: Exchange a signed login challenge for a session
description: Exchange a signed, unexpired challenge for an access token and refresh token. A challenge is consumed once; replay, a different key or a different account is refused.
operationId: mint_token_auth_token_post
security:
- HTTPBearer: []
parameters:
- name: device-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Device-Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: user-agent
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User-Agent
requestBody:
required: true
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/ChallengeTokenRequest'
- $ref: '#/components/schemas/ProofTokenRequest'
title: Data
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TokenResponse'
'422':
description: Request validation failed
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformErrorResponse'
/auth/refresh:
post:
tags:
- Auth
summary: Exchange a refresh token for a session, optionally acting for an account
description: Exchange a device-bound refresh token for a new short-lived access token. `userId` may select an account the authenticated actor is currently authorized to access.
operationId: refresh_session_auth_refresh_post
security:
- HTTPBearer: []
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: user-agent
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User-Agent
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RefreshRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SessionResponse'
'422':
description: Request validation failed
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformErrorResponse'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
AuthSessionResponse:
properties:
refreshToken:
type: string
title: Refreshtoken
description: JWT refresh token (7 days)
tokenType:
type: string
title: Tokentype
default: bearer
userId:
type: string
title: Userid
description: User UUID
email:
type: string
title: Email
description: User email
isNewUser:
type: boolean
title: Isnewuser
default: false
type: object
required:
- refreshToken
- userId
- email
title: AuthSessionResponse
description: Response for POST /auth/complete — refresh token.
AuthEmailOtpRequest:
properties:
sessionKey:
type: string
title: Sessionkey
description: Session key from auth/start
otpCode:
type: string
maxLength: 6
minLength: 6
title: Otpcode
description: 6-digit OTP code
type: object
required:
- sessionKey
- otpCode
title: AuthEmailOtpRequest
description: Request schema for email OTP verification.
AuthStartResponse:
properties:
sessionKey:
type: string
title: Sessionkey
description: Session key for OTP verification
status:
type: string
title: Status
description: Auth session status
default: pending
authMethods:
items:
$ref: '#/components/schemas/AuthMethod'
type: array
title: Authmethods
description: Required auth methods
type: object
required:
- sessionKey
title: AuthStartResponse
description: Response schema for auth start.
AuthCompleteRequest:
properties:
sessionKey:
type: string
title: Sessionkey
description: Session key from auth/start
type: object
required:
- sessionKey
title: AuthCompleteRequest
description: Request for completing authentication.
SubmitSignedJwtRequest:
properties:
sessionKey:
type: string
title: Sessionkey
description: Session key from auth/start
authPayload:
type: string
title: Authpayload
description: JSON auth_payload from TEE attestation
signature:
type: string
title: Signature
description: Base58 Ed25519 signature from TEE
type: object
required:
- sessionKey
- authPayload
- signature
title: SubmitSignedJwtRequest
description: Request for submitting TEE-signed Google JWT attestation.
PrivyLoginResponse:
properties:
refreshToken:
type: string
title: Refreshtoken
userId:
type: string
title: Userid
email:
type: string
title: Email
isNewUser:
type: boolean
title: Isnewuser
default: false
privyAddress:
type: string
title: Privyaddress
baseSmartWallet:
anyOf:
- type: string
- type: 'null'
title: Basesmartwallet
type: object
required:
- refreshToken
- userId
- email
- privyAddress
title: PrivyLoginResponse
description: Response after Privy wallet auth.
PrivyLoginRequest:
properties:
signature:
type: string
title: Signature
email:
type: string
title: Email
address:
type: string
title: Address
nonce:
type: integer
title: Nonce
type: object
required:
- signature
- email
- address
- nonce
title: PrivyLoginRequest
description: Request to link a Privy wallet.
AuthMethod:
type: string
enum:
- email_otp
- totp
- signed_jwt
title: AuthMethod
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
StatusResponse:
properties:
status:
type: string
title: Status
default: ok
type: object
title: StatusResponse
description: Simple status response.
AuthStartRequest:
properties:
email:
type: string
title: Email
description: User email address
type: object
required:
- email
title: AuthStartRequest
description: Request schema for starting authentication.
RefreshRequest:
properties:
userId:
type: string
title: Userid
description: Target user UUID
type: object
required:
- userId
title: RefreshRequest
description: Request for refreshing a session token.
TotpLoginRequest:
properties:
sessionKey:
type: string
title: Sessionkey
description: Session key from email OTP step
code:
type: string
maxLength: 8
minLength: 6
title: Code
description: 6-digit TOTP code or 8-char recovery code
type: object
required:
- sessionKey
- code
title: TotpLoginRequest
description: Request to complete login with TOTP code.
SessionTokenResponse:
properties:
accessToken:
type: string
title: Accesstoken
description: JWT access token (10 min)
tokenType:
type: string
title: Tokentype
default: bearer
expiresIn:
type: integer
title: Expiresin
description: Token TTL in seconds
default: 600
type: object
required:
- accessToken
title: SessionTokenResponse
description: Response with short-lived JWT session token.
ChallengeRequest:
properties:
email:
type: string
format: email
title: Email
description: Email address of the account that owns the registered developer key.
publicKey:
type: string
title: Publickey
description: Base64 DER SubjectPublicKeyInfo for the registered P-256 developer key.
nonce:
type: integer
title: Nonce
description: Caller-generated single-use number included in the signed authentication proof.
requestExpiry:
type: integer
title: Requestexpiry
description: Unix time in milliseconds after which the signed request is refused.
signature:
type: string
title: Signature
description: Base64 DER ECDSA P-256/SHA-256 signature over the login proof message.
additionalProperties: false
type: object
required:
- email
- publicKey
- nonce
- requestExpiry
- signature
title: ChallengeRequest
ProofTokenRequest:
properties:
email:
type: string
format: email
title: Email
description: Email address of the account that owns the registered developer key.
publicKey:
type: string
title: Publickey
description: Base64 DER SubjectPublicKeyInfo for the registered P-256 developer key.
nonce:
type: integer
title: Nonce
description: Caller-generated single-use number included in the signed authentication proof.
requestExpiry:
type: integer
title: Requestexpiry
description: Unix time in milliseconds after which the signed request is refused.
signature:
type: string
title: Signature
description: Base64 DER ECDSA P-256/SHA-256 signature over the login proof message.
additionalProperties: false
type: object
required:
- email
- publicKey
- nonce
- requestExpiry
- signature
title: ProofTokenRequest
PlatformErrorResponse:
properties:
error:
$ref: '#/components/schemas/PlatformErrorBody'
description: Public error body.
type: object
required:
- error
title: PlatformErrorResponse
PlatformErrorCode:
type: string
enum:
- invalid_request
- validation_failed
- invalid_cursor
- invalid_id
- idempotency_key_invalid
- idempotency_key_reused
- unauthenticated
- token_expired
- forbidden
- not_found
- method_not_allowed
- conflict
- gone
- payload_too_large
- rate_limited
- provider_unavailable
- database_unavailable
- internal_error
- invalid_credentials
- request_expired
- challenge_not_found
- challenge_consumed
- challenge_expired
- signature_invalid
- key_not_registered
- signer_not_attached
- wallet_not_linked
- approval_consumed
- approval_expired
- approval_mismatch
- signing_policy_refused
- login_unavailable
- login_mode_unavailable
- developer_key_not_found
- developer_key_already_exists
- account_header_invalid
- account_scope_conflict
- account_not_found
- account_forbidden
- account_read_only
- account_not_controlled
- contact_not_found
- quote_not_submitted
- quote_not_fundable
- funding_mode_unsupported
- funding_token_unsupported
- insufficient_funds
- smart_wallet_not_deployed
- wallet_owner_unverified
- already_funded
- payment_slot_consumed
- funding_in_progress
- funding_attempt_expired
- contact_changed
- user_operation_rejected
- user_operation_unavailable
- transfer_policy_denied
- integrator_inactive
- client_creation_not_enabled
- client_policy_not_enabled
- email_in_use
- name_in_use
- client_request_conflict
- client_not_found
- profile_locked
- contact_not_payable
- contact_chain_unsupported
- contact_token_unsupported
- contact_payment_details_invalid
- amount_below_minimum
- amount_above_maximum
- amount_precision_unsupported
- payout_not_found
- payout_not_fundable
- quote_expired
- bundler_rejected
- bundler_unavailable
- contact_details_invalid
- contact_in_use
- kyb_incomplete
- kyb_roster_conflict
- kyb_subject_conflict
- document_fields_missing
- document_not_found
- document_type_unsupported
- invalid_enum_value
- entity_not_found
- escrow_not_found
- escrow_action_not_found
- escrow_not_operated_by_you
- escrow_state_changed
- action_in_flight
- simulation_failed
- stale_nonce
- amount_out_of_range
- amount_not_allowed
- window_closed
- token_not_supported
- receiver_not_a_client
- rail_not_found
- rail_not_available
- rail_requirements_unmet
- phone_required
- payin_not_available
- payin_expired
- payin_not_found
- transaction_not_found
- account_unavailable
- account_not_supported
- swap_not_found
- swap_route_unavailable
- swap_not_confirmable
- intent_not_signable
title: PlatformErrorCode
ChallengeResponse:
properties:
challengeId:
type: string
format: uuid
title: Challengeid
description: Single-use authentication challenge identifier.
payload:
type: string
title: Payload
description: Base64-encoded canonical authorization payload the developer key must sign.
expiresAt:
type: string
format: date-time
title: Expiresat
description: UTC timestamp after which the challenge is refused.
type: object
required:
- challengeId
- payload
- expiresAt
title: ChallengeResponse
SessionResponse:
properties:
accessToken:
type: string
title: Accesstoken
description: Short-lived bearer token used to authorize API requests.
expiresIn:
type: integer
title: Expiresin
description: Number of seconds until the access token expires.
userId:
type: string
pattern: ^(?:cl_)?[A-Za-z0-9._:\-]{1,216}$
title: Userid
description: Account selected for the issued session.
examples:
- cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41
type: object
required:
- accessToken
- expiresIn
- userId
title: SessionResponse
TokenResponse:
properties:
accessToken:
type: string
title: Accesstoken
description: Short-lived bearer token used to authorize API requests.
refreshToken:
type: string
title: Refreshtoken
description: Long-lived device-bound token used only at POST /dapi/v1/auth/refresh.
expiresIn:
type: integer
title: Expiresin
description: Number of seconds until the access token expires.
userId:
type: string
pattern: ^(?:cl_)?[A-Za-z0-9._:\-]{1,216}$
title: Userid
description: Account selected for the issued session.
examples:
- cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41
type: object
required:
- accessToken
- refreshToken
- expiresIn
- userId
title: TokenResponse
PlatformErrorBody:
properties:
code:
$ref: '#/components/schemas/PlatformErrorCode'
description: Stable machine-readable error code.
message:
type: string
title: Message
description: Human-readable explanation safe to show to an end user.
details:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Details
description: Structured context for this error, when available.
type: object
required:
- code
- message
title: PlatformErrorBody
ChallengeTokenRequest:
properties:
challengeId:
type: string
format: uuid
title: Challengeid
description: Single-use challenge identifier returned by POST /dapi/v1/auth/challenge.
signature:
type: string
title: Signature
description: Signature over the decoded payload returned for this challenge.
publicKey:
anyOf:
- type: string
- type: 'null'
title: Publickey
description: Registered P-256 public key; omit when the signature uniquely identifies the key.
additionalProperties: false
type: object
required:
- challengeId
- signature
title: ChallengeTokenRequest
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
x-default: Bearer <token>
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: Alternative HEVN API key header. The CLI defaults to Authorization Bearer unless configured with HEVN_API_KEY_HEADER=X-Api-Key.