For AI agents: an index of this documentation is at https://developer.rippling.com/llms.txt. Public pages have a Markdown version at the same URL with .md added.

Skip to main content
Article

JobPost

Use with AI:Rippling AI ChatGPT Claude Cursor

JobPost

    id stringrequired

    Identifier field

    created_at stringrequired

    Record creation date

    updated_at stringrequired

    Record update date

    job_requisition_id string

    Identifier of the parent Job Requisition resource. Applications use the legacy field name job_id for the same resource. Null when the parent Job Requisition reference is unavailable.

    job_requisition

    object

    id stringrequired

    Identifier field

    created_at stringrequired

    Record creation date

    updated_at stringrequired

    Record update date

    name stringrequired

    Job requisition name

    status stringrequired

    Possible values: [OPEN, CLOSED, PUBLISHED, DRAFT, ARCHIVED]

    Job requisition status

    requisition_id string

    Customer-defined job requisition identifier; null when the company has not set one

    name stringrequired

    Job post name

    published booleanrequired

    Whether the job post is published

    locations

    object[]

    required

    Configured and manually entered locations associated with the job post. Configured entries expose only work_location_id; manual entries expose manual_location_id and inline location details.

  • Array [

  • work_location_id string

    Canonical Work Location resource identifier for a configured location; null for a manually entered location. Request expand=work_locations on the parent job post to retrieve the corresponding Work Location resources.

    manual_location_id string

    Opaque job-post-local identifier for a manually entered location; null for a configured Work Location.

    name string

    Display name for a manually entered location; null for a configured Work Location resource

    city string

    City for a manually entered location; null for a configured Work Location resource

    state string

    State or region for a manually entered location; null for a configured Work Location resource

    country_code string

    ISO 3166-1 alpha-2 country code for a manually entered location; null for a configured Work Location resource

    workplace_type string

    Possible values: [ON_SITE, REMOTE, HYBRID]

    Workplace type for a manually entered location: ON_SITE, REMOTE, or HYBRID. Configured Work Location resources return null.

  • ]

  • work_location_ids string[]

    Canonical Work Location identifiers for the configured subset of locations[]. Unlike locations[], this list excludes manually entered locations and supports expand=work_locations. Returns an empty list when there are no configured locations.

    work_locations

    object[]

    Configured Work Location resources; request expand=work_locations to include them

    Expandable field

  • Array [

  • id stringrequired

    Identifier field

    created_at stringrequired

    Record creation date

    updated_at stringrequired

    Record update date

    name stringrequired

    The name of the work location.

    address

    object

    type string

    Possible values: [HOME, WORK, OTHER]

    The classification of the address.

    formatted string

    The formatted mailing address.

    street_address string

    The full street address component, which may include house number, street name, P.O. box, and multi-line extended street address information, pursuant to SCIM RFC 7643 4.1.2..

    locality string

    The city or locality component.

    region string

    The state or region component, pursuant to SCIM RFC 7643 4.1.2.

    postal_code string

    The zip code or postal code component, pursuant to SCIM RFC 7643 4.1.2.

    country string

    Possible values: [AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, BN, BG, BF, BI, CV, KH, CM, CA, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, CI, HR, CW, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HK, HU, IS, IN, ID, IQ, IR, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KR, XK, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, AN, NC, NZ, NI, NE, NG, NU, NF, MK, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RO, RU, RW, RE, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SY, SK, SI, SB, SO, ZA, GS, SS, ES, LK, SD, SR, SJ, SE, CH, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, US, UM, UY, UZ, VU, VE, VN, VG, VI, WF, EH, YE, ZM, ZW]

    The country component, pursuant to SCIM RFC 7643 4.1.2.

  • ]

  • public_url string

    Public job post URL; null when the post is not published

    language string

    BCP 47 job post language tag; defaults to en-US when not otherwise set