Users

Re-issue verification

Re-trigger KYC/KYB for a user that came back REJECTED, without re-creating them.

type selects how the user completes verification:

"embedded-link" (this example) — Kira returns a hosted KYC link (verification_link in the response); your end user opens it and completes verification on Kira’s page. Same flow as verification_mode: "verification_link" on Create User.
"api" — you submit the corrected KYC data yourself via a metadata object. Same flow as verification_mode: "automatic" on Create User.

Requires the Idempotency-Key header. Note: this endpoint does not accept verification_mode — that field belongs to Create User (POST /v1/users).

POST

users

{user_id}

verifications

Re-issue verification

curl --request POST \
  --url https://api.balampay.com/v1/users/{user_id}/verifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-Api-Version: <x-api-version>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "embedded-link"
}
'

{
  "code": "<string>",
  "message": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Access token from POST /auth (the data.access_token value).

x-api-key

string

header

required

API key issued by Kira. Required on every request, including /auth.

Headers

X-Api-Version

string

required

Example:

"2026-04-14"

Idempotency-Key

string

required

Example:

"{{idempotency_key}}"

Path Parameters

user_id

string<uuid>

required

User UUID.

Body

application/json

Option 1
Option 2

type

enum<string>

required

Available options:

embedded-link

redirect_uri

string<uri>

language

enum<string>

Available options:

en,

es

Response

Created.

List virtual accountsUse `limit<=100` — `GET /v1/virtual-accounts?limit>100` returns a raw `500 "Internal server error"` (same known cap as `GET /v1/users`; applies to ALL list endpoints). Note `provider` and `currency` come back `null` in the list view — fetch by ID if you need them.

⌘I

Re-issue verification

curl --request POST \
  --url https://api.balampay.com/v1/users/{user_id}/verifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-Api-Version: <x-api-version>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "embedded-link"
}
'

{
  "code": "<string>",
  "message": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}