parseapi 1.10.0__tar.gz → 1.10.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. {parseapi-1.10.0 → parseapi-1.10.2}/PKG-INFO +5 -45
  2. {parseapi-1.10.0 → parseapi-1.10.2}/README.md +4 -44
  3. {parseapi-1.10.0 → parseapi-1.10.2}/api/public.json +0 -390
  4. {parseapi-1.10.0 → parseapi-1.10.2}/pyproject.toml +1 -1
  5. {parseapi-1.10.0 → parseapi-1.10.2}/smoke/smoke.py +2 -29
  6. {parseapi-1.10.0 → parseapi-1.10.2}/src/parseapi/__init__.py +1 -1
  7. {parseapi-1.10.0 → parseapi-1.10.2}/src/parseapi/_client.py +0 -104
  8. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_client.py +10 -19
  9. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_language.py +1 -3
  10. parseapi-1.10.0/tests/test_tariff.py +0 -92
  11. parseapi-1.10.0/tests/test_tariff_short_id.py +0 -92
  12. {parseapi-1.10.0 → parseapi-1.10.2}/.github/workflows/publish.yml +0 -0
  13. {parseapi-1.10.0 → parseapi-1.10.2}/.github/workflows/test.yml +0 -0
  14. {parseapi-1.10.0 → parseapi-1.10.2}/.gitignore +0 -0
  15. {parseapi-1.10.0 → parseapi-1.10.2}/CHANGELOG.md +0 -0
  16. {parseapi-1.10.0 → parseapi-1.10.2}/LICENSE +0 -0
  17. {parseapi-1.10.0 → parseapi-1.10.2}/scripts/public_api.py +0 -0
  18. {parseapi-1.10.0 → parseapi-1.10.2}/src/parseapi/city.py +0 -0
  19. {parseapi-1.10.0 → parseapi-1.10.2}/src/parseapi/py.typed +0 -0
  20. {parseapi-1.10.0 → parseapi-1.10.2}/tests/bank-fixtures.json +0 -0
  21. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/emoji-artwork.json +0 -0
  22. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/emoji-catalog.json +0 -0
  23. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/measure-response.json +0 -0
  24. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-company-coverage.json +0 -0
  25. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-company-profile.json +0 -0
  26. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-emoji-catalog.json +0 -0
  27. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-emoji-metadata.json +0 -0
  28. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-provider.json +0 -0
  29. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-tariff-search.json +0 -0
  30. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-tariff.json +0 -0
  31. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-time.json +0 -0
  32. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-timezones.json +0 -0
  33. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-company-coverage.json +0 -0
  34. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-company-profile.json +0 -0
  35. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-emoji-catalog.json +0 -0
  36. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-emoji-metadata.json +0 -0
  37. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-provider.json +0 -0
  38. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-tariff-search.json +0 -0
  39. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-tariff.json +0 -0
  40. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-time.json +0 -0
  41. {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-timezones.json +0 -0
  42. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_bank.py +0 -0
  43. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_card_dx.py +0 -0
  44. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_city_canonical.py +0 -0
  45. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_city_quality.py +0 -0
  46. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_city_query_parity.py +0 -0
  47. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_company_directory.py +0 -0
  48. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_email_enrichment.py +0 -0
  49. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_emoji.py +0 -0
  50. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_measure_response.py +0 -0
  51. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_name_formatting.py +0 -0
  52. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_postal_localities.py +0 -0
  53. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_public_api.py +0 -0
  54. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_response_decoding.py +0 -0
  55. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_stack.py +0 -0
  56. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_time_complete.py +0 -0
  57. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_time_gaps.py +0 -0
  58. {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_version.py +0 -0
  59. {parseapi-1.10.0 → parseapi-1.10.2}/tests/typing_company_directory.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: parseapi
3
- Version: 1.10.0
3
+ Version: 1.10.2
4
4
  Summary: Official ParseAPI client for Python. One key, minimal JSON, fast.
5
5
  Project-URL: Homepage, https://parseapi.com
6
6
  Project-URL: Documentation, https://parseapi.com/docs
@@ -64,7 +64,7 @@ Pass `country` when a postal code or national phone number needs disambiguation.
64
64
 
65
65
  Results are plain data. Pass a returned code or coordinate to another operation when the task needs it. Check nullable values before composing the next call.
66
66
 
67
- Use `parse.postal("28202", country="US", deep=True)` for US ZIP tax references. `deep.tax` names the levy and `deep.tax_rate` is a percentage, so `7.9` means 7.9%. The state, county, city and special components explain that combined rate. An exact address can differ. Country and state lookups provide their own geographic reference rates, which should not be added to the ZIP rate. `None` means unknown and `0` means known zero. Country `deep.tax_id_format` and `deep.tax_id_regex` describe registration-number format only. Use `vat` for a metered registration check with `deep` explicitly enabled.
67
+ Use `parse.postal("28202", country="US", deep=True)` for US ZIP tax references. `deep.tax` names the levy and `deep.tax_rate` is a percentage, so `7.9` means 7.9%. The state, county, city and special components explain that combined rate. An exact address can differ. Country and state lookups provide their own geographic reference rates, which should not be added to the ZIP rate. `None` means unknown and `0` means known zero. Country `deep.tax_id_format` and `deep.tax_id_regex` describe registration-number format only. Use for a metered registration check with `deep` explicitly enabled.
68
68
 
69
69
  ## Company directory
70
70
 
@@ -104,10 +104,8 @@ One method per endpoint, named after the route.
104
104
  parse.ip("8.8.8.8")
105
105
  parse.ip.self()
106
106
  parse.email("hello@gmail.com")
107
- parse.vat("DE136695976")
108
107
  parse.bank("DE89370400440532013000")
109
108
  parse.card("424242")
110
- parse.provider("1881018208")
111
109
  parse.phone("+14155552671")
112
110
  parse.carrier("+14155552671")
113
111
  parse.caller("+14155552671")
@@ -137,8 +135,6 @@ parse.state.districts("NC", country="US")
137
135
  parse.district("37081")
138
136
  parse.continent("NA")
139
137
  parse.continent.countries("NA")
140
- parse.bloc("EU")
141
- parse.bloc.countries("EU")
142
138
  parse.currency("USD")
143
139
  parse.currency.rate("USD", "EUR")
144
140
  parse.language("en")
@@ -163,11 +159,8 @@ parse.mx("example.com")
163
159
  parse.dns("example.com")
164
160
  parse.dns("_dmarc.example.com", type="TXT")
165
161
  parse.useragent(ua_string)
166
- parse.vehicle("1HGCM82633A004352")
167
162
  parse.industry("541511")
168
163
  parse.industry.search("coffee shop", limit=5)
169
- parse.tariff("8471.30.01.00")
170
- parse.tariff.search("sunglasses")
171
164
  parse.emoji("rocket")
172
165
  parse.emoji.search("fire")
173
166
  ```
@@ -201,7 +194,7 @@ Choose display names for one request:
201
194
  parse.country("DE", lang="fr")
202
195
  ```
203
196
 
204
- `lang` is optional on geography lookups and their lists/searches, Currency lookup, Language, Date, Time/Timezone, Emoji lookup/search, and unit discovery. IP, ASN, national Company number lookup and NPI also accept it for their geographic labels. Codes, native names, quantities and response structure retain their meanings. Source coverage determines which labels are translated; unavailable labels use the API's documented fallback.
197
+ `lang` is optional on geography lookups and their lists/searches, Currency lookup, Language, Date, Time/Timezone, Emoji lookup/search, and unit discovery. IP, ASN and national Company number lookups also accept it for their geographic labels. Codes, native names, quantities and response structure retain their meanings. Source coverage determines which labels are translated; unavailable labels use the API's documented fallback.
205
198
 
206
199
  The next call keeps its usual default unless it also supplies `lang`. Existing `deep` rules still apply. Date `format` and measurement `locale` remain explicit input-parsing controls.
207
200
 
@@ -287,19 +280,6 @@ Weather returns current conditions by default. Paid deep adds specialist current
287
280
  parse.weather(40.7128, -74.006, deep=True, date="2026-08-15")
288
281
  ```
289
282
 
290
- Tariff starts with the general schedule line. Paid deep adds units and the special and other schedule columns. An optional origin then resolves country-specific measures. The three calls below show those successive choices. Without origin, schedule detail is still returned and origin-dependent fields are null. A null effective rate is not a zero rate.
291
-
292
- Tariff lookup and search accept the `edition` ID returned by Tariff, such as `ted_3`, and an optional `date` (`YYYY-MM-DD`). The edition pins exact immutable source bytes. A date is accepted only when verified source coverage exists. An edition without a date returns undated schedule context (`date: null`). Default requests use today. Paid detail exposes an open-string `reason` when `effective_rate` is null, including `incomplete_coverage`. A null rate never means zero. Explicit selections fail with `tariff_selection_mismatch` if an older server ignores the requested scope.
293
-
294
- Origin means where the goods originate, not where they ship from. The effective rate covers matched stored schedule measures only. It is not complete duty or landed cost.
295
-
296
- Codes contain 4, 6, 8 or 10 ASCII digits; dots and whitespace are optional. Search returns up to 20 description matches with parent `lineage` so a result named "Other" has context. Search is not product classification. In deep, `measures: null` means origin-dependent measures were not resolved. `measures: []` means the resolved lookup found none.
297
-
298
- ```python
299
- parse.tariff("8471.30.01.00")
300
- parse.tariff("8471.30.01.00", deep=True)
301
- parse.tariff("8471.30.01.00", deep=True, origin="CN")
302
- ```
303
283
 
304
284
  Address search uses context from the form: prefer postal, or city and state. An optional end-user `ip` is a locality hint for server-side calls. An empty result explains itself with `reason`: `more_input`, `missing_context` or `no_matches`. With suggestions, reason is null. Older responses may omit it, and future reasons remain strings. Catalog and lookup failures use the existing API errors.
305
285
 
@@ -316,21 +296,6 @@ parse.bank_requirements("US", format="us_ach")
316
296
  parse.bank_us_ach(routing="011000015", account="0001234567")
317
297
  ```
318
298
 
319
- ## Provider lookup
320
-
321
- ```python
322
- provider = parse.provider("1881018208")
323
- profile = parse.provider("1881018208", deep=True)
324
- ```
325
-
326
- Pass the original NPI as a string. `valid` checks its format and checksum; `registered` means a match in the stored NPPES snapshot. `active` reflects recorded NPI deactivation, not licensure. `excluded` is an NPI-only OIG LEIE match; `false` is not a complete exclusion clearance. These directory facts do not verify credentials, current practice contact or payment eligibility.
327
-
328
- Invalid input returns `valid: false` with unknown provider fields. A checksum-valid number missing from the snapshot returns `registered: false`; unavailable storage remains an API error. Preserve `null` as unknown.
329
-
330
- The default pooled lookup includes provider identity, specialty and practice contact where held. Paid `deep` adds `deactivated_at`, `medicare`, `opt_out` and `enrollments` from stored source files, with no separate check meter or live verification. `enrollments: null` means unavailable; `[]` means no enrollment rows are returned. The API omits unrequested `deep` and returns `{}` when requested on Free.
331
-
332
- Paid Deep also returns `taxonomies` in published order, with taxonomy code, specialty label, primary flag and provider-reported license number/state, plus `enumerated_at`, `updated_at` and `reactivated_at` record dates. Reported licenses are not verified licenses. Null lists mean unavailable; empty lists mean the edition contains no entries. Provider record dates describe the provider record. Unknown dates stay null.
333
-
334
299
  ## Deep
335
300
 
336
301
  Choose enrichment for the question you need answered.
@@ -340,12 +305,10 @@ Choose enrichment for the question you need answered.
340
305
  | IP | Richer IP fields included with a paid plan. No separate check meter. |
341
306
  | Domain | Registration dates, registrar, status and DNSSEC, included with a paid plan. Use `dns` for DNS records and `mx` for mail routing. |
342
307
  | Email | A metered mailbox check with deliverability, catch-all, status, reason and address hints, using included email checks or enabled on-demand usage. |
343
- | VAT | A metered registry check where supported, using included VAT checks or enabled on-demand usage. |
344
308
  | Phone, Time, Date, Currency, Language, Emoji, Bank, Point | Optional detail in the same pooled request on every plan. |
345
309
  | Country, State, District, City, Postal | The place profile on paid plans, including demographic and tax facts where held. |
346
310
  | Name, Industry | Name evidence or the industry definition profile on paid plans. |
347
- | NPI | Deactivation date, Medicare enrollment, opt-out and enrollment rows from stored sources on paid plans. Exclusion evidence stays core. |
348
- | Vehicle, Tariff, Company | The complete product detail bag on paid plans. |
311
+ | Company | The complete product detail bag on paid plans. |
349
312
  | Weather | Specialist current measurements and the existing forecast, alert, air and history bag on paid plans. |
350
313
  | Carrier, HLR | Optional diagnostic detail within the same metered core unit, including Free allowance units. No second gate or additional check. |
351
314
 
@@ -389,7 +352,7 @@ parse = ParseAPI(
389
352
 
390
353
  Requires Python 3.9 or later. One dependency (httpx).
391
354
 
392
- Ordinary lookups retry network failures, 429, and 500/502/503/504 responses twice by default. Carrier, caller, HLR, and email or VAT with `deep=True` make one attempt by default. Address with `deep=True` also uses one attempt, reserving the same behavior for future verification.
355
+ Ordinary lookups retry network failures, 429, and 500/502/503/504 responses twice by default. Carrier, caller, HLR, and email with `deep=True` make one attempt by default. Address with `deep=True` also uses one attempt, reserving the same behavior for future verification.
393
356
 
394
357
  An explicit client `retries` setting overrides those defaults; `retries=0` always makes one attempt. Another attempt can consume additional usage if the earlier response was lost. Cancelling an async task stops the call and any retry wait. Automatic redirects are disabled.
395
358
 
@@ -449,8 +412,6 @@ Successful checks may be reused for up to 24 hours. `pretty` optionally formats
449
412
 
450
413
  Stack defaults to a 35-second transport timeout so a first scan has time to finish. Other lookups retain their 10-second default. An explicit client timeout takes precedence.
451
414
 
452
- Vehicle lookups use `vin` as the input and response field. Existing VIN methods remain available for compatibility.
453
-
454
415
  ## Emoji catalog additions
455
416
 
456
417
  Resolve Unicode emoji or a named shortcode, search or browse a bounded catalog,
@@ -537,7 +498,6 @@ Reviewed children, ancestors and siblings use canonical lists with partial relat
537
498
  Strict `ambiguity=error` can return HTTP 409 `ambiguous_city` with up to two safe candidate identities. The existing error constructor and unrelated error metadata are preserved; candidates are retained only for that status/code and never contain Deep. GeoJSON is available through HTTP; these typed City list methods do not return GeoJSON.
538
499
 
539
500
 
540
-
541
501
  Reviewed name forms:
542
502
 
543
503
  ```python
@@ -45,7 +45,7 @@ Pass `country` when a postal code or national phone number needs disambiguation.
45
45
 
46
46
  Results are plain data. Pass a returned code or coordinate to another operation when the task needs it. Check nullable values before composing the next call.
47
47
 
48
- Use `parse.postal("28202", country="US", deep=True)` for US ZIP tax references. `deep.tax` names the levy and `deep.tax_rate` is a percentage, so `7.9` means 7.9%. The state, county, city and special components explain that combined rate. An exact address can differ. Country and state lookups provide their own geographic reference rates, which should not be added to the ZIP rate. `None` means unknown and `0` means known zero. Country `deep.tax_id_format` and `deep.tax_id_regex` describe registration-number format only. Use `vat` for a metered registration check with `deep` explicitly enabled.
48
+ Use `parse.postal("28202", country="US", deep=True)` for US ZIP tax references. `deep.tax` names the levy and `deep.tax_rate` is a percentage, so `7.9` means 7.9%. The state, county, city and special components explain that combined rate. An exact address can differ. Country and state lookups provide their own geographic reference rates, which should not be added to the ZIP rate. `None` means unknown and `0` means known zero. Country `deep.tax_id_format` and `deep.tax_id_regex` describe registration-number format only. Use for a metered registration check with `deep` explicitly enabled.
49
49
 
50
50
  ## Company directory
51
51
 
@@ -85,10 +85,8 @@ One method per endpoint, named after the route.
85
85
  parse.ip("8.8.8.8")
86
86
  parse.ip.self()
87
87
  parse.email("hello@gmail.com")
88
- parse.vat("DE136695976")
89
88
  parse.bank("DE89370400440532013000")
90
89
  parse.card("424242")
91
- parse.provider("1881018208")
92
90
  parse.phone("+14155552671")
93
91
  parse.carrier("+14155552671")
94
92
  parse.caller("+14155552671")
@@ -118,8 +116,6 @@ parse.state.districts("NC", country="US")
118
116
  parse.district("37081")
119
117
  parse.continent("NA")
120
118
  parse.continent.countries("NA")
121
- parse.bloc("EU")
122
- parse.bloc.countries("EU")
123
119
  parse.currency("USD")
124
120
  parse.currency.rate("USD", "EUR")
125
121
  parse.language("en")
@@ -144,11 +140,8 @@ parse.mx("example.com")
144
140
  parse.dns("example.com")
145
141
  parse.dns("_dmarc.example.com", type="TXT")
146
142
  parse.useragent(ua_string)
147
- parse.vehicle("1HGCM82633A004352")
148
143
  parse.industry("541511")
149
144
  parse.industry.search("coffee shop", limit=5)
150
- parse.tariff("8471.30.01.00")
151
- parse.tariff.search("sunglasses")
152
145
  parse.emoji("rocket")
153
146
  parse.emoji.search("fire")
154
147
  ```
@@ -182,7 +175,7 @@ Choose display names for one request:
182
175
  parse.country("DE", lang="fr")
183
176
  ```
184
177
 
185
- `lang` is optional on geography lookups and their lists/searches, Currency lookup, Language, Date, Time/Timezone, Emoji lookup/search, and unit discovery. IP, ASN, national Company number lookup and NPI also accept it for their geographic labels. Codes, native names, quantities and response structure retain their meanings. Source coverage determines which labels are translated; unavailable labels use the API's documented fallback.
178
+ `lang` is optional on geography lookups and their lists/searches, Currency lookup, Language, Date, Time/Timezone, Emoji lookup/search, and unit discovery. IP, ASN and national Company number lookups also accept it for their geographic labels. Codes, native names, quantities and response structure retain their meanings. Source coverage determines which labels are translated; unavailable labels use the API's documented fallback.
186
179
 
187
180
  The next call keeps its usual default unless it also supplies `lang`. Existing `deep` rules still apply. Date `format` and measurement `locale` remain explicit input-parsing controls.
188
181
 
@@ -268,19 +261,6 @@ Weather returns current conditions by default. Paid deep adds specialist current
268
261
  parse.weather(40.7128, -74.006, deep=True, date="2026-08-15")
269
262
  ```
270
263
 
271
- Tariff starts with the general schedule line. Paid deep adds units and the special and other schedule columns. An optional origin then resolves country-specific measures. The three calls below show those successive choices. Without origin, schedule detail is still returned and origin-dependent fields are null. A null effective rate is not a zero rate.
272
-
273
- Tariff lookup and search accept the `edition` ID returned by Tariff, such as `ted_3`, and an optional `date` (`YYYY-MM-DD`). The edition pins exact immutable source bytes. A date is accepted only when verified source coverage exists. An edition without a date returns undated schedule context (`date: null`). Default requests use today. Paid detail exposes an open-string `reason` when `effective_rate` is null, including `incomplete_coverage`. A null rate never means zero. Explicit selections fail with `tariff_selection_mismatch` if an older server ignores the requested scope.
274
-
275
- Origin means where the goods originate, not where they ship from. The effective rate covers matched stored schedule measures only. It is not complete duty or landed cost.
276
-
277
- Codes contain 4, 6, 8 or 10 ASCII digits; dots and whitespace are optional. Search returns up to 20 description matches with parent `lineage` so a result named "Other" has context. Search is not product classification. In deep, `measures: null` means origin-dependent measures were not resolved. `measures: []` means the resolved lookup found none.
278
-
279
- ```python
280
- parse.tariff("8471.30.01.00")
281
- parse.tariff("8471.30.01.00", deep=True)
282
- parse.tariff("8471.30.01.00", deep=True, origin="CN")
283
- ```
284
264
 
285
265
  Address search uses context from the form: prefer postal, or city and state. An optional end-user `ip` is a locality hint for server-side calls. An empty result explains itself with `reason`: `more_input`, `missing_context` or `no_matches`. With suggestions, reason is null. Older responses may omit it, and future reasons remain strings. Catalog and lookup failures use the existing API errors.
286
266
 
@@ -297,21 +277,6 @@ parse.bank_requirements("US", format="us_ach")
297
277
  parse.bank_us_ach(routing="011000015", account="0001234567")
298
278
  ```
299
279
 
300
- ## Provider lookup
301
-
302
- ```python
303
- provider = parse.provider("1881018208")
304
- profile = parse.provider("1881018208", deep=True)
305
- ```
306
-
307
- Pass the original NPI as a string. `valid` checks its format and checksum; `registered` means a match in the stored NPPES snapshot. `active` reflects recorded NPI deactivation, not licensure. `excluded` is an NPI-only OIG LEIE match; `false` is not a complete exclusion clearance. These directory facts do not verify credentials, current practice contact or payment eligibility.
308
-
309
- Invalid input returns `valid: false` with unknown provider fields. A checksum-valid number missing from the snapshot returns `registered: false`; unavailable storage remains an API error. Preserve `null` as unknown.
310
-
311
- The default pooled lookup includes provider identity, specialty and practice contact where held. Paid `deep` adds `deactivated_at`, `medicare`, `opt_out` and `enrollments` from stored source files, with no separate check meter or live verification. `enrollments: null` means unavailable; `[]` means no enrollment rows are returned. The API omits unrequested `deep` and returns `{}` when requested on Free.
312
-
313
- Paid Deep also returns `taxonomies` in published order, with taxonomy code, specialty label, primary flag and provider-reported license number/state, plus `enumerated_at`, `updated_at` and `reactivated_at` record dates. Reported licenses are not verified licenses. Null lists mean unavailable; empty lists mean the edition contains no entries. Provider record dates describe the provider record. Unknown dates stay null.
314
-
315
280
  ## Deep
316
281
 
317
282
  Choose enrichment for the question you need answered.
@@ -321,12 +286,10 @@ Choose enrichment for the question you need answered.
321
286
  | IP | Richer IP fields included with a paid plan. No separate check meter. |
322
287
  | Domain | Registration dates, registrar, status and DNSSEC, included with a paid plan. Use `dns` for DNS records and `mx` for mail routing. |
323
288
  | Email | A metered mailbox check with deliverability, catch-all, status, reason and address hints, using included email checks or enabled on-demand usage. |
324
- | VAT | A metered registry check where supported, using included VAT checks or enabled on-demand usage. |
325
289
  | Phone, Time, Date, Currency, Language, Emoji, Bank, Point | Optional detail in the same pooled request on every plan. |
326
290
  | Country, State, District, City, Postal | The place profile on paid plans, including demographic and tax facts where held. |
327
291
  | Name, Industry | Name evidence or the industry definition profile on paid plans. |
328
- | NPI | Deactivation date, Medicare enrollment, opt-out and enrollment rows from stored sources on paid plans. Exclusion evidence stays core. |
329
- | Vehicle, Tariff, Company | The complete product detail bag on paid plans. |
292
+ | Company | The complete product detail bag on paid plans. |
330
293
  | Weather | Specialist current measurements and the existing forecast, alert, air and history bag on paid plans. |
331
294
  | Carrier, HLR | Optional diagnostic detail within the same metered core unit, including Free allowance units. No second gate or additional check. |
332
295
 
@@ -370,7 +333,7 @@ parse = ParseAPI(
370
333
 
371
334
  Requires Python 3.9 or later. One dependency (httpx).
372
335
 
373
- Ordinary lookups retry network failures, 429, and 500/502/503/504 responses twice by default. Carrier, caller, HLR, and email or VAT with `deep=True` make one attempt by default. Address with `deep=True` also uses one attempt, reserving the same behavior for future verification.
336
+ Ordinary lookups retry network failures, 429, and 500/502/503/504 responses twice by default. Carrier, caller, HLR, and email with `deep=True` make one attempt by default. Address with `deep=True` also uses one attempt, reserving the same behavior for future verification.
374
337
 
375
338
  An explicit client `retries` setting overrides those defaults; `retries=0` always makes one attempt. Another attempt can consume additional usage if the earlier response was lost. Cancelling an async task stops the call and any retry wait. Automatic redirects are disabled.
376
339
 
@@ -430,8 +393,6 @@ Successful checks may be reused for up to 24 hours. `pretty` optionally formats
430
393
 
431
394
  Stack defaults to a 35-second transport timeout so a first scan has time to finish. Other lookups retain their 10-second default. An explicit client timeout takes precedence.
432
395
 
433
- Vehicle lookups use `vin` as the input and response field. Existing VIN methods remain available for compatibility.
434
-
435
396
  ## Emoji catalog additions
436
397
 
437
398
  Resolve Unicode emoji or a named shortcode, search or browse a bounded catalog,
@@ -518,7 +479,6 @@ Reviewed children, ancestors and siblings use canonical lists with partial relat
518
479
  Strict `ambiguity=error` can return HTTP 409 `ambiguous_city` with up to two safe candidate identities. The existing error constructor and unrelated error metadata are preserved; candidates are retained only for that status/code and never contain Deep. GeoJSON is available through HTTP; these typed City list methods do not return GeoJSON.
519
480
 
520
481
 
521
-
522
482
  Reviewed name forms:
523
483
 
524
484
  ```python