Aller au contenu principal
Piloterr
Retour à la bibliothèque

API TDLR License

Récupère une licence TDLR par id de détail ou URL SearchResultDetail, avec statut, sous-type, DBA et notes.

Actif1 crédit = 1 requêteGET/v2/tdlr/license

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

Récupère une licence TDLR. La réponse est un objet plat. Elle reprend les champs d'une ligne de recherche et remplit ce que la liste laisse vide : statut, sous-type, DBA, date de première délivrance et notes.

GET https://api.piloterr.com/v2/tdlr/license?query=AIRREF00000564

En-tête : x-api-key.

query est obligatoire. Exemple : AIRREF00000564. L'URL SearchResultDetail de la recherche fonctionne aussi : https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?1=AIRREF00000564.

detail_id et license_number correspondent à la ligne de recherche. Ici ils valent AIRREF00000564 et TACLA00000564E.

ParamètresLink to Paramètres

query est obligatoire. Exemple : AIRREF00000564, ou l'URL SearchResultDetail de results[].url.

Champs de réponseLink to Champs de réponse

license_number, detail_id, url, name, business_name, county, expiration_date, license_type et license_type_code correspondent à la ligne de recherche. Le libellé de type sur la page de détail peut être plus long que le titre de la liste. Cet enregistrement dit Air Conditioning/Refrigeration Contractor ici et Air Conditioning Contractors dans la liste.

status est le statut, par exemple Active. subtype est le code imprimé sur la carte, par exemple AE. dba est le nom commercial. Sur cet enregistrement il rejoint business_name. original_issue_date est la date de première délivrance, par exemple 08/16/1984.

notes est une liste de chaînes. Cet enregistrement contient No Public Contracting. city, postal_code et phone restent null quand la page de détail ne les imprime pas.

Cas d'usageLink to Cas d'usage

  • Un gestionnaire d'immeuble confirme que TACLA00000564E est Active et lit le DBA avant de planifier une réparation.
  • Un lecteur d'offres vérifie notes pour une ligne telle que No Public Contracting avant d'attribuer un marché public.
  • Un dossier de conformité conserve original_issue_date et subtype, absents de la ligne de recherche.

Codes d'erreurLink to Codes d'erreur

  • 400 : query n'est ni un id de détail ni une URL SearchResultDetail.
  • 404 : la page n'a pas de carte de licence.
  • 401 : clé API absente.

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus