{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/bindbee/main/json-schema/bindbee-candidate-schema.json",
  "title": "AtsCandidate",
  "x-provenance": {
    "generated": "2026-09-04",
    "method": "derived",
    "source": "openapi/_original/bindbee-openapi.json",
    "source_url": "https://api.bindbee.dev/openapi.json",
    "note": "Extracted verbatim from the provider-published contract, with $refs rewritten from #/components/schemas to #/$defs. Replaces a scaffold whose envelope (data/next_cursor/has_more) does not exist in the Bindbee API \u2014 the real one is cursor/page_size/items."
  },
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "title": "Id",
      "examples": [
        "018b18ef-c487-703c-afd9-0ca478ccd9d6"
      ]
    },
    "remote_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Remote Id",
      "description": "The third-party API ID of the matching object.",
      "examples": [
        "123321"
      ]
    },
    "modified_at": {
      "type": "string",
      "format": "date-time",
      "title": "Modified At",
      "description": "This is the datetime that this object was last updated by Bindbee",
      "examples": [
        "2021-10-16T00:00:00Z"
      ]
    },
    "raw_data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Raw Data",
      "description": "This is the Raw data",
      "examples": [
        {
          "key_1": "Platform dependent data 1",
          "key_2": "Platform dependent data 2"
        }
      ]
    },
    "custom_fields": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Custom Fields",
      "description": "The custom fields related to the model",
      "examples": [
        {
          "category_group": "REG",
          "disability_type": "ASBERG",
          "hire_date": "1991-03-16T00:00:00",
          "hire_source": "REFER",
          "nationality": "USA",
          "original_hire_date": "1991-03-16T00:00:00"
        }
      ]
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "First Name",
      "description": "The candidate's first name.",
      "examples": [
        "John"
      ]
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Name",
      "description": "The candidate's last name.",
      "examples": [
        "Doe"
      ]
    },
    "company": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Company",
      "description": "The name of the company where candidate has applied.",
      "examples": [
        "Google"
      ]
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Title",
      "description": "The position for which the candidate has applied",
      "examples": [
        "SOFTWARE ENGINEER"
      ]
    },
    "last_interaction_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Interaction At",
      "description": "The date of the last interaction with the candidate.",
      "examples": [
        "2021-07-01T00:00:00Z"
      ]
    },
    "is_private": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Private",
      "description": "Whether the candidate's information is private.",
      "examples": [
        true
      ]
    },
    "can_email": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Can Email",
      "description": "Whether the candidate can be emailed.",
      "examples": [
        true
      ]
    },
    "locations": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Locations",
      "description": "The location of the candidate.",
      "examples": [
        "San Francisco",
        "New York"
      ]
    },
    "phone_numbers": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Phone Numbers",
      "description": "The candidate's phone numbers.",
      "examples": [
        "123-456-7890"
      ]
    },
    "email_addresses": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Email Addresses",
      "description": "The candidate's email addresses.",
      "examples": [
        "john@doe.com"
      ]
    },
    "urls": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/AtsUrl"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Urls",
      "description": "The candidate's URLs. This can include a personal website, LinkedIn profile, or other relevant URLs.",
      "examples": [
        {
          "type": "LINKEDIN",
          "value": "https://www.linkedin.com/in/johndoe"
        }
      ]
    },
    "tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tags",
      "description": "The candidate's tags. Tags are used to categorize candidates and can be used to filter candidates in the UI.",
      "examples": [
        "JUNIOR",
        "INTERMEDIATE"
      ]
    },
    "applications": {
      "anyOf": [
        {
          "items": {},
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Applications",
      "description": "The candidate's applications.",
      "examples": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65"
      ]
    },
    "attachments": {
      "anyOf": [
        {
          "items": {},
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Attachments",
      "description": "The candidate's attachments.",
      "examples": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65"
      ]
    },
    "remote_created_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Remote Created At",
      "description": "When the third party's candidate was created.",
      "examples": [
        "2021-07-01T00:00:00Z"
      ]
    },
    "remote_updated_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Remote Updated At",
      "description": "When the third party's candidate was last updated.",
      "examples": [
        "2021-07-01T00:00:00Z"
      ]
    },
    "avatar": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Avatar",
      "description": "The candidate's avatar.",
      "examples": [
        "https://www.example.com/avatar.jpg"
      ]
    }
  },
  "type": "object",
  "required": [
    "id",
    "remote_id",
    "modified_at",
    "custom_fields"
  ],
  "$defs": {
    "AtsUrl": {
      "properties": {
        "value": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Value",
          "description": "The site's url."
        },
        "url_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "enum": [
            "PERSONAL",
            "COMPANY",
            "PORTFOLIO",
            "BLOG",
            "SOCIAL_MEDIA",
            "OTHER",
            "JOB_POSTING",
            "-"
          ],
          "title": "Url Type",
          "description": "The type of site. If the value is not one of the defined enum values, the original value passed through will be returned."
        }
      },
      "type": "object",
      "required": [
        "value",
        "url_type"
      ],
      "title": "AtsUrl"
    }
  }
}