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.
- {parseapi-1.10.0 → parseapi-1.10.2}/PKG-INFO +5 -45
- {parseapi-1.10.0 → parseapi-1.10.2}/README.md +4 -44
- {parseapi-1.10.0 → parseapi-1.10.2}/api/public.json +0 -390
- {parseapi-1.10.0 → parseapi-1.10.2}/pyproject.toml +1 -1
- {parseapi-1.10.0 → parseapi-1.10.2}/smoke/smoke.py +2 -29
- {parseapi-1.10.0 → parseapi-1.10.2}/src/parseapi/__init__.py +1 -1
- {parseapi-1.10.0 → parseapi-1.10.2}/src/parseapi/_client.py +0 -104
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_client.py +10 -19
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_language.py +1 -3
- parseapi-1.10.0/tests/test_tariff.py +0 -92
- parseapi-1.10.0/tests/test_tariff_short_id.py +0 -92
- {parseapi-1.10.0 → parseapi-1.10.2}/.github/workflows/publish.yml +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/.github/workflows/test.yml +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/.gitignore +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/CHANGELOG.md +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/LICENSE +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/scripts/public_api.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/src/parseapi/city.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/src/parseapi/py.typed +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/bank-fixtures.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/emoji-artwork.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/emoji-catalog.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/measure-response.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-company-coverage.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-company-profile.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-emoji-catalog.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-emoji-metadata.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-provider.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-tariff-search.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-tariff.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-time.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/clean-timezones.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-company-coverage.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-company-profile.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-emoji-catalog.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-emoji-metadata.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-provider.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-tariff-search.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-tariff.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-time.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/fixtures/response-fixtures/standard-timezones.json +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_bank.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_card_dx.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_city_canonical.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_city_quality.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_city_query_parity.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_company_directory.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_email_enrichment.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_emoji.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_measure_response.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_name_formatting.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_postal_localities.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_public_api.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_response_decoding.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_stack.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_time_complete.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_time_gaps.py +0 -0
- {parseapi-1.10.0 → parseapi-1.10.2}/tests/test_version.py +0 -0
- {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.
|
|
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
|
|
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
|
|
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
|
-
|
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
|
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
|
|
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
|