{
  "components": {
    "schemas": {
      "OutputJobBoardApiV2Location3974559f630f": {
        "properties": {
          "city": {
            "anyOf": [
              {
                "description": "Full city name",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "country": {
            "description": "Country name",
            "type": "string"
          },
          "countryCode": {
            "anyOf": [
              {
                "description": "Country code",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "description": "Display name",
            "type": "string"
          },
          "state": {
            "anyOf": [
              {
                "description": "State name",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "stateCode": {
            "anyOf": [
              {
                "description": "State code",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "workplaceType": {
            "type": "string"
          }
        },
        "required": [
          "country",
          "name",
          "workplaceType"
        ],
        "title": "Location",
        "type": "object"
      },
      "OutputJobBoardApiV2Locationf7be88e09a4e": {
        "properties": {
          "city": {
            "anyOf": [
              {
                "description": "Full city name",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "country": {
            "description": "Country name",
            "type": "string"
          },
          "countryCode": {
            "anyOf": [
              {
                "description": "Country code",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "description": "Display name",
            "type": "string"
          },
          "state": {
            "anyOf": [
              {
                "description": "State name",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "stateCode": {
            "anyOf": [
              {
                "description": "State code",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "workplaceType": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "Location",
        "type": "object"
      }
    }
  },
  "info": {
    "title": "Rippling job-board-api-v2",
    "version": "2026-10-28"
  },
  "openapi": "3.1.0",
  "paths": {
    "/{board_slug}/branding": {
      "get": {
        "externalDocs": {
          "url": "https://developer.rippling.com/documentation/job-board-api-v2/reference/get-board-slug-brandingg"
        },
        "operationId": "rippling.job_board_api_v2.get_board_slug_brandingg",
        "parameters": [
          {
            "in": "path",
            "name": "board_slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "boardURL": {
                      "description": "URL to access the Job Board",
                      "type": "string"
                    },
                    "slug": {
                      "description": "Unique slug representing your Job Board",
                      "type": "string"
                    }
                  },
                  "required": [
                    "boardURL",
                    "slug"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "404": {
            "description": "Not Found",
            "x-rippling-source-response": {
              "description": "Not Found"
            }
          }
        },
        "servers": [
          {
            "description": "production",
            "url": "https://api.rippling.com/platform/api/ats/v2/board"
          }
        ],
        "summary": "Branding Info",
        "x-rippling-entitlements": [],
        "x-rippling-required-scopes": []
      }
    },
    "/{board_slug}/departments": {
      "get": {
        "externalDocs": {
          "url": "https://developer.rippling.com/documentation/job-board-api-v2/reference/get-board-slug-departments"
        },
        "operationId": "rippling.job_board_api_v2.get_board_slug_departments",
        "parameters": [
          {
            "in": "path",
            "name": "board_slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "items": {
                      "items": {
                        "properties": {
                          "name": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "page": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    },
                    "pageSize": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    },
                    "totalItems": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A list of departments"
          },
          "400": {
            "description": "Invalid request",
            "x-rippling-source-response": {
              "description": "Invalid request"
            }
          },
          "404": {
            "description": "Job board not found",
            "x-rippling-source-response": {
              "description": "Job board not found"
            }
          }
        },
        "servers": [
          {
            "description": "production",
            "url": "https://api.rippling.com/platform/api/ats/v2/board"
          }
        ],
        "summary": "Departments",
        "x-rippling-entitlements": [],
        "x-rippling-required-scopes": []
      }
    },
    "/{board_slug}/jobs": {
      "get": {
        "externalDocs": {
          "url": "https://developer.rippling.com/documentation/job-board-api-v2/reference/get-board-slug-jobs"
        },
        "operationId": "rippling.job_board_api_v2.get_board_slug_jobs",
        "parameters": [
          {
            "in": "path",
            "name": "board_slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "country",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "state",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "city",
            "required": false,
            "schema": {
              "maxLength": 255,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "workplaceType",
            "required": false,
            "schema": {
              "enum": [
                "ON_SITE",
                "REMOTE",
                "HYBRID"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "pageSize",
            "required": false,
            "schema": {
              "maximum": 1000,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "searchQuery",
            "required": false,
            "schema": {
              "maxLength": 255,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "departments",
            "required": false,
            "schema": {
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          },
          {
            "in": "query",
            "name": "groupJobsByLocation",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "items": {
                      "items": {
                        "properties": {
                          "department": {
                            "properties": {
                              "name": {
                                "type": "string"
                              }
                            },
                            "type": "object"
                          },
                          "id": {
                            "type": "string"
                          },
                          "locations": {
                            "items": {
                              "$ref": "#/components/schemas/OutputJobBoardApiV2Location3974559f630f"
                            },
                            "type": "array"
                          },
                          "url": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "page": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    },
                    "pageSize": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    },
                    "totalItems": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    },
                    "totalPages": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A list of jobs."
          },
          "404": {
            "description": "Not Found",
            "x-rippling-source-response": {
              "description": "Not Found"
            }
          }
        },
        "servers": [
          {
            "description": "production",
            "url": "https://api.rippling.com/platform/api/ats/v2/board"
          }
        ],
        "summary": "Jobs",
        "x-rippling-entitlements": [],
        "x-rippling-required-scopes": []
      }
    },
    "/{board_slug}/locations": {
      "get": {
        "externalDocs": {
          "url": "https://developer.rippling.com/documentation/job-board-api-v2/reference/get-board-slug-locations"
        },
        "operationId": "rippling.job_board_api_v2.get_board_slug_locations",
        "parameters": [
          {
            "in": "path",
            "name": "board_slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "items": {
                      "items": {
                        "$ref": "#/components/schemas/OutputJobBoardApiV2Locationf7be88e09a4e"
                      },
                      "type": "array"
                    },
                    "page": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    },
                    "pageSize": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    },
                    "totalItems": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "pattern": "^-?[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$",
                          "type": "string"
                        }
                      ]
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A list of locations"
          },
          "400": {
            "description": "Invalid request",
            "x-rippling-source-response": {
              "description": "Invalid request"
            }
          },
          "404": {
            "description": "Job board not found",
            "x-rippling-source-response": {
              "description": "Job board not found"
            }
          }
        },
        "servers": [
          {
            "description": "production",
            "url": "https://api.rippling.com/platform/api/ats/v2/board"
          }
        ],
        "summary": "Locations",
        "x-rippling-entitlements": [],
        "x-rippling-required-scopes": []
      }
    }
  }
}