mysociety/popit-api

{
  "$schema": "http://json-schema.org/draft-03/schema#",
  "id": "http://www.popoloproject.com/schemas/other_name.json#",
  "title": "Other name",
  "description": "An alternate or former name",
  "type": "object",
  "properties": {
    "name": {
      "description": "An alternate or former name",
      "type": "string",
      "required": true
    },
    "family_name": {
      "description": "One or more family names",
      "type": ["string", "null"]
    },
    "given_name": {
      "description": "One or more primary given names",
      "type": ["string", "null"]
    },
    "additional_name": {
      "description": "One or more secondary given names",
      "type": ["string", "null"]
    },
    "honorific_prefix": {
      "description": "One or more honorifics preceding a person's name",
      "type": ["string", "null"]
    },
    "honorific_suffix": {
      "description": "One or more honorifics following a person's name",
      "type": ["string", "null"]
    },
    "patronymic_name": {
      "description": "One or more patronymic names",
      "type": ["string", "null"]
    },
    "start_date": {
      "description": "The date on which the name was adopted",
      "type": ["string", "null"],
      "pattern": "^[0-9]{4}(-[0-9]{2}){0,2}$"
    },
    "end_date": {
      "description": "The date on which the name was abandoned",
      "type": ["string", "null"],
      "pattern": "^[0-9]{4}(-[0-9]{2}){0,2}$"
    },
    "note": {
      "description": "A note, e.g. 'Birth name'",
      "type": ["string", "null"]
    }
  }
}