SUIDs

Standardized five-character codes that classify jobs and employers by type, occupation, and attributes.

 

Overview

An SUID is a five-character alphanumeric code for classifying jobs and employers.

Use SUIDs to:

• Specify job types (permanent, part-time, contract)
• Classify occupations (software engineer, nurse, accountant)
• Define work systems and job attributes (flextime, shift work, remote)
• Categorize employer sectors and industries

Where to use SUIDs

Job Sync API

When you create or update jobs with the Job Sync API, specify SUIDs in SourcedJobPostingTaxonomyInput:

• jobTypes: Job type SUIDs
• occupations: Occupation SUIDs
• attributes: Work system and search attribute SUIDs

Employer Data API

When you create or update employer data with the Employer Data API, specify SUIDs in CountrySpecificEmployerAttributesInput:

• sectorSUIDs: Company sector SUIDs (maximum 3)

Example usage

Example: part-time software engineering job in Japan with flextime:

mutation CreateJobPosting {
  jobsIngest {
    createSourcedJobPostings(input: {
      jobPostings: [{
        body: {
          title: "Software Engineer"
          description: "<p>Join our team...</p>"
          location: {
            country: "JP"
            streetAddress: "Tokyo, Shibuya"
          }
        }
        metadata: {
          jobSource: {
            companyName: "Example Company"
            sourceName: "example-source"
            sourceType: "Employer"
          }
          jobPostingId: "job-123"
          datePublished: "2026-01-14T12:00:00Z"
          url: "https://example.com/jobs/123"
          taxonomyClassification: {
            jobTypes: ["75GKK"]        # Part-time
            occupations: ["NP8BZ"]     # Software engineer
            attributes: ["HY5VT"]      # Flextime
          }
        }
      }]
    }) {
      results {
        jobPosting {
          sourcedPostingId
        }
      }
    }
  }
}

Find valid SUIDs

These guides list valid SUIDs:

• SUID reference (all tables) - All SUID tables on one page. Use Ctrl+F or Cmd+F to search.

• Job Sync API references:

  • Job types: SUIDs for employment types (permanent, part-time, contract)
  • Occupations: SUIDs for job roles organized by category
  • Work systems: SUIDs for work schedules and arrangements
  • Search attributes: SUIDs for skills, benefits, and job features
  • Shifts and schedules: SUIDs for shift patterns

• Employer Data API references:

  • Company sectors: SUIDs for employer industries

Job Sync API references

• Job types: SUIDs for employment types (permanent, part-time, contract)
• Occupations: SUIDs for job roles organized by category
• Work systems: SUIDs for work schedules and arrangements
• Search attributes: SUIDs for skills, benefits, and job features
• Shifts and schedules: SUIDs for shift patterns

Employer Data API references

• Company sectors: SUIDs for employer industries

SUID format

SUIDs follow this format:

• Length: Five characters
• Value: Case-sensitive alphanumeric (letters and numbers)
• Example: 75GKK, C3XKZ, 7SRRR

Country-specific requirements

Japan

For job postings in Japan, use the SUIDs for:

• Job types (required for all job postings)
• Occupations (required for all job postings)
• Work systems (optional but recommended)
• Company sectors (required for employer creation)

See Job posting guidelines and examples for Japan.

Other countries

Outside Japan, SUIDs are optional. Most taxonomy fields accept freeform text; SUIDs improve job visibility and matching.

Best practices

SUID guidelines:

• Bookmark the reference.
• Use only SUIDs from the reference. Do not modify or create your own.
• Use SUIDs that are valid for your target country.
• Use multiple SUIDs when a job fits more than one category.
• Observe limits (for example, 3 SUIDs for company sectors).

Common issues

Invalid SUID error

If you get a SUID validation error:

1. Check the SUID in the reference.
2. Check for typos and casing.
3. Confirm the SUID is valid for your country.
4. Check that the SUID is in the correct field.

Missing required SUIDs

Japan job postings require:

• At least one job type SUID in jobTypes
• At least one occupation SUID in occupations
• At least one company sector SUID in sectorSUIDs (employers only)

See Troubleshoot GraphQL errors.

Related resources

• SUID changelog: Track additions, removals, and fixes to SUID reference tables
• Job Sync API guide
• Employer Data API
• GraphQL at Indeed

 

Was this page helpful?