Skip to main content
Returns the application record including all form data, documents with presigned download URLs, and participant information. 
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

​
id
string
required
UUID of the application.

​
Response

Returns 200 OK with the full application detail.
​
id
string
UUID of the application.
​
config_id
string
Configuration ID used for this application.
​
status
string
Current status: created, sent, in_progress, submitted, review, approved, rejected.
​
data
object
Application data. Contains the following top-level keys:
​
participants
array
Participants associated with this application.
​
created_at
string
ISO 8601 timestamp.
​
submitted_at
string | null
ISO 8601 timestamp, or null if not yet submitted.
​
completed_at
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"
Response: 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "config_id": "kyc-standard",
  "status": "submitted",
  "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"
    }
  ],
  "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 expire after 60 seconds. Generate fresh URLs by re-fetching the application if needed.

​
Errors

StatusErrorCause
401Invalid API keyAPI key is invalid, expired, or inactive
401API key missing required scopes: applications:readKey lacks the required scope
404Application not foundApplication does not exist or belongs to a different organization
500Internal server errorAn unexpected error occurred