Lever Postings API

openapi: 3.2.0
info:
  title: Lever Postings API
  x-refined-note:
  - x-authored-by differs across the merged source definitions and was not carried
  - x-cleaned differs across the merged source definitions and was not carried
  - x-engine differs across the merged source definitions and was not carried
  - x-evidence-tiers differs across the merged source definitions and was not carried
  - x-generated differs across the merged source definitions and was not carried
  - x-generated-from differs across the merged source definitions and was not carried
  - x-generator differs across the merged source definitions and was not carried
  - x-provenance differs across the merged source definitions and was not carried
  - x-sources differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Postings across 2 of this provider''s published API definitions: lever-openapi-generated.yml, lever-postings-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.lever.co/v1
  description: Production (the root URL for the Lever API web service is https://api.lever.co/v1)
- url: https://api.sandbox.lever.co/v1
  description: Integrator Sandbox (partner program; https://hire.lever.co/developer/partner)
tags:
- name: Postings
paths:
  /postings:
    get:
      operationId: get_postings
      tags:
      - Postings
      summary: List all postings in your Lever account
      x-source: https://hire.lever.co/developer/documentation
      parameters:
      - name: include
        in: query
        required: false
        schema:
          type: string
      - name: expand
        in: query
        required: false
        schema:
          type: string
      - name: state
        in: query
        required: false
        schema:
          type: string
      - name: distributionChannel
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: offset
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPostingsResponse'
      x-evidence:
        kind: documentation
      security:
      - basic: []
    post:
      operationId: post_postings
      tags:
      - Postings
      summary: Create a posting
      x-source: https://hire.lever.co/developer/documentation
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
      security:
      - basic: []
    servers:
    - url: https://api.lever.co/v1
      description: Production (the root URL for the Lever API web service is https://api.lever.co/v1)
    - url: https://api.sandbox.lever.co/v1
      description: Integrator Sandbox (partner program; https://hire.lever.co/developer/partner)
  /postings/deleted:
    get:
      operationId: get_postings_deleted
      tags:
      - Postings
      summary: GET /v1/postings/deleted
      x-source: https://hire.lever.co/developer/documentation
      parameters:
      - name: deleted_at_end
        in: query
        required: false
        schema:
          type: string
      - name: deleted_at_start
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -u API_KEY: https://api.lever.co/v1/postings/deleted?deleted_at_start=1711929600000&deleted_at_end=1714521600000 \n Create a posting \n POST /postings This endpoint enables integrations to create postings in your Lever account. Creating a posting through the API will not go through the approvals chain. However, API-made postings can be created as draft s, and postings can still go through appro"
      security:
      - basic: []
    servers:
    - url: https://api.lever.co/v1
      description: Production (the root URL for the Lever API web service is https://api.lever.co/v1)
    - url: https://api.sandbox.lever.co/v1
      description: Integrator Sandbox (partner program; https://hire.lever.co/developer/partner)
  /postings/{posting}:
    get:
      operationId: get_postings_posting
      tags:
      - Postings
      summary: Retrieve a single posting, including the job description
      x-source: https://hire.lever.co/developer/documentation
      parameters:
      - name: distribution
        in: query
        required: false
        schema:
          type: string
      - name: posting
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPostingsPostingResponse'
      x-evidence:
        kind: documentation
      security:
      - basic: []
    post:
      operationId: post_postings_posting
      tags:
      - Postings
      summary: Update a posting
      x-source: https://hire.lever.co/developer/documentation
      parameters:
      - name: posting
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
      security:
      - basic: []
    parameters:
    - name: posting
      in: path
      required: true
      schema:
        type: string
    put:
      tags:
      - Postings
      summary: Update posting
      requestBody:
        $ref: '#/components/requestBodies/Generic_2'
      responses:
        '200':
          $ref: '#/components/responses/Resource_2'
      operationId: putPostingsByPosting
      x-operation-id-source: derived
      security:
      - basic: []
    servers:
    - url: https://api.lever.co/v1
      description: Production (the root URL for the Lever API web service is https://api.lever.co/v1)
    - url: https://api.sandbox.lever.co/v1
      description: Integrator Sandbox (partner program; https://hire.lever.co/developer/partner)
  /postings/{posting}/apply:
    get:
      operationId: get_postings_posting_apply
      tags:
      - Postings
      summary: Retrieve posting application questions
      x-source: https://hire.lever.co/developer/documentation
      parameters:
      - name: distribution
        in: query
        required: false
        schema:
          type: string
        description: This parameter is used to return internal or external custom application questions. If unspecified, it returns both (internal and external).
      - name: posting
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
      security:
      - basic: []
    post:
      tags:
      - Postings
      summary: Apply to posting
      requestBody:
        $ref: '#/components/requestBodies/Generic'
      responses:
        '201':
          $ref: '#/components/responses/Resource'
      operationId: post_postings_posting_apply
      x-source: https://hire.lever.co/developer/documentation
      x-recovered-from: 'openapi/_ae-authored/lever-openapi.yml (earlier AE-generated contract, 2026-11-05): the generator dropped this documented operation as an example instance of a templated sibling'
      security:
      - basic: []
    servers:
    - url: https://api.lever.co/v1
      description: Production (the root URL for the Lever API web service is https://api.lever.co/v1)
    - url: https://api.sandbox.lever.co/v1
      description: Integrator Sandbox (partner program; https://hire.lever.co/developer/partner)
  /postings/{posting}/users:
    get:
      operationId: get_postings_posting_users
      tags:
      - Postings
      summary: List users with access to a posting
      x-source: https://hire.lever.co/developer/documentation
      parameters:
      - name: posting
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPostingsPostingUsersResponse'
      x-evidence:
        kind: documentation
      security:
      - basic: []
    servers:
    - url: https://api.lever.co/v1
      description: Production (the root URL for the Lever API web service is https://api.lever.co/v1)
    - url: https://api.sandbox.lever.co/v1
      description: Integrator Sandbox (partner program; https://hire.lever.co/developer/partner)
  /postings/{posting}/applications:
    parameters:
    - name: posting
      in: path
      required: true
      schema:
        type: string
    get:
      tags:
      - Postings
      summary: List application questions
      responses:
        '200':
          $ref: '#/components/responses/Collection'
      operationId: getPostingsByPostingApplications
      x-operation-id-source: derived
      security:
      - basicAuth: []
      - bearerAuth: []
    servers:
    - url: https://api.lever.co/v1
      description: Lever production API
components:
  requestBodies:
    Generic:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    Generic_2:
      required: true
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true
  schemas:
    GetPostingsPostingUsersResponse:
      type: object
      properties:
        posting:
          type: object
        users:
          type: array
        roles:
          type: array
    GetPostingsResponse:
      type: object
      properties:
        data:
          type: array
          description: Array of posting objects
        next:
          type: string
          description: Offset token for next page
        hasNext:
          type: boolean
          description: Whether or not there are more elements available
    GetPostingsPostingResponse:
      type: object
      properties:
        id:
          type: string
          description: Posting UID
        text:
          type: string
          description: Job title
        createdAt:
          type: string
          description: When posting was created
        updatedAt:
          type: string
          description: When posting was last updated
        user:
          type: string
          description: User UID who created the posting
        owner:
          type: string
          description: User UID of the posting owner
        hiringManager:
          type: string
          description: User UID of the hiring manager
        confidentiality:
          type: string
          description: Confidentiality status
        categories:
          type: object
          description: Object containing posting categories
        content:
          type: object
          description: Content of the job posting
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code
        tags:
          type: array
          description: Array of posting tags
        state:
          type: string
          description: Posting status
        distributionChannels:
          type: array
          description: Job sites where posting appears
        reqCode:
          type: string
          description: Requisition code associated with this posting
        requisitionCodes:
          type: array
          description: Array of requisition codes associated with this posting
        salaryDescription:
          type: string
        salaryDescriptionHtml:
          type: string
        salaryRange:
          type: object
        urls:
          type: object
          description: Object containing list, show and apply URLs
        workplaceType:
          type: string
          description: Workplace type of this posting
  responses:
    Resource:
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    Resource_2:
      description: Single resource response
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                type: object
                additionalProperties: true
            additionalProperties: true
    Collection:
      description: Collection response with cursor pagination
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                type: array
                items:
                  type: object
                  additionalProperties: true
              hasNext:
                type: boolean
              next:
                type: string
            additionalProperties: true
  securitySchemes:
    basic:
      type: http
      scheme: basic
    basicAuth:
      type: http
      scheme: basic
      description: API key supplied as the basic auth username with empty password.
    bearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 bearer access token (Lever Partner OAuth apps).
x-refined-from:
- lever-openapi-generated.yml
- lever-postings-api-openapi.yml