registry-verify

Registry Verify: 事業者をフロリダ州の記録と照合する

Registry Verifyは、フロリダ州事業者登録局（Florida Division of Corporations）の公開申請データから事業者名を検索し、一致する申請とそのソースファイルを返します。各申請について、フロリダ州の記録に記載された本拠地州、年次報告書の提出状況、直近のステータス変更履歴も提供します。KYB（Know Your Business）確認のレジストリステップとして使用してください。

使用するケース

• フロリダ州にある事業者への請求書支払い、契約締結、またはベンダー・顧客のオンボーディング前。
• ユーザーが、ある会社がフロリダ州で登録済みか、アクティブか、非アクティブか、あるいは登録代理人や役員は誰かを尋ねた場合。
• ユーザーが、フロリダ州の会社が今年の年次報告書を提出したか、または報告書未提出によりフロリダ州がその会社を解散させる可能性があるかを尋ねた場合。
• 他州の会社（例：「デラウェア州LLC」）がフロリダ州で事業を行っていると述べた場合。フロリダ州はこれらを外国法人申請として登録します。

使用すべきでないケース

• 事業者がフロリダ州と関係がない場合。カバレッジはフロリダ州のみであり、検索結果は他州については何も示しません。
• 個人の確認、制裁対象スクリーニング、または信用調査が必要な場合。これはあくまでレジストリ検索です。
• 呼び出しの予算がない場合。すべての検索は支払いを伴います。ユーザーが支出を承認していない場合は、支払い前に確認を取ってください。

呼び出しを実行する

ProceedsチャージURLに1つのGETリクエストを送信します。法的な事業者名をnameにURLエンコードして指定します。

GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Publix%20Super%20Markets

オプション：limit（1～5）で返される候補申請の数を設定します（デフォルトは5）。

オプション：home_stateには2文字の米国州コード（例：DE）を指定します。ユーザーがその会社が当該州で設立されたと既に確信している場合に使用します。その州で設立された申請が最初にリストされ、その州で設立された会社についてフロリダ州の登録が見つからなかった場合には、その旨が明確に回答に含まれます。

GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Acme%20Holdings&home_state=DE

支払いは、任意のx402バージョン2リソースと同様に機能します。

1. 最初のリクエストは402 Payment Requiredを返します。JSON本文とPAYMENT-REQUIREDヘッダーに、受け入れ可能な支払い方法（ネットワーク、アセット、金額、受取人）がリストされます。
2. x402クライアントが支払いに署名し、支払いを添付して同じリクエストを再送信します。
3. Proceedsが支払いを決済し、JSON回答を返します。

402レスポンスからネットワークと金額を読み取ってください。それらを想定しないでください。価格は0.10 USDC（金額は100000、小数点以下6桁）です。

ペイウォールはBaseメインネット（eip155:8453）上で動作するため、検索は実際のUSDCで支払われます。それでも402レスポンスからネットワークを読み取り、支払い前にユーザーに実際の資金を支出することを伝えてください。

Proceedsは、互換性のあるエージェントウォレットをhttps://docs.myproceeds.xyz/agents/overview.md で文書化しています。

ProceedsチャージURLのみを呼び出してください。他のRegistry Verifyルートは支払いを受け付けず、購入者にAPIキーは発行されません。

1回の有料回答に含まれるもの

すべての有料回答には以下の部分が含まれます。

• matches: 最大5件のフロリダ州申請候補。最も近い名前順。各候補には、申請自体のフィールド（文書番号、名称、ステータス、申請種類と日付、主要都市と郵便番号、登録代理人、役員）、それが由来するフロリダ州のソースファイル、本拠地州、年次報告ステータス、ステータス履歴が含まれます。
• dataset: 検索対象。カバレッジ、保有する最古および最新のフロリダ州日次ファイルの日付、最終データ読み込み日時、データが古いかどうか。
• history_begins_on および history_note: ステータス変更履歴がカバーする最初の日付と、それが古い申請にとって何を意味するか。
• same_name_across_home_states: フロリダ州の申請と他州で設立された申請の両方がこれらの結果で保持する各名称。該当がない場合は空のリスト。
• home_state_query: home_stateを送信した場合のみ存在。これらの申請のうち、その州を本拠地州として指定しているものの数。
• result_interpretation: 一致、不一致、ステータス、類似度スコア、本拠地州のそれぞれについて一文で説明。

回答を読む

{
  "query": "walmart",
  "match_count": 1,
  "matches": [
    {
      "doc_number": "849374",
      "name": "WALMART INC.",
      "status": "<A or I>",
      "status_label": "<Active or Inactive>",
      "status_as_reported_by": "Florida Division of Corporations",
      "filing_type": "<filing type code>",
      "filing_type_label": "<filing type in words>",
      "file_date": "<YYYY-MM-DD>",
      "principal_city": "<city>",
      "principal_zip": "<zip>",
      "ra_name": "<registered agent>",
      "officers": [{"title": "<code>", "type": "<P or C>", "name": "<name>", "address": "<street>", "city": "<city>", "state": "<state>", "zip": "<zip>"}],
      "more_than_six_officers": "<true or false>",
      "similarity": "<0 to 1>",
      "similarity_basis": "<what the similarity compares>",
      "source_file": "<Florida source file name>",
      "provenance": {
        "source": "<Official Florida quarterly corporate archive or daily filing>",
        "publisher": "Florida Division of Corporations",
        "file": "<Florida source file name>",
        "official_source_url": "https://dos.fl.gov/sunbiz/other-services/data-downloads/"
      },
      "state_country": "<home state code as Florida's record holds it>",
      "home_state": {
        "code": "<two letter code from Florida's record, or null>",
        "name": "<the state in words, or null when we cannot read the code>",
        "is_florida": "<true or false>",
        "code_decoded": "<true or false>",
        "official_search_url": "<that state's official business search, or null>",
        "official_search_authority": "<the office that keeps that register, or null>",
        "sentence": "<plain sentence about where the company was formed>"
      },
      "annual_reports": [{"year": "<YYYY>", "filed_on": "<YYYY-MM-DD>"}],
      "annual_report": {
        "state": "<filed, due, late, dissolution_date_passed, not_due_yet, inactive, unknown, or rule_not_checked>",
        "current_year": "<YYYY>",
        "current_year_filed": "<true, false, or null>",
        "latest_year": "<YYYY or null>",
        "latest_filed_on": "<YYYY-MM-DD or null>",
        "due_by": "<1 May of this year>",
        "dissolution_date": "<fourth Friday of September this year>",
        "sentence": "<plain sentence about the annual report>",
        "source_file": "<Florida file the reports were read from>",
        "source_file_date": "<YYYY-MM-DD or null>",
        "data_refreshed_at": "<when our last import finished>",
        "rule_sources": ["<Florida Statutes sections>", "https://dos.fl.gov/sunbiz/manage-business/efile/annual-report/"]
      },
      "history": {
        "first_seen_on": "<YYYY-MM-DD or null>",
        "history_begins_on": "<YYYY-MM-DD or null>",
        "last_status_change": {"date": "<YYYY-MM-DD>", "status": "<A or I>", "status_label": "<Active or Inactive>", "source_file": "<Florida daily file>"},
        "older_than_history": "<true or false>",
        "note": "<plain sentence about the history window>"
      }
    }
  ],
  "dataset": {
    "jurisdiction": "Florida",
    "coverage": "<quarterly_corporate_snapshot_with_daily_updates or partial_daily_files>",
    "complete_registry": false,
    "quarterly_snapshot_loaded": "<true or false>",
    "authoritative_no_match": false,
    "record_count": "<records we hold>",
    "source_file_count": "<Florida files loaded>",
    "quarterly_source_file_count": "<files from the quarterly snapshot>",
    "represented_daily_source_file_count": "<daily files>",
    "source_file_date_start": "<YYYY-MM-DD>",
    "source_file_date_end": "<YYYY-MM-DD>",
    "latest_event_source_file": "<newest Florida status event file>",
    "latest_event_file_date": "<YYYY-MM-DD>",
    "source_retrieved_at": "<when we last downloaded from Florida>",
    "last_ingested_at": "<when our last import finished>",
    "expected_source_records": "<records our last import expected>",
    "imported_records": "<records it imported>",
    "quarantined_records": "<records it set aside: no document number or name, or a future filing date>",
    "import_status": "<result of the last import>",
    "stale": "<true or false>",
    "warning": "<plain sentence about coverage>"
  },
  "history_begins_on": "<YYYY-MM-DD or null>",
  "history_note": "<plain sentence about how far back our history goes>",
  "same_name_across_home_states": [
    {
      "normalized_name": "<name with case, punctuation, and LLC or INC removed>",
      "florida": [{"doc_number": "<doc>", "name": "<name>"}],
      "out_of_state": [{"doc_number": "<doc>", "name": "<name>", "home_state_code": "<code>", "home_state_name": "<state>"}],
      "sentence": "<plain sentence about one business registering twice>"
    }
  ],
  "home_state_query": {
    "requested": "<the code you sent>",
    "requested_name": "<that state in words, or null>",
    "code_decoded": "<true or false>",
    "match_count_from_there": "<how many of these filings name that home state>",
    "doc_numbers_from_there": ["<doc>"],
    "official_search_url": "<that state's official business search, or null>",
    "official_search_authority": "<the office that keeps that register, or null>",
    "sentence": "<plain sentence answering the cross state question>"
  },
  "result_interpretation": {"match": "...", "no_match": "...", "status": "...", "similarity": "...", "home_state": "..."}
}

山括弧で囲まれた値は、フロリダ州の申請または当社のデータから取得された値です。文書番号849374はWALMART INC.であり、適切な最初のテストケースです。

申請について

• doc_numberはフロリダ州の文書番号です。結果を報告する際は引用符で囲んでください。誰でもSunbizで確認できます。
• statusはフロリダ州が報告する内容です。Aはアクティブ、Iは非アクティブ。status_as_reported_byは、報告元（フロリダ州事業者登録局）を示します。
• filing_typeがFORで始まる場合は、他州の会社がフロリダ州に登録したことを意味します。この場合、file_dateはフロリダ州への登録日であり、設立日ではありません。
• officersは、フロリダ州の記録が保持する最大6名の役員またはマネージャーとその役職、住所をリストします。フロリダ州の記録にそれ以上の役員がいる場合、more_than_six_officersはtrueになります。
• similarityは名前のみを比較します。0から1の範囲です。これは正しい会社を見つけたという信頼度ではありません。similarity_basisは比較対象を示します。
• source_fileとprovenance.fileは、レコードの由来となったフロリダ州のソースファイルを指定します。provenanceは発行者も示し、同局のデータダウンロードページへのリンクを提供します。

本拠地州

• home_stateは、フロリダ州自身の記録がその申請に対して指定する本拠地州です。フロリダ州の会社の場合はフロリダ州です。他州の会社の場合は、会社が設立された州であり、その登録を管理する役所と公式事業者検索へのリンクが含まれます。home_state.sentenceを読み、引用してください。state_countryは、フロリダ州の記録が保持する生のコードです。
• home_state.code_decodedは、フロリダ州の記録に米国州コードではないコード（OCを含む）が含まれている場合、falseになります。フロリダ州はフィールドを公開していますが、使用するコードは公開していないため、コードを返し、その意味が不明であることを示します。推測せず、またユーザーにそれが国であると伝えないでください。代わりに、申請のprincipal_cityとprincipal_zipを読み、コードが何を表すかではなく、フロリダ州の記録が会社をどこに置いているかを伝えてください。
• same_name_across_home_statesは、大文字小文字、句読点、法的形態を除去した後、フロリダ州の申請と他州の申請がこれらの結果で共有する各名称をリストします。これは多くの場合、1つの事業体が2回登録されていること（設立地とフロリダ州）を意味します。無関係な2つの事業体である可能性もあるため、統合する前に別の事実を確認してください。
• home_state_queryは、home_stateを送信した場合のみ存在します。これらの申請のうちその州を指定しているものの数と、該当がない場合、その州で設立された会社に対するフロリダ州の登録が見つからなかったことを示します。

年次報告書

フロリダ州は、申請が行われた年の翌年から毎年1月1日から5月1日の間に年次報告書の提出を義務付けています。9月の第3金曜日までに提出されていない場合、第4金曜日に解散されます。または、他州で設立された会社の場合は、フロリダ州の登録が抹消されます。

• annual_report.sentenceは、フロリダ州のファイルが今年の報告書について示すことを記載しています。読んで引用してください。
• annual_report.stateは以下のいずれかです。
  • filed: 今年の報告書がファイルされています。文は提出日と、それが5月1日の期限後かどうかを示します。
  • due: 今年の報告書はまだファイルされておらず、5月1日は過ぎていません。
  • late: 5月1日が過ぎており、今年の報告書はファイルされていません。フロリダ州は、それでも提出がない場合、annual_report.dissolution_dateに解散または抹消します。
  • dissolution_date_passed: その9月の日付が報告書なしで経過しました。回答のステータスは、次の四半期ファイルを読み込むまで解散を反映していない可能性があり、その旨が文に記載されます。
  • not_due_yet: 申請は今年行われたため、最初の報告書は来年が期限です。
  • inactive: フロリダ州は申請を非アクティブとしてリストしているため、報告書は不要です。
  • unknown または rule_not_checked: 判断できません。文に理由が記載されます。
• due_byとdissolution_dateは今年の2つの日付です。latest_yearとlatest_filed_onはファイル上の最新の報告書です。current_year_filedはtrue、false、または判断できない場合や報告書がまだ不要な場合はnullです。
• source_fileとsource_file_dateは、報告書の読み取り元となったフロリダ州のファイルを指定します。data_refreshed_atは、最後のインポートが完了した時刻です。rule_sourcesは、フロリダ州法のセクションとルールの出典であるSunbizページへのリンクです。
• annual_reportsは...