Ashby · Schema

Ashby Application

Schema for the Ashby Application resource — a candidate's application to a specific job. Backs application.create, application.info, application.list, application.update, application.transfer, application.changeStage, application.changeSource, application.listHistory, application.listCriteriaEvaluations, and the applicationSubmit / applicationUpdate webhooks.

ATSApplicant Tracking SystemRecruitingTalent AcquisitionSourcingCRMSchedulingAnalyticsHiringHR TechAI

Properties

Name	Type	Description
id	string
createdAt	string
updatedAt	string
status	string	Application lifecycle state.
customFields	array
candidate	object
job	object
currentInterviewStage	object
source	object
creditedToUser	object
hiringTeam	array
archiveReason	object
applicationForm	object	Custom application form responses (file uploads, text answers, multi-selects) submitted via applicationForm.submit.
criteriaEvaluations	array	AI-generated criteria evaluations (requires AI Application Review feature enabled).

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.com/schemas/ashby-hq/ashby-application-schema.json",
  "title": "Ashby Application",
  "description": "Schema for the Ashby Application resource — a candidate's application to a specific job. Backs application.create, application.info, application.list, application.update, application.transfer, application.changeStage, application.changeSource, application.listHistory, application.listCriteriaEvaluations, and the applicationSubmit / applicationUpdate webhooks.",
  "type": "object",
  "properties": {
    "id": { "type": "string", "format": "uuid" },
    "createdAt": { "type": "string", "format": "date-time" },
    "updatedAt": { "type": "string", "format": "date-time" },
    "status": {
      "type": "string",
      "enum": ["Active", "Hired", "Archived", "Lead"],
      "description": "Application lifecycle state."
    },
    "customFields": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": { "type": "string", "format": "uuid" },
          "title": { "type": "string" },
          "value": {},
          "valueType": { "type": "string" }
        }
      }
    },
    "candidate": {
      "type": "object",
      "properties": {
        "id": { "type": "string", "format": "uuid" },
        "name": { "type": "string" }
      }
    },
    "job": {
      "type": "object",
      "properties": {
        "id": { "type": "string", "format": "uuid" },
        "title": { "type": "string" }
      }
    },
    "currentInterviewStage": {
      "type": "object",
      "properties": {
        "id": { "type": "string", "format": "uuid" },
        "title": { "type": "string" },
        "orderInInterviewPlan": { "type": "integer" },
        "interviewStageGroup": {
          "type": "object",
          "properties": {
            "id": { "type": "string", "format": "uuid" },
            "title": { "type": "string" },
            "type": {
              "type": "string",
              "enum": ["PreApplication", "Active", "Offer", "Hired", "Archived"]
            }
          }
        }
      }
    },
    "source": {
      "type": "object",
      "properties": {
        "id": { "type": "string", "format": "uuid" },
        "title": { "type": "string" }
      }
    },
    "creditedToUser": {
      "type": "object",
      "properties": {
        "id": { "type": "string", "format": "uuid" },
        "name": { "type": "string" }
      }
    },
    "hiringTeam": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "userId": { "type": "string", "format": "uuid" },
          "roleId": { "type": "string", "format": "uuid" },
          "name": { "type": "string" },
          "role": { "type": "string" }
        }
      }
    },
    "archiveReason": {
      "type": "object",
      "properties": {
        "id": { "type": "string", "format": "uuid" },
        "text": { "type": "string" },
        "reasonType": { "type": "string", "enum": ["Hired", "RejectedByCandidate", "RejectedByOrganization", "Withdrawn"] }
      }
    },
    "applicationForm": {
      "type": "object",
      "description": "Custom application form responses (file uploads, text answers, multi-selects) submitted via applicationForm.submit."
    },
    "criteriaEvaluations": {
      "type": "array",
      "description": "AI-generated criteria evaluations (requires AI Application Review feature enabled).",
      "items": {
        "type": "object",
        "properties": {
          "criterionId": { "type": "string", "format": "uuid" },
          "outcome": {
            "type": "string",
            "enum": ["StrongMatch", "Match", "PartialMatch", "NoMatch"]
          },
          "reasoning": { "type": "string" },
          "evaluatedAt": { "type": "string", "format": "date-time" }
        }
      }
    }
  },
  "required": ["id", "createdAt", "updatedAt", "status", "candidate", "job"]
}