Skip to main content
Use these values when submitting KYC. The endpoint returns field requirements plus the allowed values, so you can build the form in one call. Country codes use ISO-3166-1 alpha-2 (e.g., US) for countryOfIssue and address.countryCode. Case-insensitive.
API endpoint: GET /kyc/values.
The response includes a fields array with required/optional flags and validation hints.

​
Occupations (SOC codes)

Provide the code value (e.g., 49-3023).
  • 11-1021 — General and Operations Managers
  • 11-2011 — Advertising and Promotions Managers
  • 11-3031 — Financial Managers
  • 11-9021 — Construction Managers
  • 11-9041 — Architectural and Engineering Managers
  • 11-9071 — Gaming Managers
  • 11-9141 — Property, Real Estate, and Community Association Managers
  • 13-1041 — Compliance Officers
  • 13-2011 — Accountants and Auditors
  • 13-2051 — Financial Analysts
  • 13-2052 — Personal Financial Advisors
  • 13-2082 — Tax Preparers
  • 15-1121 — Computer Systems Analysts
  • 15-1131 — Computer Programmers
  • 15-1132 — Software Developers, Applications
  • 15-1133 — Software Developers, Systems Software
  • 15-1141 — Database Administrators
  • 15-1142 — Information Security Analysts
  • 15-1143 — Computer Network Architects
  • 15-1151 — Computer User Support Specialists
  • 17-2051 — Civil Engineers
  • 17-2071 — Electrical Engineers
  • 17-2141 — Mechanical Engineers
  • 19-3011 — Economists
  • 23-1011 — Lawyers
  • 23-2011 — Paralegals and Legal Assistants
  • 25-2021 — Elementary School Teachers
  • 27-1024 — Graphic Designers
  • 27-2012 — Producers and Directors
  • 29-1141 — Registered Nurses
  • 29-1062 — Family and General Practitioners
  • 29-1067 — Surgeons
  • 31-9097 — Phlebotomists
  • 33-3021 — Detectives and Criminal Investigators
  • 35-1011 — Chefs and Head Cooks
  • 41-9011 — Demonstrators and Product Promoters
  • 41-9021 — Real Estate Brokers
  • 43-3071 — Tellers
  • 47-1011 — Construction Supervisors
  • 47-2061 — Construction Laborers
  • 49-3023 — Automotive Service Technicians and Mechanics
  • 51-4121 — Welders, Cutters, Solderers, and Brazers
  • 53-3032 — Heavy and Tractor-Trailer Truck Drivers
  • 53-3041 — Taxi Drivers and Chauffeurs
  • SELFEMP — Self-Employed
  • UNEMPLO — Unemployed
  • RETIRED — Retired
  • OTHERXX — Other

​
Annual salary (ranges)

  • <40k
  • 50k–99k
  • 100k–149k
  • 150k+

​
Expected monthly volume

  • under $1k
  • 1k–1k–5k
  • 5k–5k–20k
  • $20k+

​
Account purpose

  • everyday spend
  • subscriptions
  • business expenses
  • testing
  • other
Values above match our app’s KYC form to keep integrations consistent.

​
Copy as JSON

{
  "fields": [
    { "name": "firstName", "required": true, "type": "string", "maxLength": 50, "description": "Given name." },
    { "name": "lastName", "required": true, "type": "string", "maxLength": 50, "description": "Family name." },
    { "name": "birthDate", "required": true, "type": "date", "description": "YYYY-MM-DD (e.g., 1990-01-01)." },
    {
      "name": "nationalId",
      "required": true,
      "type": "string",
      "regex": "^[0-9A-Za-z-]+$",
      "description": "Government ID number. Letters, numbers, and dashes only."
    },
    {
      "name": "countryOfIssue",
      "required": true,
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "ISO-3166-1 alpha-2 country code (e.g., US). Case-insensitive."
    },
    { "name": "email", "required": true, "type": "string", "description": "Email address." },
    {
      "name": "address",
      "required": true,
      "type": "object",
      "description": "Object with line1, line2, city, region, postalCode, countryCode (case-insensitive)."
    },
    {
      "name": "phoneCountryCode",
      "required": false,
      "type": "string",
      "maxLength": 3,
      "description": "Country calling code digits only (e.g., 1)."
    },
    {
      "name": "phoneNumber",
      "required": false,
      "type": "string",
      "maxLength": 15,
      "description": "Phone number digits only; include area code."
    },
    {
      "name": "occupation",
      "required": true,
      "type": "string",
      "description": "SOC occupation code (e.g., 49-3023). Use /kyc/values for the list."
    },
    {
      "name": "annualSalary",
      "required": true,
      "type": "string",
      "enum": ["<40k", "50k–99k", "100k–149k", "150k+"],
      "description": "Choose a salary range."
    },
    {
      "name": "accountPurpose",
      "required": true,
      "type": "string",
      "enum": ["everyday spend", "subscriptions", "business expenses", "testing", "other"],
      "description": "How the account will be used."
    },
    {
      "name": "expectedMonthlyVolume",
      "required": true,
      "type": "string",
      "enum": ["under $1k", "$1k–$5k", "$5k–$20k", "$20k+"],
      "description": "Choose a monthly volume range."
    }
  ],
  "occupations": [
    { "code": "11-1021", "label": "General and Operations Managers" },
    { "code": "11-2011", "label": "Advertising and Promotions Managers" },
    { "code": "11-3031", "label": "Financial Managers" },
    { "code": "11-9021", "label": "Construction Managers" },
    { "code": "11-9041", "label": "Architectural and Engineering Managers" },
    { "code": "11-9071", "label": "Gaming Managers" },
    { "code": "11-9141", "label": "Property, Real Estate, and Community Association Managers" },
    { "code": "13-1041", "label": "Compliance Officers" },
    { "code": "13-2011", "label": "Accountants and Auditors" },
    { "code": "13-2051", "label": "Financial Analysts" },
    { "code": "13-2052", "label": "Personal Financial Advisors" },
    { "code": "13-2082", "label": "Tax Preparers" },
    { "code": "15-1121", "label": "Computer Systems Analysts" },
    { "code": "15-1131", "label": "Computer Programmers" },
    { "code": "15-1132", "label": "Software Developers, Applications" },
    { "code": "15-1133", "label": "Software Developers, Systems Software" },
    { "code": "15-1141", "label": "Database Administrators" },
    { "code": "15-1142", "label": "Information Security Analysts" },
    { "code": "15-1143", "label": "Computer Network Architects" },
    { "code": "15-1151", "label": "Computer User Support Specialists" },
    { "code": "17-2051", "label": "Civil Engineers" },
    { "code": "17-2071", "label": "Electrical Engineers" },
    { "code": "17-2141", "label": "Mechanical Engineers" },
    { "code": "19-3011", "label": "Economists" },
    { "code": "23-1011", "label": "Lawyers" },
    { "code": "23-2011", "label": "Paralegals and Legal Assistants" },
    { "code": "25-2021", "label": "Elementary School Teachers" },
    { "code": "27-1024", "label": "Graphic Designers" },
    { "code": "27-2012", "label": "Producers and Directors" },
    { "code": "29-1141", "label": "Registered Nurses" },
    { "code": "29-1062", "label": "Family and General Practitioners" },
    { "code": "29-1067", "label": "Surgeons" },
    { "code": "31-9097", "label": "Phlebotomists" },
    { "code": "33-3021", "label": "Detectives and Criminal Investigators" },
    { "code": "35-1011", "label": "Chefs and Head Cooks" },
    { "code": "41-9011", "label": "Demonstrators and Product Promoters" },
    { "code": "41-9021", "label": "Real Estate Brokers" },
    { "code": "43-3071", "label": "Tellers" },
    { "code": "47-1011", "label": "Construction Supervisors" },
    { "code": "47-2061", "label": "Construction Laborers" },
    { "code": "49-3023", "label": "Automotive Service Technicians and Mechanics" },
    { "code": "51-4121", "label": "Welders, Cutters, Solderers, and Brazers" },
    { "code": "53-3032", "label": "Heavy and Tractor-Trailer Truck Drivers" },
    { "code": "53-3041", "label": "Taxi Drivers and Chauffeurs" },
    { "code": "SELFEMP", "label": "Self-Employed" },
    { "code": "UNEMPLO", "label": "Unemployed" },
    { "code": "RETIRED", "label": "Retired" },
    { "code": "OTHERXX", "label": "Other" }
  ],
  "annualSalary": ["<40k", "50k–99k", "100k–149k", "150k+"],
  "expectedMonthlyVolume": ["under $1k", "$1k–$5k", "$5k–$20k", "$20k+"],
  "accountPurpose": ["everyday spend", "subscriptions", "business expenses", "testing", "other"]
}

​
API endpoint (JSON)

curl -s -H 'Authorization: Bearer <SESSION_TOKEN>' \
  https://dev-api.machines.cash/partner/v1/kyc/values