Companify API v1

Companify API は、会社法人の設立と、その後の運営に必要な最低限のバックオフィス業務を、プログラムから扱うための API です。対象は Companify 本体と同じで、会社 1 件を Company Document（JSON）として出し入れします。

現在提供しているのは設立の範囲（会社の情報、設立登記の書類の生成と確定状態、設立後の届出）です。 会社の運営に関わる操作は、同じ Company Document と同じ認証のもとで順次追加します。 ベース URL は https://companify.app/api/v1。応答はすべて JSON で、PDF を返すエンドポイントだけ application/pdf です。アルファ版のため、形式は予告のうえで変更することがあります。

• 認証
• Company Document
• エンドポイント
• エラー
• openapi.json
• JSON Schema

認証

API キーを Authorization: Bearer <key> ヘッダで送ります。キーはログイン後の アカウント設定 で自分で作成し、同じ画面で失効できます。キーの値が表示されるのは作成時の 1 回だけです。

curl https://companify.app/api/v1/me \
  -H "Authorization: Bearer <key>"

キーはユーザに紐づきます。操作できるのは、そのユーザが社員になっている会社だけです（Web と同じ範囲）。 利用者が作成するキーにはスコープが付かず、そのユーザができる操作はすべて行えます。 スコープ（company:read, company:write, document:generate, document:confirm, filing:write）が付いたキーでは、付いていない操作が 403 になります。

書類の確定を含め、Web でできる操作は API からも行えます。確定は入力内容のハッシュを記録する操作なので、 先に PDF か Company Document の内容を確認してから呼んでください。API キー経由の書き込みはすべて操作履歴（events）に記録されます。

認証なしで使えるのは、リクエスト本文から PDF を生成する POST /documents/{type}、入力が揃っているかを検査する POST /validate、それに GET /openapi.json です。

Company Document

会社 1 件を、この 1 つの JSON で表します。GET /companies/{id} がこの形式で返します。下書きと同じく空の値を許すので、入力の途中でも保存できます。 書類を生成できる状態かどうかは /check と /validate が判定します。

{
  "$schema": "https://companify.app/schema/company.v1.json",
  "company": {
    "tradeName": "合同会社サンプル",
    "tradeNameKana": "ゴウドウガイシャサンプル",
    "tradeNameRoman": "Sample LLC",
    "businessPurposes": ["ソフトウェアの企画、開発及び販売", "前各号に附帯又は関連する一切の事業"],
    "headOfficeAddress": { "postalCode": "150-0001", "prefecture": "東京都", "city": "渋谷区", "street": "神宮前1-1-1", "building": "" },
    "capitalAmount": 1000000,
    "fiscalYearStartMonth": 4,
    "plannedIncorporationDate": "2026-10-15",
    "articlesDate": "2026-10-01"
  },
  "members": [
    {
      "familyName": "山田", "givenName": "太郎", "familyNameKana": "ヤマダ", "givenNameKana": "タロウ",
      "address": { "postalCode": "150-0001", "prefecture": "東京都", "city": "渋谷区", "street": "神宮前1-1-1" },
      "investmentAmount": 1000000, "isManagingMember": true, "isRepresentative": true,
      "paidAmount": 1000000, "paidAt": "2026-10-02"
    }
  ],
  "teikanOptions": {
    "publicNotice": { "kind": "official_gazette" },
    "representativeSelection": { "kind": "mutual_election" },
    "memberChangeRule": "unanimous",
    "profitDistribution": { "kind": "by_investment" },
    "inheritanceSuccession": true,
    "managingMemberTerm": { "kind": "none" },
    "managingMemberCompensation": "not_specified",
    "executionDecisionMethod": "majority",
    "includeAmendmentDissolutionChapter": true
  },
  "filingAnswers": { "paysSalary": "yes", "under10Payees": "yes", "hiresEmployees": "no", "businessCustomers": "unknown" },
  "confirmations": [ { "documentType": "teikan", "sourceHash": "3f2a…", "confirmedAt": "2026-10-01T09:00:00.000Z" } ],
  "meta": { "id": "clx…", "status": "incorporating", "corporateNumber": null, "incorporatedAt": "2026-10-15", "updatedAt": "2026-10-16T01:23:45.000Z" }
}

JSON Schema は /schema/company.v1.json にあります。商号の位置や代表社員の条件のように Schema で表せない規則はサーバが検査します。Schema は緩めに定義し、サーバの判定を正とします。

エンドポイント

エラー

失敗はすべて application/problem+json（RFC 9457）で返します。 入力した値（氏名・住所・商号）はエラー応答にもログにも含めません。type はこのページの該当行へのリンクです。

{
  "type": "https://companify.app/docs/api#error-incomplete",
  "title": "入力が揃っていません",
  "status": 400,
  "detail": "書類を生成するには、不足している項目の入力が必要です",
  "errors": [
    { "path": "company.tradeNameKana", "message": "必須" },
    { "path": "members.1.address.postalCode", "message": "郵便番号は 123-4567 形式" }
  ]
}

呼び出し回数の上限は WAF で設けています。上限を超えると 429 が返ります（この応答だけは problem+json ではありません）。