---
title: "Retrieve Validation Result"
method: GET
path: "/api/v2/validate/account/{request_id}"
tags: ["validate_account"]
---

# Retrieve Validation Result

`GET /api/v2/validate/account/{request_id}`

## Path parameters

- `request_id` string, required

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- ValidationResponse
  - `data` ResponseData
    - `account_validation` AccountValidationResult
      - `result` 'match' | 'no_match'
      - `status` 'active' | 'conditional' | 'closed' | 'unreported'
      - `reason` ReasonDetail
        - `code` string, required
        - `message` string, required
    - `account_owner_name` AccountOwnerNameResult
      - `match_score` integer, nullable
      - `match_verdict` 'match' | 'partial_match' | 'no_match' | 'not_evaluated'
      - `registered_name` string[], nullable
      - `reason` ReasonDetail
        - `code` string, required
        - `message` string, required
    - `account_owner_id` AccountOwnerIdResult
      - `match_verdict` 'match' | 'no_match' | 'not_evaluated'
      - `registered_id` OwnerId[], nullable
        - `value` string, required
        - `type` string, required
      - `reason` ReasonDetail
        - `code` string, required
        - `message` string, required
    - `account_currency` AccountCurrencyResult
      - `match_verdict` 'match' | 'no_match' | 'not_evaluated'
      - `registered_currency` string[], nullable
      - `reason` ReasonDetail
        - `code` string, required
        - `message` string, required
    - `account_details` AccountDetailsResult
      - `identifiers` AccountIdentifier[], nullable
        - `value` string, required
        - `format` string, required
      - `type` string, nullable
      - `branch_code` string, nullable
      - `bank` Bank
        - `code` string — The bank code number
        - `bicfi` string — The bank BICFI code
        - `name` string — The bank name
        - `country` string — ISO-3166-1 Alfa-2 country code
      - `reason` ReasonDetail
        - `code` string, required
        - `message` string, required
  - `errors` unknown
  - `metadata` MetadataResponse
    - `request_id` string
    - `status` 'processing' | 'completed' | 'failed'
    - `timestamp` string

## Other responses

- `202` — Accepted
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/prometeoapi/apis/account-validation-v2.md) · [All operations](https://skmtc.net/prometeoapi/apis/account-validation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prometeoapi/account-validation-v2/revisions/9c278fe91cbd/schema)