Questionnaire Responses

curl -X POST https://api.kycgenie.com/api/v1/responses/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: resp-acme-ddq-20260114" \
  -d '{
    "questionnaire_id": 55,
    "entity": {
      "entity_id": "1b83f447-4a1e-4589-8a12-b8767e3c5426"
    },
    "status": "PREFILL"
  }'

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: resp-acme-ddq-20260114" \
  -d '{
    "questionnaire_id": "7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a",
    "entity_id": "1b83f447-4a1e-4589-8a12-b8767e3c5426",
    "status": "PREFILL"
  }'

import requests

resp = requests.post(
    "https://api.kycgenie.com/api/v1/responses/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": "resp-acme-ddq-20260114",
    },
    json={
        "questionnaire_id": 55,
        "entity": {"entity_id": "1b83f447-4a1e-4589-8a12-b8767e3c5426"},
        "status": "PREFILL",
    },
)

data = resp.json()
print(f"Created response: {data['id']}")

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

response = client.questionnaire_responses.create(
    questionnaire_id="7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a",
    entity_id="1b83f447-4a1e-4589-8a12-b8767e3c5426",
    status="PREFILL",
)

print(f"Created: {response.id}")        # UUID
print(f"Status:  {response.status}")    # PREFILL

const resp = await fetch('https://api.kycgenie.com/api/v1/responses/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Idempotency-Key': 'resp-acme-ddq-20260114',
  },
  body: JSON.stringify({
    questionnaire_id: 55,
    entity: { entity_id: '1b83f447-4a1e-4589-8a12-b8767e3c5426' },
    status: 'PREFILL',
  }),
});

const data = await resp.json();
console.log(`Created: ${data.id}`);

const resp = await fetch('https://api.kycgenie.com/api/v2/questionnaire-responses/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Idempotency-Key': 'resp-acme-ddq-20260114',
  },
  body: JSON.stringify({
    questionnaire_id: '7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a',
    entity_id: '1b83f447-4a1e-4589-8a12-b8767e3c5426',
    status: 'PREFILL',
  }),
});

const data = await resp.json();
console.log(`Created: ${data.id}`);

curl -X POST https://api.kycgenie.com/api/v1/responses/batch/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: batch-onboard-20260114" \
  -d '[
    {
      "questionnaire_id": 55,
      "entity": {"entity_id": "1b83f447-4a1e-4589-8a12-b8767e3c5426"},
      "status": "PREFILL"
    },
    {
      "questionnaire_id": 55,
      "entity": {"entity_id": "2c94g558-5b2f-5693-9b23-c9878f774437"},
      "status": "PREFILL"
    }
  ]'

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/batch/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: batch-onboard-20260114" \
  -d '{
    "responses": [
      {
        "questionnaire_id": "7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a",
        "entity_id": "1b83f447-4a1e-4589-8a12-b8767e3c5426",
        "status": "PREFILL"
      },
      {
        "questionnaire_id": "7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a",
        "entity_id": "2c94g558-5b2f-5693-9b23-c9878f774437",
        "status": "PREFILL"
      }
    ]
  }'

import requests

# v1: bare list payload with nested entity object
resp = requests.post(
    "https://api.kycgenie.com/api/v1/responses/batch/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": "batch-onboard-20260114",
    },
    json=[
        {
            "questionnaire_id": 55,
            "entity": {"entity_id": "1b83f447-4a1e-4589-8a12-b8767e3c5426"},
            "status": "PREFILL",
        },
        {
            "questionnaire_id": 55,
            "entity": {"entity_id": "2c94g558-5b2f-5693-9b23-c9878f774437"},
            "status": "PREFILL",
        },
    ],
)

data = resp.json()
print(f"Created: {data['created_count']}, Failed: {data['failed_count']}")

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.batch_create(
    responses=[
        {
            "questionnaire_id": "7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a",
            "entity_id": "1b83f447-4a1e-4589-8a12-b8767e3c5426",
            "status": "PREFILL",
        },
        {
            "questionnaire_id": "7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a",
            "entity_id": "2c94g558-5b2f-5693-9b23-c9878f774437",
            "status": "PREFILL",
        },
    ]
)

print(f"Created: {result.created_count}, Failed: {result.failed_count}")

const resp = await fetch('https://api.kycgenie.com/api/v1/responses/batch/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Idempotency-Key': 'batch-onboard-20260114',
  },
  body: JSON.stringify([
    { questionnaire_id: 55, entity: { entity_id: '1b83f447-4a1e-4589-8a12-b8767e3c5426' }, status: 'PREFILL' },
    { questionnaire_id: 55, entity: { entity_id: '2c94g558-5b2f-5693-9b23-c9878f774437' }, status: 'PREFILL' },
  ]),
});

const data = await resp.json();
console.log(`Created: ${data.created_count}, Failed: ${data.failed_count}`);

const resp = await fetch('https://api.kycgenie.com/api/v2/questionnaire-responses/batch/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Idempotency-Key': 'batch-onboard-20260114',
  },
  body: JSON.stringify({
    responses: [
      { questionnaire_id: '7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a', entity_id: '1b83f447-4a1e-4589-8a12-b8767e3c5426', status: 'PREFILL' },
      { questionnaire_id: '7f1a3c4e-5b9d-4e82-a1f3-8d2c5e7b9f0a', entity_id: '2c94g558-5b2f-5693-9b23-c9878f774437', status: 'PREFILL' },
    ],
  }),
});

const data = await resp.json();
console.log(`Created: ${data.created_count}, Failed: ${data.failed_count}`);

curl "https://api.kycgenie.com/api/v1/responses/?status=SUBMITTED" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.kycgenie.com/api/v2/questionnaire-responses/?status=SUBMITTED" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.kycgenie.com/api/v1/responses/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"status": "SUBMITTED"},
)

data = resp.json()
for r in data["results"]:
    print(f"{r['id']}  {r['status']}  {r['response_name']}")

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

page = client.questionnaire_responses.list(status="SUBMITTED")
for r in page.results:
    print(f"{r.id}  {r.status}  {r.response_name}")

# Next page
if page.has_more:
    page2 = client.questionnaire_responses.list(
        status="SUBMITTED",
        cursor=page.next_cursor,
    )

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/?status=SUBMITTED',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const data = await resp.json();
data.results.forEach(r => console.log(`${r.id}  ${r.status}  ${r.response_name}`));

const resp = await fetch(
  'https://api.kycgenie.com/api/v2/questionnaire-responses/?status=SUBMITTED',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const data = await resp.json();
data.results.forEach(r => console.log(`${r.id}  ${r.status}  ${r.response_name}`));

curl https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.get(
    f"https://api.kycgenie.com/api/v2/questionnaire-responses/{response_id}/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

data = resp.json()
print(f"Status: {data['status']}")
print(f"Questionnaire: {data['questionnaire']['id']}")
print(f"Entity: {data['subject_entity']['name']}")

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

response = client.questionnaire_responses.get_details(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)

print(f"Status: {response.status}")
print(f"Entity: {response.subject_entity.name}")

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';

const resp = await fetch(
  `https://api.kycgenie.com/api/v1/responses/${responseId}/`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const data = await resp.json();
console.log(`Status: ${data.status}`);
console.log(`Entity: ${data.subject_entity.name}`);

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';

const resp = await fetch(
  `https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const data = await resp.json();
console.log(`Status: ${data.status}`);
console.log(`Questionnaire: ${data.questionnaire.id}`);
console.log(`Entity: ${data.subject_entity.name}`);

curl https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/questions/ \
  -H "Authorization: Bearer YOUR_API_KEY"

# v2 only - not available on v1
# Use GET /api/v1/questionnaires/{id}/ for questions,
# and GET /api/v1/responses/{id}/ for answers.

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

form = client.questionnaire_responses.get_questions(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)

print(f"Progress: {form.summary.answered}/{form.summary.total_questions}")
print(f"Required missing: {form.summary.required_unanswered} text, {form.summary.required_files_unanswered} files")

# Build answers for all unanswered required questions
answers = []
for section in form.sections:
    for sub in section.sub_sections:
        for q in sub.questions:
            if not q.is_answered and q.required:
                answers.append({
                    "question_id": q.question_id,
                    "answer_text": f"Answer to: {q.question_text}",
                })

client.questionnaire_responses.update_answers(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
    answers=answers,
)

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.get(
    f"https://api.kycgenie.com/api/v2/questionnaire-responses/{response_id}/questions/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

form = resp.json()
print(f"Progress: {form['summary']['answered']}/{form['summary']['total_questions']}")

for section in form["sections"]:
    for sub in section["sub_sections"]:
        for q in sub["questions"]:
            status = "✓" if q["is_answered"] else ("✗ required" if q["required"] else "–")
            print(f"  [{status}] Q{q['question_number']}: {q['question_text'][:60]}")

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';

const resp = await fetch(
  `https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/questions/`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const { summary, sections } = await resp.json();
console.log(`Progress: ${summary.answered}/${summary.total_questions}`);
console.log(`Required missing: ${summary.required_unanswered} text, ${summary.required_files_unanswered} files`);

// Collect unanswered required questions
const missing = sections
  .flatMap(s => s.sub_sections)
  .flatMap(sub => sub.questions)
  .filter(q => !q.is_answered && q.required);

console.log(`Unanswered required questions:`, missing.map(q => q.question_id));

// v2 only - not available on v1

curl https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/answers/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/answers/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.get(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/answers/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

for answer in resp.json()["results"]:
    print(f"Q{answer['question_number']}: {answer['answer_text']}")
    if answer["is_flagged"]:
        print("  ^⚠ flagged")

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.get_answers(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)

print(f"Answered: {result.summary.answered}/{result.summary.total_questions}")
print(f"Required unanswered: {result.summary.required_unanswered}")
print(f"Files uploaded: {result.summary.files_uploaded}/{result.summary.total_file_questions} ({result.summary.required_files_unanswered} required missing)")

for answer in result.text_answers:
    print(f"Q{answer.question_number}: {answer.answer_text}")
    if answer.is_flagged:
        print("  ^⚠ flagged")

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';

const resp = await fetch(
  `https://api.kycgenie.com/api/v1/responses/${responseId}/answers/`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const { results } = await resp.json();
results.forEach(a => {
  console.log(`Q${a.question_number}: ${a.answer_text}`);
  if (a.is_flagged) console.log('  ^ flagged');
});

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';

const resp = await fetch(
  `https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/answers/`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const { summary, text_answers, file_answers } = await resp.json();
console.log(`Answered: ${summary.answered}/${summary.total_questions}`);
console.log(`Required unanswered: ${summary.required_unanswered}`);
text_answers.forEach(a => {
  console.log(`Q${a.question_number}: ${a.answer_text}`);
  if (a.is_flagged) console.log('  ^ flagged');
});

curl -X PUT https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/save/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: save-acme-ddq-20260114" \
  -F 'answers=[{"question_id": 42, "answer_text": "AES-256 encryption at rest"},{"question_id": 43, "answer_text": "Annual penetration testing"}]' \
  -F "67=@audit_report.pdf"

# Step 1: save text answers (bare JSON array)
curl -X PUT https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/answers/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"question_id": 42, "answer_text": "AES-256 encryption at rest"},{"question_id": 43, "answer_text": "Annual penetration testing"}]'

# Step 2: upload file for file question 67
curl -X PUT https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/answers/67/file/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@audit_report.pdf"

import json
import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

# v1: single multipart call for both text and files
resp = requests.put(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/save/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": "save-acme-ddq-20260114",
    },
    data={"answers": json.dumps([
        {"question_id": 42, "answer_text": "AES-256 encryption at rest"},
        {"question_id": 43, "answer_text": "Annual penetration testing"},
    ])},
    files={"67": open("audit_report.pdf", "rb")},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

# Step 1: save text answers
result = client.questionnaire_responses.update_answers(
    response_id=response_id,
    answers=[
        {"question_id": 42, "answer_text": "AES-256 encryption at rest"},
        {"question_id": 43, "answer_text": "Annual penetration testing"},
    ],
)
print(f"Saved: {result.answers_saved} answers")

# Step 2: upload a file for file question 67
with open("audit_report.pdf", "rb") as f:
    file_answer = client.questionnaire_responses.upload_file_answer(
        response_id=response_id,
        fq_id=67,
        file=("audit_report.pdf", f, "application/pdf"),
    )
print(f"Attachment ID: {file_answer.attachment_id}")

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';
const formData = new FormData();
formData.append('answers', JSON.stringify([
  { question_id: 42, answer_text: 'AES-256 encryption at rest' },
  { question_id: 43, answer_text: 'Annual penetration testing' },
]));
formData.append('67', fileInput.files[0]);

const resp = await fetch(`https://api.kycgenie.com/api/v1/responses/${responseId}/save/`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Idempotency-Key': 'save-acme-ddq-20260114',
  },
  body: formData,
});
console.log(await resp.json());

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';

// Step 1: save text answers (bare JSON array)
await fetch(`https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/answers/`, {
  method: 'PUT',
  headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify([
    { question_id: 42, answer_text: 'AES-256 encryption at rest' },
    { question_id: 43, answer_text: 'Annual penetration testing' },
  ]),
});

// Step 2: upload file for file question 67
const formData = new FormData();
formData.append('file', fileInput.files[0]);
await fetch(`https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/answers/67/file/`, {
  method: 'PUT',
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
  body: formData,
});

# Minimal - uses entity's email on record
curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/send/ \
  -H "Authorization: Bearer YOUR_API_KEY"

# With email override and custom expiry
curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/send/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "compliance@acmecorp.com", "expiry_hours": 72}'

# Minimal - uses entity's email on record
curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/send/ \
  -H "Authorization: Bearer YOUR_API_KEY"

# With email override and custom expiry
curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/send/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "compliance@acmecorp.com", "expiry_hours": 72}'

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.post(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/send/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    # Optional - omit to use entity's email on record
    json={"email": "compliance@acmecorp.com", "expiry_hours": 72},
)

data = resp.json()
print(f"Session: {data['session_id']}")
print(f"Expires: {data['expires_at']}")

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.send(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
    # Optional - omit to use entity's email on record
    email="compliance@acmecorp.com",
    expiry_hours=72,
)

print(f"Session:  {result.session_id}")
print(f"Steps:    {result.steps}")        # e.g. ['ddq'] or ['ddq', 'verification']
print(f"Expires:  {result.expires_at}")

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/send/',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
    // Optional body - omit to use entity's email on record
    body: JSON.stringify({ email: 'compliance@acmecorp.com', expiry_hours: 72 }),
  }
);
console.log(await resp.json());

const resp = await fetch(
  'https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/send/',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
    body: JSON.stringify({ email: 'compliance@acmecorp.com', expiry_hours: 72 }),
  }
);
console.log(await resp.json());

curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/submit/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/submit/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.post(
    "https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/submit/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.submit(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)

print(f"Status: {result.status}")  # SUBMITTED
print(f"Task:   {result.autoflag_task_id}")

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/submit/',
  { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

console.log(await resp.json());

curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/approve/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"notes": "All checks passed. No adverse screening results."}'

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/approve/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"notes": "All checks passed. No adverse screening results."}'

import requests

resp = requests.post(
    "https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/approve/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"notes": "All checks passed. No adverse screening results."},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.approve(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
    notes="All checks passed. No adverse screening results.",
)
print(f"Status: {result.new_status}")  # APPROVED

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/approve/',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
    body: JSON.stringify({ notes: 'All checks passed. No adverse screening results.' }),
  }
);
console.log(await resp.json());

curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/reject/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Missing UBO documentation. Beneficial ownership chain unverifiable."}'

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/reject/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Missing UBO documentation. Beneficial ownership chain unverifiable."}'

import requests

resp = requests.post(
    "https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/reject/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"reason": "Missing UBO documentation. Beneficial ownership chain unverifiable."},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.reject(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
    reason="Missing UBO documentation. Beneficial ownership chain unverifiable.",
)
print(f"Status: {result.new_status}")  # REJECTED

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/reject/',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
    body: JSON.stringify({ reason: 'Missing UBO documentation. Beneficial ownership chain unverifiable.' }),
  }
);
console.log(await resp.json());

curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/request-changes/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"changes_needed": "Please provide the latest audited financial statements and shareholder register."}'

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/request-changes/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"changes_needed": "Please provide the latest audited financial statements and shareholder register."}'

import requests

resp = requests.post(
    "https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/request-changes/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"changes_needed": "Please provide the latest audited financial statements and shareholder register."},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.request_changes(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
    changes_needed="Please provide the latest audited financial statements and shareholder register.",
)
print(f"Status: {result.new_status}")  # CHANGES_REQUESTED

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/request-changes/',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
    body: JSON.stringify({ changes_needed: 'Please provide the latest audited financial statements and shareholder register.' }),
  }
);
console.log(await resp.json());

curl -X DELETE https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X DELETE https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.delete(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.status_code)  # 204

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

client.questionnaire_responses.delete(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)
# Returns None on success (204 No Content)

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/',
  { method: 'DELETE', headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
console.log(resp.status);  // 204

curl https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/entities/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/entities/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.get(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/entities/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

entities = client.questionnaire_responses.get_entities(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)
print(f"Total entities: {entities.total_count}")

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/entities/',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
console.log(await resp.json());

curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/token/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/token/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

# v1
resp = requests.post(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/token/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = resp.json()
print(data["onboarding_url"])

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

token_data = client.questionnaire_responses.generate_token(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)
print(f"Onboarding URL: {token_data.onboarding_url}")
print(f"Expires at:     {token_data.expires_at}")

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/token/',
  { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const data = await resp.json();
console.log(data.onboarding_url);

const resp = await fetch(
  'https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/token/',
  { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const data = await resp.json();
console.log(data.onboarding_url);

curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/autofill/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/autofill/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.post(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/autofill/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.autofill(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)
print(f"Task ID: {result.task_id}")
print(f"Status:  {result.status}")  # PREFILL or DRAFT

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/autofill/',
  { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
console.log(await resp.json());

curl -X POST https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/assessment/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/assessment/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.post(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/assessment/generate/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.generate_assessment_report(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)
print(f"Task ID: {result.task_id}")
print(f"Status:  {result.status}")  # pending

const resp = await fetch(
  'https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/assessment/generate/',
  { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
console.log(await resp.json());

curl -L https://api.kycgenie.com/api/v1/responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/assessment/download/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o assessment_report.docx

curl -L https://api.kycgenie.com/api/v2/questionnaire-responses/d67177bf-6871-45bf-85f2-95a1e52ccc64/assessment/download/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o assessment_report.docx

import requests

response_id = "d67177bf-6871-45bf-85f2-95a1e52ccc64"

resp = requests.get(
    f"https://api.kycgenie.com/api/v1/responses/{response_id}/assessment/download/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    stream=True,
)

with open("assessment_report.docx", "wb") as fh:
    for chunk in resp.iter_content(chunk_size=8192):
        fh.write(chunk)

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

content = client.questionnaire_responses.download_assessment(
    response_id="d67177bf-6871-45bf-85f2-95a1e52ccc64",
)

with open("assessment_report.docx", "wb") as fh:
    fh.write(content)

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';

const resp = await fetch(`https://api.kycgenie.com/api/v1/responses/${responseId}/assessment/download/`, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
});

const blob = await resp.blob();
const link = document.createElement('a');
link.href = URL.createObjectURL(blob);
link.download = 'assessment_report.docx';
link.click();

const responseId = 'd67177bf-6871-45bf-85f2-95a1e52ccc64';

const resp = await fetch(`https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/assessment/download/`, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
});

const blob = await resp.blob();
const link = document.createElement('a');
link.href = URL.createObjectURL(blob);
link.download = 'assessment_report.docx';
link.click();

curl https://api.kycgenie.com/api/v2/questionnaire-responses/770g0611-g40d-63f6-c938-668877662222/answers/files/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "770g0611-g40d-63f6-c938-668877662222"

resp = requests.get(
    f"https://api.kycgenie.com/api/v2/questionnaire-responses/{response_id}/answers/files/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

files = client.questionnaire_responses.list_file_answers(
    response_id="770g0611-g40d-63f6-c938-668877662222",
)
for f in files.data:
    print(f"{f.document.name} - {f.file_question_type}")

const responseId = '770g0611-g40d-63f6-c938-668877662222';

const resp = await fetch(
  `https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/answers/files/`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
console.log(await resp.json());

curl https://api.kycgenie.com/api/v2/questionnaire-responses/770g0611-g40d-63f6-c938-668877662222/answers/files/abb6336c-7edc-4814-92eb-4a80dc5b17fd/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "770g0611-g40d-63f6-c938-668877662222"
attachment_id = "abb6336c-7edc-4814-92eb-4a80dc5b17fd"

resp = requests.get(
    f"https://api.kycgenie.com/api/v2/questionnaire-responses/{response_id}/answers/files/{attachment_id}/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

fa = client.questionnaire_responses.get_file_answer(
    response_id="770g0611-g40d-63f6-c938-668877662222",
    attachment_id="abb6336c-7edc-4814-92eb-4a80dc5b17fd",
)
print(f"{fa.document.name} - question: {fa.file_question_type}")

const resp = await fetch(
  'https://api.kycgenie.com/api/v2/questionnaire-responses/770g0611-g40d-63f6-c938-668877662222/answers/files/abb6336c-7edc-4814-92eb-4a80dc5b17fd/',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
console.log(await resp.json());

curl https://api.kycgenie.com/api/v2/questionnaire-responses/770g0611-g40d-63f6-c938-668877662222/answers/files/abb6336c-7edc-4814-92eb-4a80dc5b17fd/download/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "770g0611-g40d-63f6-c938-668877662222"
attachment_id = "abb6336c-7edc-4814-92eb-4a80dc5b17fd"

resp = requests.get(
    f"https://api.kycgenie.com/api/v2/questionnaire-responses/{response_id}/answers/files/{attachment_id}/download/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.questionnaire_responses.download_file(
    response_id="770g0611-g40d-63f6-c938-668877662222",
    attachment_id="abb6336c-7edc-4814-92eb-4a80dc5b17fd",
)
print(f"Download URL: {result.download_url}")
print(f"Expires at:   {result.expires_at}")

const responseId = '770g0611-g40d-63f6-c938-668877662222';
const attachmentId = 'abb6336c-7edc-4814-92eb-4a80dc5b17fd';

const resp = await fetch(
  `https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/answers/files/${attachmentId}/download/`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
console.log(await resp.json());

curl -X DELETE https://api.kycgenie.com/api/v2/questionnaire-responses/770g0611-g40d-63f6-c938-668877662222/answers/files/abb6336c-7edc-4814-92eb-4a80dc5b17fd/ \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response_id = "770g0611-g40d-63f6-c938-668877662222"
attachment_id = "abb6336c-7edc-4814-92eb-4a80dc5b17fd"

resp = requests.delete(
    f"https://api.kycgenie.com/api/v2/questionnaire-responses/{response_id}/answers/files/{attachment_id}/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.status_code)  # 204

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

client.questionnaire_responses.delete_file_answer(
    response_id="770g0611-g40d-63f6-c938-668877662222",
    attachment_id="abb6336c-7edc-4814-92eb-4a80dc5b17fd",
)
# Returns None on success (204 No Content)

const responseId = '770g0611-g40d-63f6-c938-668877662222';
const attachmentId = 'abb6336c-7edc-4814-92eb-4a80dc5b17fd';

const resp = await fetch(
  `https://api.kycgenie.com/api/v2/questionnaire-responses/${responseId}/answers/files/${attachmentId}/`,
  { method: 'DELETE', headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
console.log(resp.status);  // 204