{
  "openapi": "3.1.0",
  "info": {
    "title": "Connecting Odds Job Search",
    "version": "1.0.0",
    "description": "Read-only search of live job postings on Connecting Odds. No sign-in required. Same results as the /jobs page.",
    "contact": {
      "email": "support@connectingodds.com"
    }
  },
  "servers": [
    {
      "url": "https://connectingodds.com"
    }
  ],
  "paths": {
    "/jobs/search.json": {
      "get": {
        "operationId": "searchJobs",
        "summary": "Search live job postings",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Keywords, such as a job title or skill.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "loc",
            "in": "query",
            "required": false,
            "description": "City or region.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Two-letter country code, e.g. US.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            }
          },
          {
            "name": "remote",
            "in": "query",
            "required": false,
            "description": "Only remote jobs.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            }
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Posted within this many days.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "salary_min",
            "in": "query",
            "required": false,
            "description": "Lowest annual pay.",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "salary_max",
            "in": "query",
            "required": false,
            "description": "Highest annual pay.",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Three-letter currency of the salary values.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{3}$"
            }
          },
          {
            "name": "skills",
            "in": "query",
            "required": false,
            "description": "Comma-separated skills.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "visa_sponsorship",
            "in": "query",
            "required": false,
            "description": "Visa sponsorship filter.",
            "schema": {
              "type": "string",
              "enum": [
                "yes",
                "no",
                "known",
                "unknown"
              ]
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Ordering.",
            "schema": {
              "type": "string",
              "enum": [
                "relevance",
                "recent"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Page number starting at 0.",
            "schema": {
              "type": "integer",
              "minimum": 0
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results per page.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "description": "Snapshot time returned by page 0; pass it on later pages.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching jobs with links to each posting.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "A filter value was not valid."
          }
        }
      }
    }
  }
}