Registry Verify : Vérification d'une entreprise dans les registres de Floride
Registry Verify interroge les données publiques de dépôt de la Division des sociétés de Floride (Florida Division of Corporations) pour un nom d'entreprise et renvoie les dépôts correspondants avec le fichier source d'où chacun provient. Pour chaque dépôt, il indique également l'état d'origine mentionné dans le registre de Floride, si le dépôt est à jour avec son rapport annuel en Floride, et le dernier changement de statut que nous avons enregistré. Utilisez-le comme étape de registre d'une vérification Connaître Votre Entreprise (Know Your Business).
Quand l'utiliser
- Avant de payer une facture, de signer un contrat ou d'intégrer un fournisseur ou un client dont l'entreprise est située en Floride.
- Lorsqu'un utilisateur demande si une entreprise est enregistrée, active ou inactive en Floride, ou qui est son agent enregistré ou ses dirigeants.
- Lorsqu'un utilisateur demande si une société de Floride a déposé son rapport annuel de l'année en cours, ou si la Floride peut la dissoudre pour non-dépôt.
- Lorsqu'une société d'un autre État (par exemple "une LLC du Delaware") déclare faire affaire en Floride. La Floride enregistre celles-ci en tant que dépôts étrangers.
Quand ne pas l'utiliser
- L'entreprise n'a aucun lien avec la Floride. La couverture est limitée à la Floride uniquement, donc une recherche ne vous apprend rien sur les autres États.
- Vous devez vérifier une personne physique, filtrer les sanctions ou consulter le crédit. Il s'agit uniquement d'une consultation de registre.
- Vous n'avez pas de budget pour l'appel. Chaque consultation est payante. Si l'utilisateur n'a pas autorisé une dépense, demandez avant de payer.
Effectuer l'appel
Envoyez une requête GET à l'URL de facturation Proceeds. Mettez le nom légal de l'entreprise dans name, encodé pour URL.
GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Publix%20Super%20Markets
Optionnel : limit de 1 à 5 définit le nombre de dépôts candidats renvoyés (par défaut 5).
Optionnel : home_state prend un code d'État américain à deux lettres, comme DE, lorsque l'utilisateur pense déjà que l'entreprise a été constituée dans cet État. Les dépôts constitués là-bas sont listés en premier, et la réponse indique clairement quand aucun enregistrement en Floride n'a été trouvé pour une société constituée dans cet État.
GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Acme%20Holdings&home_state=DE
Le paiement fonctionne comme toute ressource x402 version 2 :
- La première requête renvoie
402 Payment Required. Le corps JSON et l'en-têtePAYMENT-REQUIREDlistent les paiements acceptés : réseau, actif, montant et destinataire. - Votre client x402 signe le paiement et répète la même requête avec le paiement joint.
- Proceeds règle le paiement et renvoie notre réponse JSON.
Lisez le réseau et le montant dans la réponse 402. Ne les supposez pas. Le prix est de 0,10 USDC (montant 100000, six décimales).
Le paiement s'effectue sur le réseau principal Base (eip155:8453), donc une consultation est payée en USDC réel. Lisez quand même le réseau dans la réponse 402, et dites à l'utilisateur qu'il dépense de l'argent réel avant de payer.
Proceeds documente les portefeuilles d'agents compatibles sur https://docs.myproceeds.xyz/agents/overview.md
Appelez uniquement l'URL de facturation Proceeds. Aucune autre route Registry Verify n'accepte les paiements, et aucune clé API n'est délivrée aux acheteurs.
Ce que contient une réponse payée
Chaque réponse payée contient ces parties :
matches: jusqu'à cinq dépôts candidats en Floride, le nom le plus proche en premier. Chacun porte ses propres champs (numéro de document, nom, statut, type et date de dépôt, ville et code postal principaux, agent enregistré, dirigeants), le fichier source de Floride dont il provient, son état d'origine, l'état de son rapport annuel et son historique de statut.dataset: ce que nous avons recherché. La couverture, les dates des fichiers quotidiens de Floride les plus anciens et les plus récents que nous détenons, quand nous avons chargé les données pour la dernière fois, et si les données sont obsolètes.history_begins_onethistory_note: la première date couverte par notre historique de changements de statut, et ce que cela signifie pour les dépôts plus anciens.same_name_across_home_states: chaque nom qu'un dépôt de Floride et un dépôt constitué dans un autre État partagent dans ces résultats. Il s'agit d'une liste vide lorsqu'il n'y en a pas.home_state_query: présent uniquement lorsque vous avez envoyéhome_state. Il indique combien de ces dépôts nomment cet État comme leur état d'origine.result_interpretation: une phrase chacun sur ce que signifient une correspondance, une absence de correspondance, un statut, un score de similarité et un état d'origine.
Lire la réponse
{
"query": "walmart",
"match_count": 1,
"matches": [
{
"doc_number": "849374",
"name": "WALMART INC.",
"status": "<A ou I>",
"status_label": "<Actif ou Inactif>",
"status_as_reported_by": "Florida Division of Corporations",
"filing_type": "<code type de dépôt>",
"filing_type_label": "<type de dépôt en mots>",
"file_date": "<AAAA-MM-JJ>",
"principal_city": "<ville>",
"principal_zip": "<code postal>",
"ra_name": "<agent enregistré>",
"officers": [{"title": "<code>", "type": "<P ou C>", "name": "<nom>", "address": "<rue>", "city": "<ville>", "state": "<état>", "zip": "<code postal>"}],
"more_than_six_officers": "<true ou false>",
"similarity": "<0 à 1>",
"similarity_basis": "<ce que la similarité compare>",
"source_file": "<nom du fichier source de Floride>",
"provenance": {
"source": "<Archive corporative trimestrielle officielle de Floride ou dépôt quotidien>",
"publisher": "Florida Division of Corporations",
"file": "<nom du fichier source de Floride>",
"official_source_url": "https://dos.fl.gov/sunbiz/other-services/data-downloads/"
},
"state_country": "<code de l'état d'origine tel que conservé dans le registre de Floride>",
"home_state": {
"code": "<code à deux lettres du registre de Floride, ou null>",
"name": "<l'état en mots, ou null quand nous ne pouvons pas lire le code>",
"is_florida": "<true ou false>",
"code_decoded": "<true ou false>",
"official_search_url": "<recherche officielle de cet état, ou null>",
"official_search_authority": "<le bureau qui tient ce registre, ou null>",
"sentence": "<phrase simple sur le lieu de constitution de l'entreprise>"
},
"annual_reports": [{"year": "<AAAA>", "filed_on": "<AAAA-MM-JJ>"}],
"annual_report": {
"state": "<déposé, dû, en retard, date_dissolution_passée, pas_encore_dû, inactif, inconnu, ou règle_non_vérifiée>",
"current_year": "<AAAA>",
"current_year_filed": "<true, false, ou null>",
"latest_year": "<AAAA ou null>",
"latest_filed_on": "<AAAA-MM-JJ ou null>",
"due_by": "<1er mai de cette année>",
"dissolution_date": "<quatrième vendredi de septembre de cette année>",
"sentence": "<phrase simple sur le rapport annuel>",
"source_file": "<fichier de Floride où les rapports ont été lus>",
"source_file_date": "<AAAA-MM-JJ ou null>",
"data_refreshed_at": "<date de fin de notre dernière importation>",
"rule_sources": ["<Sections des Statuts de Floride>", "https://dos.fl.gov/sunbiz/manage-business/efile/annual-report/"]
},
"history": {
"first_seen_on": "<AAAA-MM-JJ ou null>",
"history_begins_on": "<AAAA-MM-JJ ou null>",
"last_status_change": {"date": "<AAAA-MM-JJ>", "status": "<A ou I>", "status_label": "<Actif ou Inactif>", "source_file": "<fichier quotidien de Floride>"},
"older_than_history": "<true ou false>",
"note": "<phrase simple sur la fenêtre d'historique>"
}
}
],
"dataset": {
"jurisdiction": "Florida",
"coverage": "<instantané_corporatif_trimestriel_avec_mises_à_jour_quotidiennes ou fichiers_quotidiens_partiels>",
"complete_registry": false,
"quarterly_snapshot_loaded": "<true ou false>",
"authoritative_no_match": false,
"record_count": "<enregistrements que nous détenons>",
"source_file_count": "<fichiers de Floride chargés>",
"quarterly_source_file_count": "<fichiers de l'instantané trimestriel>",
"represented_daily_source_file_count": "<fichiers quotidiens>",
"source_file_date_start": "<AAAA-MM-JJ>",
"source_file_date_end": "<AAAA-MM-JJ>",
"latest_event_source_file": "<fichier d'événement de statut le plus récent de Floride>",
"latest_event_file_date": "<AAAA-MM-JJ>",
"source_retrieved_at": "<date de notre dernier téléchargement depuis la Floride>",
"last_ingested_at": "<date de fin de notre dernière importation>",
"expected_source_records": "<enregistrements attendus par notre dernière importation>",
"imported_records": "<enregistrements importés>",
"quarantined_records": "<enregistrements mis de côté : sans numéro de document ni nom, ou avec une date de dépôt future>",
"import_status": "<résultat de la dernière importation>",
"stale": "<true ou false>",
"warning": "<phrase simple sur la couverture>"
},
"history_begins_on": "<AAAA-MM-JJ ou null>",
"history_note": "<phrase simple sur jusqu'où remonte notre historique>",
"same_name_across_home_states": [
{
"normalized_name": "<nom avec casse, ponctuation, et LLC ou INC supprimés>",
"florida": [{"doc_number": "<doc>", "name": "<nom>"}],
"out_of_state": [{"doc_number": "<doc>", "name": "<nom>", "home_state_code": "<code>", "home_state_name": "<état>"}],
"sentence": "<phrase simple sur une entreprise enregistrée deux fois>"
}
],
"home_state_query": {
"requested": "<le code que vous avez envoyé>",
"requested_name": "<cet état en mots, ou null>",
"code_decoded": "<true ou false>",
"match_count_from_there": "<combien de ces dépôts nomment cet état d'origine>",
"doc_numbers_from_there": ["<doc>"],
"official_search_url": "<recherche officielle de cet état, ou null>",
"official_search_authority": "<le bureau qui tient ce registre, ou null>",
"sentence": "<phrase simple répondant à la question interétatique>"
},
"result_interpretation": {"match": "...", "no_match": "...", "status": "...", "similarity": "...", "home_state": "..."}
}
Les chevrons marquent les valeurs qui proviennent du dépôt de Floride ou de nos données. Le document 849374 est WALMART INC., un bon premier test.
Le dépôt
doc_numberest le numéro de document de Floride. Citez-le lorsque vous rapportez le résultat. N'importe qui peut le vérifier sur Sunbiz.statusest ce que la Floride rapporte :Aactif,Iinactif.status_as_reported_bynomme qui le rapporte, la Florida Division of Corporations.filing_typecommençant parFORsignifie une entreprise d'un autre État enregistrée en Floride.file_dateest alors la date de son enregistrement en Floride, pas la date de sa constitution.officersliste jusqu'à six dirigeants ou gérants avec leurs titres et adresses tels que le registre de Floride les conserve.more_than_six_officersest vrai lorsque le registre de Floride indique que le dépôt en a plus.similaritycompare uniquement les noms. Il va de 0 à 1. Ce n'est pas une confiance que vous avez trouvé la bonne entreprise.similarity_basisindique ce qui a été comparé.source_fileetprovenance.filenomment le fichier source de Floride dont l'enregistrement provient.provenancenomme également l'éditeur et inclut un lien vers la page de téléchargement des données de la Division.
État d'origine
home_stateest l'état d'origine que le propre registre de Floride nomme pour le dépôt. Pour une société de Floride, c'est la Floride. Pour une société d'un autre État, c'est l'endroit où la société a été constituée, avec le bureau qui tient ce registre et un lien vers sa recherche officielle. Lisezhome_state.sentenceet citez-le.state_countryest le code brut tel que le registre de Floride le conserve.home_state.code_decodedest faux lorsque le registre de Floride porte un code qui n'est pas un code d'État américain,OCentre autres. La Floride publie le champ mais pas les codes qu'elle utilise, donc nous renvoyons le code et disons que nous ne savons pas ce qu'il signifie. Ne devinez pas, et ne dites pas à l'utilisateur qu'il s'agit d'un pays. Lisez plutôtprincipal_cityetprincipal_zipdu dépôt, qui sont déjà dans la réponse, et dites où le registre de Floride situe l'entreprise plutôt que ce que le code pourrait signifier.same_name_across_home_statesliste chaque nom qu'un dépôt de Floride et un dépôt d'un autre État dans ces résultats partagent une fois la casse, la ponctuation et la forme juridique supprimées. Cela signifie souvent qu'une entreprise s'est enregistrée deux fois, une fois là où elle a été constituée et une fois en Floride. Cela peut aussi être deux entreprises sans lien, donc vérifiez un deuxième fait avant de les fusionner.home_state_queryest présent uniquement lorsque vous avez envoyéhome_state. Il indique combien de ces dépôts nomment cet État et, quand aucun ne le fait, qu'aucun enregistrement en Floride n'a été trouvé pour une société constituée dans cet État.
Rapport annuel
La Floride exige un rapport annuel entre le 1er janvier et le 1er mai de chaque année suivant l'année du dépôt. Un dépôt toujours manquant le troisième vendredi de septembre est dissous le quatrième vendredi de septembre, ou, pour une société constituée dans un autre État, son enregistrement en Floride est révoqué.
annual_report.sentenceindique ce que les fichiers de Floride montrent concernant le rapport de cette année. Lisez-le et citez-le.annual_report.stateest l'un des suivants :filed: le rapport de l'année en cours est déposé. La phrase indique quand, et s'il est arrivé après la date limite du 1er mai.due: le rapport de l'année en cours n'est pas encore déposé et le 1er mai n'est pas passé.late: le 1er mai est passé et le rapport de l'année en cours n'est pas déposé. La Floride dissout ou révoque àannual_report.dissolution_dates'il est toujours manquant.dissolution_date_passed: cette date de septembre est passée sans le rapport. Le statut dans notre réponse peut ne pas montrer la dissolution avant que nous chargions le prochain fichier trimestriel de la Floride, et la phrase le mentionne.not_due_yet: le dépôt a été effectué cette année, donc son premier rapport est dû l'année prochaine.inactive: la Floride liste le dépôt comme inactif, donc il ne doit aucun rapport.unknownourule_not_checked: nous ne pouvons pas le dire. La phrase explique pourquoi.
due_byetdissolution_datesont les deux dates de cette année.latest_yearetlatest_filed_oncorrespondent au rapport le plus récent déposé.current_year_filedest vrai ou faux, ou null quand nous ne pouvons pas le dire ou qu'aucun rapport n'est encore dû.source_fileetsource_file_datenomment le fichier de Floride d'où les rapports ont été lus.data_refreshed_atcorrespond à la date de fin de notre dernière importation.rule_sourceslie les sections des Statuts de Floride et la page Sunbiz d'où provient la règle.annual_reportsest une liste des années pour lesquelles un rapport a été déposé, avec la date de dépôt. Elle est vide quand aucun rapport n'a jamais été déposé.