Industry classification object

This reference describes the industry_classification object, which represents the industry classification of a business.

Middesk leverages a variety of techniques to determine if a business falls into a particular industry. Middesk scores a business against each category and returns the top industry classifications for each entity. Middesk returns up to 5 classifications per classification_system that meet the threshold requirement. Classifications appear in descending order by confidence score.

Sample response
1{
2 "object": "industry_classification",
3 "id": "11515c70-5359-4ff5-a810-2063b3a26783",
4 "status": "completed",
5 "categories": [
6 {
7 "classification_system": "NAICS",
8 "name": "Other Accounting Services",
9 "sector": "PROFESSIONAL_SCIENTIFIC_TECHNICAL_SERVICES",
10 "category": "OTHER_ACCOUNTING_SERVICES",
11 "score": 0.84254183902144128,
12 "high_risk": false,
13 "naics_codes": [
14 "541219"
15 ],
16 "sic_codes": [
17 "7291",
18 "8721"
19 ],
20 "mcc_codes": [],
21 "prohibited_labels": []
22 },
23 {
24 "classification_system": "NAICS",
25 "name": "Software Publishers",
26 "sector": "INFORMATION",
27 "category": "SOFTWARE_PUBLISHERS",
28 "score": 0.71428778733424187,
29 "high_risk": false,
30 "naics_codes": [
31 "513210"
32 ],
33 "sic_codes": [
34 "7372"
35 ],
36 "mcc_codes": [],
37 "prohibited_labels": []
38 },
39 {
40 "classification_system": "Prohibited",
41 "name": "Other Non-Prohibited",
42 "sector": null,
43 "category": "OTHER_NON_PROHIBITED",
44 "score": 0.65029388771531674,
45 "high_risk": false,
46 "naics_codes": [],
47 "sic_codes": [],
48 "mcc_codes": [],
49 "prohibited_labels": [
50 "OTHER_NON_PROHIBITED"
51 ]
52 }
53 ],
54 "created_at": "2023-03-07T23:08:11.893Z",
55 "completed_at": "2023-03-07T23:08:12.305Z",
56 "website": {
57 "url": "https://www.middesk.com",
58 "status": "online",
59 "parked": false
60 }
61},
62"subscription": null,
63"tax_exempt_organization": null,
64"fmcsa_registrations": [],
65"actions": [],
66"submitted": {
67 "object": "submitted_attributes",
68 "name": "Middesk",
69 "addresses": null,
70 "orders": null,
71 "people": [],
72 "phone_numbers": null,
73 "tags": null,
74 "external_id": null,
75 "tin": null,
76 "website": {
77 "url": "https://www.middesk.com"
78 },
79 "assignee_id": null,
80 "formation": null,
81 "names": null
82}

Industry classification attributes

PropertyTypeDescription
objectstringA definition of the type of object returned
idstring
statusstringThe current status of the classification
categoriescategory[]List and details of all known classifications
websiteobjectThe URL and status of the submitted website. This appears only if you submit a website.
created_attimestamp
completed_attimestamp

Category attributes

An industry_classification may have multiple categories. The category object contains the following properties.

PropertyTypeDescription
classification_systemstringThe relevant classification system. Valid values are NAICS, MCC, and Prohibited. 501c3 is a valid but deprecated classification system.
namestringThe name of the industry category.
sectorstringThe sector that the business operates in. The sector is defined per category, and some categories may not have a sector.
categorystringThe industry category that the business operates in.
scorefloatA score indicating the likelihood that a business operates within this category.
high_riskbooleanA flag indicating if the industry is considered high risk.
naics_codesstring[]A list of NAICS (North American Industry Classification System) codes for the industry category. This array may be populated if the classification_system is NAICS.
sic_codesstring[]A list of SIC (Standard Industrial Classification) codes for the industry category. This array may be populated if the classification_system is NAICS.
mcc_codesstring[]A list of MCCs (Merchant Category Codes) for the industry category. This array may be populated if the classification_system is MCC.
prohibited_labelsstring[]A list of prohibited industry labels that may be populated if the classification_system is Prohibited.
risk_program_flagsobject[]A list of card network risk program flags (Mastercard SMRP and Visa VIRP) that apply to the category. This array appears only on Risk orders and is empty when the Risk order flagged no programs.

Each industry classification can be classified under multiple categories.

Risk program flag attributes

Card network risk program flags are available only on Risk orders. Categories returned by any other order omit the risk_program_flags field entirely. On a Risk order the field is always present, and it is an empty array when the category matched no program.

Each flag identifies a card network risk program (Mastercard SMRP or Visa VIRP) that lists the category. The flags are enrichment only and never contribute to the risk score or level. See Card network risk programs for how the programs work.

PropertyTypeDescription
programstringThe card network risk program. Valid values are SMRP (Mastercard) and VIRP (Visa).
program_categorystringThe network listing category (e.g., crypto, pharmacy, gambling).
tierobjectThe VIRP tier severity, with a level (1, 2, or 3) and a harm_type (health_safety, financial, or regulatory_deceptive). This object appears only on VIRP flags; SMRP is untiered.
Category with risk program flags, returned on a Risk order
1{
2 "classification_system": "MCC",
3 "name": "Online Gambling",
4 "sector": null,
5 "category": "GAMBLING",
6 "score": 0.91334781125904183,
7 "high_risk": true,
8 "naics_codes": [],
9 "sic_codes": [],
10 "mcc_codes": [
11 "7995"
12 ],
13 "prohibited_labels": [],
14 "risk_program_flags": [
15 {
16 "program": "SMRP",
17 "program_category": "gambling"
18 },
19 {
20 "program": "VIRP",
21 "program_category": "gambling",
22 "tier": {
23 "level": 1,
24 "harm_type": "health_safety"
25 }
26 }
27 ]
28}
Get a demo
Contact your account manager or contact sales to inquire about access.