SUIDs

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

 

Overview

An SUID is a five-character code that classifies a job or an employer.

Use SUIDs to:

• Specify job types, such as permanent, part-time, or contract
• Classify occupations, such as software engineer, nurse, or accountant
• Describe work systems and job attributes, such as flextime, shift work, or remote
• Categorize employer sectors and industries

---

Where to use SUIDs

Job Sync API

When you create or update jobs with the Job Sync API, put SUIDs in these fields of SourcedJobPostingTaxonomyInput:

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

Employer Data API

When you create or update employers with the Employer Data API, put SUIDs in this field of CountrySpecificEmployerAttributesInput:

• sectorSUIDs — Company sector SUIDs, up to 3

---

Example usage

This mutation creates a 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

The SUID reference lists every valid SUID on one page. For each API's SUID tables, see References.

---

SUID format

Every SUID has this format:

• Length — Five characters
• Characters — Letters and numbers. SUIDs are case-sensitive.
• Examples — 75GKK, C3XKZ, 7SRRR

---

Country-specific requirements

Japan

For jobs and employers in Japan, use these SUIDs:

• Job types — Required for every job
• Occupations — Required for every job
• Work systems — Optional, but recommended
• Company sectors — Required when you create an employer

See Job posting guidelines and examples for Japan.

Other countries

Outside Japan, SUIDs are optional, and most taxonomy fields accept freeform text. SUIDs still help Indeed show your jobs to the right job seekers.

---

Best practices

Follow these guidelines when you use SUIDs:

• Bookmark the SUID reference.
• Use only SUIDs from the reference. Don't change them or create your own.
• Use only SUIDs that are valid for your target country.
• When a job fits more than one category, use more than one SUID.
• Stay within field limits. For example, sectorSUIDs accepts up to 3 SUIDs.

---

Common issues

Invalid SUID error

If you get an SUID validation error:

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

Missing required SUIDs

In Japan, include at least one SUID in each of these fields:

• jobTypes — For jobs
• occupations — For jobs
• sectorSUIDs — For employers

For other errors, see Troubleshoot GraphQL errors.

---

See also

Guides

• Job Sync API guide — Explains how to create and manage jobs on Indeed.
• Employer Data API — Explains how to create and update employers on Indeed and the Indeed PLUS platform. Not available to direct employers.
• GraphQL at Indeed — Explains how to authenticate and call Indeed GraphQL APIs.

References

• SUID changelog — Lists additions, removals, and fixes to the SUID reference tables.
• SUID reference — Lists every SUID table on one page. Use Ctrl+F or Cmd+F to search it.
• Job Sync API references
  • Job types — Lists employment types, such as permanent, part-time, or contract.
  • Occupations — Lists job roles, grouped by category.
  • Work systems — Lists work schedules and arrangements.
  • Search attributes — Lists skills, benefits, and job features.
  • Shifts and schedules — Lists shift patterns.
  • Social insurance — Lists social insurance benefits in Japan.
• Employer Data API references
  • Company sectors — Lists employer industries.

GraphQL API references

• SourcedJobPostingTaxonomyInput — Lists the job fields that take SUIDs.
• CountrySpecificEmployerAttributesInput — Lists the country-specific employer fields, including sectorSUIDs.

 

Was this page helpful?