Quick Start

Docs

Quick Start

How to use your API key to access UK company financial data

Learn how to use your API key to get started with the FinUK API.

Endpoint

GET https://finuk.io/api/financial-data

Authentication

Include your API key in the header:

X-API-Key: finuk_60babeb8bd3b6fef743646d12d38f8a4e1811e004c914d6aa661bad8b723184e

Parameters

company_number - UK company number (required)
include_null - Set to 'true' to include null values (optional, default: false)

Example Request

curl -H "X-API-Key: finuk_60babeb8bd3b6fef743646d12d38f8a4e1811e004c914d6aa661bad8b723184e" \
     "https://finuk.io/api/financial-data?company_number=00103285"

Response Structure

The API returns structured financial data for UK companies.

Main Response Format

{
  "company_number": "00103285",
  "latest_financial_report": {
    "financial_period": {
      "start_date": "2023-05-01",
      "end_date": "2024-04-30",
      "report_approved_date": "2024-10-25"
    },
    "registered_address_at_time": {
      "company_name": "Example Company Limited",
      "line1": "123 Business Street",
      "city": "London",
      "postal_code": "SW1A 1AA"
    },
    "company_description_at_time": "Retail trade activities",
    "key_metrics": {
      "turnover": 9328669,
      "gross_profit": 2369699,
      "operating_profit": 66683,
      "net_assets": 2623001,
      "cash_at_bank": 23844,
      "total_assets": 4136143,
      "current_assets": 3813760,
      "current_liabilities": 1513142,
      "creditors": 1076925
    },
    "balance_sheet": {
      "assets": {
        "current_assets": {
          "inventories": 1975276,
          "trade_receivables": 1354207,
          "other_receivables": 588,
          "cash_and_equivalents": 23844,
          "total_current_assets": 3813760
        },
        "total_assets": 4136143,
        "net_current_assets_liabilities": 2300618
      },
      "liabilities": {
        "current_liabilities": {
          "trade_payables": 1076925,
          "total_current_liabilities": 1513142
        },
        "total_liabilities": 1513142
      },
      "net_assets": 2623001,
      "equity": 2623001
    },
    "income_statement": {
      "revenue": 9328669,
      "cost_of_sales": 6958970,
      "gross_profit": 2369699,
      "administrative_expenses": 2353156,
      "operating_profit": 66683
    },
    "ratios": {
      "gross_profit_margin": 0.254,
      "operating_profit_margin": 0.0071,
      "current_ratio": 2.5204,
      "quick_ratio": 1.215,
      "debt_to_equity": 0.5769
    }
  },
  "historical_financial_reports": [...],
  "usage": {
    "monthly_used": 3,
    "monthly_limit": 10,
    "monthly_remaining": 7,
    "additional_credits": 0,
    "total_remaining": 7,
    "plan": "free",
    "reset_date": null,
    "cost_this_request": "included",
    "used_additional_credit": false
  }
}

Usage Information

Every successful response includes usage information:

monthly_used - API requests used this month
monthly_limit - Monthly request limit (10 for free, 9000 for paid)
monthly_remaining - Remaining monthly requests
additional_credits - Extra credits purchased (paid accounts only)
total_remaining - Total remaining requests (monthly + additional)
plan - Account plan type (free/paid)
cost_this_request - Cost for this specific request