type: object properties: id: type: integer description: A unique identifier. readOnly: true example: 4 name: type: string description: Unique but short name of the candidate. example: A new school ballots: type: array description: The ballots received by this candidate. items: $ref: ./ballot.yaml