Get Application

Returns the application record including all form data, documents with presigned download URLs, participant information, and — for eligible applications — documents retrieved directly from the company registry.

GET /api/external/applications/{id}

Authentication

Requires an API key with applications:read scope. The application must belong to the organization associated with the API key.

Authorization: Bearer klara_{client_id}.{secret}

Path parameters

string

required

UUID of the application.

Response

Returns 200 OK with the full application detail.

string

UUID of the application.

string

Configuration ID used for this application.

string

Current status: created, sent, in_progress, submitted, review, approved, rejected.

string

The primary participant’s application form URL — the same link returned by Create Application. Use it to recover a lost link or re-send it to the applicant through your own channels. If your organization has an active custom domain, the link uses it. Omitted in the rare case an application has no primary participant.

object

Application data. Contains the following top-level keys:

Show data properties

object

Key-value map of all collected form field values (e.g., company_name, registered_address). Includes questionnaire, company, and other field categories.

array

Directors, UBOs, and shareholders as entered by the applicant.

Show person properties

string

UUID of the person record.

string

registry or user_added.

string[]

One or more of director, ubo, shareholder.

string

Full legal name.

string

First name, split from the full name.

string

Last name, split from the full name.

string | undefined

Email address.

string | undefined

Phone number.

string | undefined

ISO 8601 date (e.g., 1985-03-22).

string | undefined

ISO 3166-1 alpha-2 country code.

object | undefined

Structured address object.

object

Map of documents keyed by field ID. Only documents with status accepted, forced, or skipped are included — see Document status.

Show document properties

string

UUID of the document record.

string

Original file name.

string

MIME type (e.g., application/pdf).

string

ISO 8601 timestamp of upload.

string

accepted, forced (manually accepted by an admin), or skipped (requirement waived by an admin).

string | undefined

Why the document was accepted: validation_passed, no_validator_configured, or baseline_passed.

string | undefined

Reason provided when a document was forced or skipped.

string | undefined

ISO 8601 timestamp of the force/skip override.

string | undefined

Presigned S3 URL valid for 60 seconds.

array

Related legal entities in the ownership structure.

Show entity properties

string

UUID of the entity record.

string

registry or user_added.

string

Legal entity name.

string

holding_company, subsidiary, parent, or other.

string | undefined

ISO 3166-1 alpha-2 country code.

object

Map of accepted documents, same structure as people[].documents.

array

Ownership structure relationships. See Ownership relationship for field definitions.

object

Company-scoped documents, keyed by field ID. Only documents with status accepted, forced, or skipped are included. Each value has the same shape as people[].documents.

object

Application metadata.

Show meta properties

object | undefined

{ name, email, role? } — the primary contact on record.

string[] | undefined

Registry sources used for enrichment (e.g., ["companies_house"]).

string | undefined

URL of the company’s website favicon, if extracted.

string | undefined

Industry inferred from the company website, if extracted.

array

Participants associated with this application.

Show participant properties

string

Email address.

string | null

Display name.

string

Participant role (primary or collaborator).

string

This participant’s application form URL.

array

Documents Klara retrieved directly from the company registry (currently Companies House for UK companies) — no applicant upload involved. Only present for registry-eligible applications: a UK company with a company number, on a configuration with registry documents enabled. An empty array means retrieval hasn’t completed yet — check registry_documents_status.

Show registry document properties

string

UUID of the registry document.

string

Registry the document came from (currently companies_house).

string

Filing type — see Registry document types.

string | null

Date the document was filed with the registry (YYYY-MM-DD).

string | null

ISO 8601 timestamp when Klara retrieved the document.

string | undefined

Presigned S3 URL valid for 60 seconds.

string

Overall retrieval status: pending (still fetching), complete (all available filings retrieved), partial (some filings could not be retrieved), or failed. Only present for registry-eligible applications.

string

ISO 8601 timestamp.

string | null

ISO 8601 timestamp, or null if not yet submitted.

string | null

ISO 8601 timestamp when approved/rejected, or null.

Examples

curl "https://app.klara-ai.com/api/external/applications/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer klara_abc123def456.your-secret-here"

const response = await fetch(
  'https://app.klara-ai.com/api/external/applications/550e8400-e29b-41d4-a716-446655440000',
  {
    headers: {
      'Authorization': 'Bearer klara_abc123def456.your-secret-here'
    }
  }
);

const application = await response.json();

import requests

response = requests.get(
    'https://app.klara-ai.com/api/external/applications/550e8400-e29b-41d4-a716-446655440000',
    headers={'Authorization': 'Bearer klara_abc123def456.your-secret-here'}
)

application = response.json()

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "config_id": "kyc-standard",
  "status": "submitted",
  "link": "https://app.klara-ai.com/external/acme/apply/a1b2c3d4e5f6g7h8",
  "data": {
    "fields": {
      "company_name": "Acme Financial Ltd",
      "company_number": "12345678",
      "company_country": "GB",
      "registered_address": "123 High Street, London, EC1A 1BB",
      "trading_name": "Acme Finance",
      "web_presence": "https://acmefinancial.co.uk",
      "industry": "Financial Services",
      "years_trading": 8,
      "annual_revenue": 2500000
    },
    "people": [
      {
        "id": "person-001",
        "source": "registry",
        "full_name": "John Smith",
        "email": "john.smith@acmefinancial.co.uk",
        "phone_number": "+447700900123",
        "date_of_birth": "1978-06-14",
        "nationality": "GB",
        "home_address": {
          "line1": "45 Elm Avenue",
          "city": "London",
          "postcode": "SW1A 2AA",
          "country": "GB"
        },
        "roles": ["director", "ubo"],
        "documents": {
          "passport": {
            "file_id": "doc-001",
            "file_name": "john-smith-passport.pdf",
            "file_type": "application/pdf",
            "uploaded_at": "2026-01-15T11:00:00.000Z",
            "status": "accepted",
            "acceptance_reason": "validation_passed",
            "download_url": "https://s3.amazonaws.com/..."
          },
          "proof_of_address": {
            "file_id": "doc-003",
            "file_name": "utility-bill-jan.pdf",
            "file_type": "application/pdf",
            "uploaded_at": "2026-01-15T11:10:00.000Z",
            "status": "accepted",
            "acceptance_reason": "validation_passed",
            "download_url": "https://s3.amazonaws.com/..."
          }
        }
      },
      {
        "id": "person-002",
        "source": "user_added",
        "full_name": "Sarah Chen",
        "email": "sarah.chen@acmefinancial.co.uk",
        "date_of_birth": "1985-03-22",
        "nationality": "GB",
        "roles": ["director"],
        "documents": {
          "passport": {
            "file_id": "doc-004",
            "file_name": "sarah-chen-passport.pdf",
            "file_type": "application/pdf",
            "uploaded_at": "2026-01-15T12:00:00.000Z",
            "status": "accepted",
            "acceptance_reason": "validation_passed",
            "download_url": "https://s3.amazonaws.com/..."
          }
        }
      }
    ],
    "entities": [
      {
        "id": "entity-001",
        "source": "user_added",
        "name": "Acme Holdings Ltd",
        "type": "holding_company",
        "country": "GB",
        "documents": {}
      }
    ],
    "ownership": [
      {
        "id": "own-001",
        "owner_type": "person",
        "owner_id": "person-001",
        "owned_type": "target",
        "percentage": 40,
        "is_direct": true,
        "is_nominee": false
      },
      {
        "id": "own-002",
        "owner_type": "entity",
        "owner_id": "entity-001",
        "owned_type": "target",
        "percentage": 60,
        "is_direct": true,
        "is_nominee": false
      },
      {
        "id": "own-003",
        "owner_type": "person",
        "owner_id": "person-001",
        "owned_type": "entity",
        "owned_id": "entity-001",
        "percentage": 100,
        "is_direct": true,
        "is_nominee": false
      }
    ],
    "documents": {
      "bank_statement": {
        "file_id": "doc-002",
        "file_name": "acme-bank-statement-dec-2025.pdf",
        "file_type": "application/pdf",
        "uploaded_at": "2026-01-15T11:05:00.000Z",
        "status": "accepted",
        "acceptance_reason": "validation_passed",
        "download_url": "https://s3.amazonaws.com/..."
      }
    },
    "meta": {
      "primary_contact": {
        "name": "Sophie Mitchell",
        "email": "sophie@acme.com",
        "role": "CFO"
      },
      "registry_sources": ["companies_house"],
      "website_favicon": "https://acmefinancial.co.uk/favicon.ico",
      "web_extracted_industry": "Financial Services"
    }
  },
  "participants": [
    {
      "email": "sophie@acme.com",
      "name": "Sophie Mitchell",
      "role": "primary",
      "link": "https://app.klara-ai.com/external/acme/apply/a1b2c3d4e5f6g7h8"
    }
  ],
  "registry_documents": [
    {
      "id": "990e8400-e29b-41d4-a716-446655440004",
      "source": "companies_house",
      "document_type": "NEWINC",
      "filing_date": "2018-02-01",
      "fetched_at": "2026-01-15T10:31:12.000Z",
      "download_url": "https://s3.amazonaws.com/..."
    },
    {
      "id": "aa0e8400-e29b-41d4-a716-446655440005",
      "source": "companies_house",
      "document_type": "AA",
      "filing_date": "2025-09-30",
      "fetched_at": "2026-01-15T10:31:15.000Z",
      "download_url": "https://s3.amazonaws.com/..."
    }
  ],
  "registry_documents_status": "complete",
  "created_at": "2026-01-15T10:30:00.000Z",
  "submitted_at": "2026-01-16T14:20:00.000Z",
  "completed_at": null
}

Presigned download URLs embedded in documents (including registry documents) expire after 60 seconds. Generate fresh URLs by re-fetching the application if needed.

Errors

Status	Error	Cause
`401`	`Invalid API key`	API key is invalid, expired, or inactive
`401`	`API key missing required scopes: applications:read`	Key lacks the required scope
`404`	`Application not found`	Application does not exist or belongs to a different organization
`500`	`Internal server error`	An unexpected error occurred

Overview

Applications

Reference

Authentication

Path parameters

Response

Examples

Errors

​Authentication

​Path parameters

​Response

​Examples

​Errors

Authentication

Path parameters

Response

Examples

Errors