Recherche la liste des licences actives du TDLR au Texas. query est un nom de personne ou d'entreprise. license_type est le code du formulaire. Pour une recherche utile, envoyez un code tel que AIRREF (entrepreneurs en climatisation et réfrigération).
GET https://api.piloterr.com/v2/tdlr/search?query=SMITH&license_type=AIRREF
En-tête : x-api-key.
Chaque page contient 25 lignes. Il faut un nom, une ville, un comté ou un code postal. Un license_type vide interroge tous les types et sert rarement. Une URL de détail se passe à /v2/tdlr/license et renvoie 400 ici.
Les lignes de recherche laissent status, subtype, dba et original_issue_date vides. Ces champs sont sur l'endpoint licence.
query est facultatif si city, county ou postal_code est présent. Exemple : SMITH.
license_type est facultatif pour la requête et nécessaire pour une recherche utile. Exemple : AIRREF. ALL ou une valeur vide interroge tous les types. Un code qui n'a pas 2 à 12 lettres ou chiffres renvoie 400.
city est facultatif. Exemple : Austin.
county est facultatif. Exemple : TRAVIS.
postal_code est facultatif. Exemple : 78701.
page est facultatif, 1 par défaut. Exemple : 2.
Au moins un de query, city, county ou postal_code est obligatoire.
license_number est la licence publique, par exemple TACLA00000564E. detail_id est la clé de détail TDLR, par exemple AIRREF00000564. url est le lien SearchResultDetail. Passez detail_id ou url à l'endpoint licence.
name est le titulaire. business_name est l'entreprise quand la liste l'affiche entre parenthèses. expiration_date est la date de la liste, par exemple 12/24/2026. county est le comté. city, postal_code et phone sont remplis quand la liste les montre, et sont souvent null sur ce rapport.
license_type est le titre du jeu de résultats, par exemple Air Conditioning Contractors. license_type_code est le code tiré de detail_id, par exemple AIRREF.
status, subtype, dba et original_issue_date sont null sur une ligne de liste normale. notes est une liste vide. L'appel licence les remplit.
pagination.per_page vaut 25. pagination.page commence à 1. pagination.total_results est le nombre de "records retrieved". pagination.total_pages est ce nombre divisé par 25, arrondi au supérieur.
pagination.next est une URL tant que page est inférieur à total_pages. Sur la dernière page, next est null.
Pour SMITH et AIRREF, la liste observée avait 153 enregistrements et 7 pages. Les pages 1 et 2 avaient chacune 25 detail_id distincts, sans recouvrement. La page 7 avait 3 lignes et next était null.
- Un entrepreneur général de Fort Bend vérifie les licences
AIRREF au nom SMITH avant d'embaucher un sous-traitant.
- Un guichet de permis liste les climaticiens du comté de Travis avec
county=TRAVIS et license_type=AIRREF.
- Un assureur parcourt chaque page de 25 lignes et repère les
expiration_date à moins de 90 jours, puis ouvre url parce que la liste omet le statut.
- 400 : ni nom, ni ville, ni comté, ni ZIP, code de type invalide, URL de détail, ou
page inférieur à 1.
- 404 : aucune ligne, ou
page au-delà de la dernière page.
- 401 : clé API absente.