> ## Documentation Index
> Fetch the complete documentation index at: https://api.docs.originone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a job category

> Returns a job category the agency publishes. Requires the `agency.jobCategories.read` scope.



## OpenAPI

````yaml api-reference/openapi.json GET /api/v2/agencies/{agencyId}/jobCategories/{id}
openapi: 3.1.0
info:
  title: Origin One API
  description: REST API for integrating with the Origin One platform.
  version: '2'
  contact:
    name: Origin One
    url: https://origin.one
    email: support@originone.ai
servers:
  - url: https://api.stage.origin.one
    description: Staging
  - url: https://api.origin.one
    description: Production
security: []
tags:
  - name: agencies
    description: >-
      Regulatory agencies and the job categories they publish; the same for
      every API token.
  - name: jobCategories
    description: >-
      Job categories an agency publishes; an order under FAA, FRA or FTA names
      one.
  - name: clinics
    description: Collection sites where participants are tested.
  - name: companies
    description: Companies linked to your API token.
  - name: locations
    description: Company locations.
  - name: orders
    description: >-
      Drug and alcohol test orders: create them and follow their services to a
      result.
  - name: packages
    description: Packages of services that can be ordered.
  - name: services
    description: Services available to your API token.
  - name: webhooks
    description: Events delivered to the callback URL given when an order was created.
paths:
  /api/v2/agencies/{agencyId}/jobCategories/{id}:
    get:
      tags:
        - jobCategories
      summary: Get a job category
      description: >-
        Returns a job category the agency publishes. Requires the
        `agency.jobCategories.read` scope.
      operationId: getJobCategory
      parameters:
        - name: id
          required: true
          in: path
          description: Unique identifier of the resource.
          schema:
            type: string
            example: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
            description: Unique identifier of the resource.
        - name: agencyId
          required: true
          in: path
          description: Unique identifier of the agency.
          schema:
            example: '123'
            description: Unique identifier of the agency.
            type: string
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobCategory'
        '400':
          description: The request failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: The bearer token is missing, invalid, or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The API token lacks the required scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: The resource does not exist or is outside the API token’s access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearer: []
components:
  schemas:
    JobCategory:
      type: object
      properties:
        agency:
          $ref: '#/components/schemas/AgencyReference'
          description: Agency that publishes the job category.
        id:
          type: string
          description: Unique identifier of the job category.
          example: 3987402f-e963-45a9-8799-b9ea6621adae
        name:
          type: string
          description: Job category name.
          example: Flight Crewmember
        object:
          type: string
          description: Object type; always `jobCategory`.
          example: jobCategory
          enum:
            - jobCategory
        url:
          type: string
          description: Canonical path of this resource, relative to the API origin.
          example: >-
            /api/v2/agencies/3/jobCategories/3987402f-e963-45a9-8799-b9ea6621adae
          format: uri-reference
      required:
        - agency
        - id
        - name
        - object
        - url
    Error:
      type: object
      properties:
        error:
          type: string
          description: HTTP status reason phrase.
          example: Bad Request
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                anyOf:
                  - type: string
                    enum:
                      - backgroundCheckIntegrationNotConfigured
                      - badRequest
                      - conflict
                      - insufficientScope
                      - internalError
                      - invalidElement
                      - invalidFormat
                      - invalidKey
                      - invalidScheduleStrategy
                      - invalidState
                      - invalidType
                      - invalidUnion
                      - invalidValue
                      - linkRequiredBackground
                      - notFound
                      - notMultipleOf
                      - required
                      - scheduleClinicExcludedByFeeCap
                      - scheduleConfiguredClinicUnavailable
                      - tooBig
                      - tooManyRequests
                      - tooSmall
                      - unauthenticated
                      - unrecognizedKeys
                  - type: string
                description: >-
                  Machine-readable error code. New codes may be added; treat
                  unknown codes by `statusCode`.
                example: tooSmall
              detail:
                type: string
                description: Human-readable explanation.
                example: 'Too small: expected number to be >=1'
              meta:
                description: Additional machine-readable context.
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
              source:
                description: Present only when a request field is at fault.
                type: object
                properties:
                  pointer:
                    type: string
                    description: JSON pointer to the request field at fault.
                    example: /page
                required:
                  - pointer
            required:
              - code
              - detail
          description: One entry per problem found.
        statusCode:
          type: integer
          description: HTTP status code.
          example: 400
      required:
        - error
        - errors
        - statusCode
    AgencyReference:
      type: object
      properties:
        code:
          type: string
          description: Agency code, as regulations name it.
          example: FAA
        id:
          type: string
          description: Unique identifier of the agency.
          example: '3'
        object:
          type: string
          description: Object type; always `agency`.
          example: agency
          enum:
            - agency
        url:
          type: string
          description: Canonical path of this resource, relative to the API origin.
          example: /api/v2/agencies/3
          format: uri-reference
      required:
        - code
        - id
        - object
        - url
  securitySchemes:
    bearer:
      description: >-
        Origin One API token. Pass it in the Authorization header:
        `Authorization: Bearer <token>`.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.