> This page is for Unified. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. The `Job` object can be used to track any jobs that are currently or will be open/closed for applications. ### The Job Object ```json { "id": "string", "remote_id": "string", "created_at": "2023-01-01T00:00:00Z", "modified_at": "2023-01-01T00:00:00Z", "name": "string", "description": "string", "code": "string", "status": "OPEN", "type": "POSTING", "job_postings": [ "string" ], "job_posting_urls": [ { "created_at": "2023-01-01T00:00:00Z", "modified_at": "2023-01-01T00:00:00Z", "value": "string", "url_type": "PERSONAL", "remote_was_deleted": true } ], "remote_created_at": "2023-01-01T00:00:00Z", "remote_updated_at": "2023-01-01T00:00:00Z", "confidential": true, "departments": [ "string" ], "offices": [ "string" ], "hiring_managers": [ "string" ], "recruiters": [ "string" ], "remote_was_deleted": true, "field_mappings": { "organization_defined_targets": { "string": {} }, "linked_account_defined_targets": { "string": {} } }, "remote_data": [ { "path": "string", "data": {} } ] } ``` ### Schema (`Job`) ```yaml components: schemas: JobStatusEnum: type: string enum: - OPEN - CLOSED - DRAFT - ARCHIVED - PENDING title: JobStatusEnum JobTypeEnum: type: string enum: - POSTING - REQUISITION - PROFILE title: JobTypeEnum UrlTypeEnum: type: string enum: - PERSONAL - COMPANY - PORTFOLIO - BLOG - SOCIAL_MEDIA - OTHER - JOB_POSTING title: UrlTypeEnum Url: type: object properties: created_at: type: string format: date-time description: The datetime that this object was created by Merge. modified_at: type: string format: date-time description: The datetime that this object was modified by Merge. value: type: - string - 'null' format: uri maxLength: 2000 description: The site's url. url_type: oneOf: - $ref: '#/components/schemas/UrlTypeEnum' - type: 'null' description: The type of site. remote_was_deleted: type: boolean description: >- Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/). description: >- # The Url Object ### Description The `Url` object is used to represent hyperlinks associated with the parent model. ### Usage Example Fetch from the `GET Candidate` endpoint and view their website urls. title: Url JobFieldMappings: type: object properties: organization_defined_targets: type: object additionalProperties: description: Any type linked_account_defined_targets: type: object additionalProperties: description: Any type title: JobFieldMappings RemoteData: type: object properties: path: type: string description: The third-party API path that is being called. data: description: >- The data returned from the third-party for this object in its original, unnormalized format. required: - path description: >- # The RemoteData Object ### Description The `RemoteData` object is used to represent the full data pulled from the third-party API for an object. ### Usage Example TODO title: RemoteData Job: type: object properties: id: type: string format: uuid remote_id: type: - string - 'null' description: The third-party API ID of the matching object. created_at: type: string format: date-time description: The datetime that this object was created by Merge. modified_at: type: string format: date-time description: The datetime that this object was modified by Merge. name: type: - string - 'null' description: The job's name. description: type: - string - 'null' description: The job's description. code: type: - string - 'null' description: >- The job's code. Typically an additional identifier used to reference the particular job that is displayed on the ATS. status: oneOf: - $ref: '#/components/schemas/JobStatusEnum' - type: 'null' description: >- The job's status. This field is an open enum: Merge can return a value outside this list when an integration provides one it does not map. Pass `show_enum_origins=status` to receive the integration's own value instead. type: oneOf: - $ref: '#/components/schemas/JobTypeEnum' - type: 'null' description: The job's type. job_postings: type: array items: type: string format: uuid description: >- IDs of `JobPosting` objects that serve as job postings for this `Job`. job_posting_urls: type: array items: $ref: '#/components/schemas/Url' remote_created_at: type: - string - 'null' format: date-time description: When the third party's job was created. remote_updated_at: type: - string - 'null' format: date-time description: When the third party's job was updated. confidential: type: - boolean - 'null' description: Whether the job is confidential. departments: type: array items: type: string format: uuid description: IDs of `Department` objects for this `Job`. offices: type: array items: type: string format: uuid description: IDs of `Office` objects for this `Job`. hiring_managers: type: array items: type: string format: uuid description: >- IDs of `RemoteUser` objects that serve as hiring managers for this `Job`. recruiters: type: array items: type: string format: uuid description: IDs of `RemoteUser` objects that serve as recruiters for this `Job`. remote_was_deleted: type: boolean description: >- Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/). field_mappings: oneOf: - $ref: '#/components/schemas/JobFieldMappings' - type: 'null' remote_data: type: - array - 'null' items: $ref: '#/components/schemas/RemoteData' title: Job ```