> ## Documentation Index
> Fetch the complete documentation index at: https://readme.amana-dev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get saved KYC answers

> Get the answers the user has already saved for a KYC form.

## Path parameters

<ParamField path="formId" type="string" required>
  ID of the KYC form.
</ParamField>

<ParamField path="entity" type="string" required />

## Response

`200` Success.

<ResponseField name="entity" type="string" />

<ResponseField name="id" type="string" />

<ResponseField name="name" type="string" />

<ResponseField name="user_id" type="string" />

<ResponseField name="form_instance_id" type="string" />

<ResponseField name="section" type="number" />

<ResponseField name="answers" type="object" />

<ResponseField name="one_time_questions" type="string[]" />

<ResponseField name="kyc_completed" type="boolean" />

<ResponseField name="account_type" type="enum<string>" default="amana">
  Available options: `amana`, `mt5_hedged`, `mt5_netting`, `mt4`, `copy_trading`, `snb`, `c2c_investing`, `c2c_trading`
</ResponseField>

<ResponseField name="trading_accounts" type="object[]">
  <Expandable title="properties">
    <ResponseField name="id" type="string" />

    <ResponseField name="external_id" type="string" />

    <ResponseField name="external_user" type="string" />

    <ResponseField name="type" type="string" />

    <ResponseField name="currency" type="string" />

    <ResponseField name="group" type="string" />

    <ResponseField name="kyc_id" type="string" />

    <ResponseField name="last_active" type="string<date-time>">
      Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="string" />

<ResponseField name="updated_at" type="string" />

## Possible Errors

| Error | Possible cause | What to do |
| - | - | - |
| 400 | Invalid or missing field | Check the request against the schema. |
| 401 | Token missing or expired | Log in again or use the refresh token. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://gateway.amana.io/kyc/{entity}/{formId}'
  ```

  ```python Python theme={null}
  import requests

  url = "https://gateway.amana.io/kyc/{entity}/{formId}"
  headers = {}

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://gateway.amana.io/kyc/{entity}/{formId}', {
    method: 'GET',
    headers: {},
  });
  console.log(await response.json());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "entity": "<string>",
    "id": "<string>",
    "name": "<string>",
    "user_id": "<string>",
    "form_instance_id": "<string>",
    "section": 123.45,
    "answers": {},
    "one_time_questions": [],
    "kyc_completed": true,
    "account_type": "amana",
    "trading_accounts": [
      {
        "id": "<string>",
        "external_id": "<string>",
        "external_user": "<string>",
        "type": "<string>",
        "currency": "<string>",
        "group": "<string>",
        "kyc_id": "<string>",
        "last_active": "2026-01-01T00:00:00Z"
      }
    ],
    "created_at": "<string>",
    "updated_at": "<string>"
  }
  ```

  ```json 400 theme={null}
  {
    "error": "<string>",
    "message": "<string>",
    "details": {}
  }
  ```

  ```json 401 theme={null}
  {
    "error": "<string>",
    "message": "<string>",
    "details": {}
  }
  ```

  ```json 403 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 429 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.