ContactCollectionResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-exchange/json-schema/microsoft-exchange-contact-collection-response-schema.json",
  "title": "ContactCollectionResponse",
  "description": "Collection of contacts",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-exchange-contact-folders-api-openapi.yml#/components/schemas/ContactCollectionResponse",
  "type": "object",
  "properties": {
    "@odata.context": {
      "type": "string"
    },
    "@odata.nextLink": {
      "type": "string",
      "format": "uri"
    },
    "value": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Contact"
      }
    }
  },
  "$defs": {
    "Contact": {
      "type": "object",
      "description": "A contact is an item in Outlook where you can organize and save information about people and organizations you communicate with. Contacts are contained in contact folders.",
      "properties": {
        "id": {
          "type": "string",
          "readOnly": true,
          "description": "The contact's unique identifier"
        },
        "displayName": {
          "type": "string",
          "description": "The contact's display name"
        },
        "givenName": {
          "type": "string",
          "description": "The contact's given name (first name)"
        },
        "surname": {
          "type": "string",
          "description": "The contact's surname (last name)"
        },
        "middleName": {
          "type": "string",
          "description": "The contact's middle name"
        },
        "nickName": {
          "type": "string",
          "description": "The contact's nickname"
        },
        "title": {
          "type": "string",
          "description": "The contact's title"
        },
        "initials": {
          "type": "string",
          "description": "The contact's initials"
        },
        "generation": {
          "type": "string",
          "description": "The contact's suffix"
        },
        "emailAddresses": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/EmailAddress"
          },
          "description": "The contact's email addresses"
        },
        "businessPhones": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The contact's business phone numbers"
        },
        "homePhones": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The contact's home phone numbers"
        },
        "mobilePhone": {
          "type": "string",
          "description": "The contact's mobile phone number"
        },
        "imAddresses": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The contact's instant messaging addresses"
        },
        "jobTitle": {
          "type": "string",
          "description": "The contact's job title"
        },
        "companyName": {
          "type": "string",
          "description": "The name of the contact's company"
        },
        "department": {
          "type": "string",
          "description": "The contact's department"
        },
        "officeLocation": {
          "type": "string",
          "description": "The location of the contact's office"
        },
        "profession": {
          "type": "string",
          "description": "The contact's profession"
        },
        "manager": {
          "type": "string",
          "description": "The name of the contact's manager"
        },
        "assistantName": {
          "type": "string",
          "description": "The name of the contact's assistant"
        },
        "businessHomePage": {
          "type": "string",
          "description": "The business home page of the contact"
        },
        "businessAddress": {
          "$ref": "#/$defs/PhysicalAddress"
        },
        "homeAddress": {
          "$ref": "#/$defs/PhysicalAddress"
        },
        "otherAddress": {
          "$ref": "#/$defs/PhysicalAddress"
        },
        "spouseName": {
          "type": "string",
          "description": "The name of the contact's spouse or partner"
        },
        "birthday": {
          "type": "string",
          "format": "date-time",
          "description": "The contact's birthday in ISO 8601 format (always UTC)"
        },
        "children": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The names of the contact's children"
        },
        "personalNotes": {
          "type": "string",
          "description": "The user's notes about the contact"
        },
        "fileAs": {
          "type": "string",
          "description": "The name the contact is filed under"
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The categories associated with the contact"
        },
        "parentFolderId": {
          "type": "string",
          "readOnly": true,
          "description": "The ID of the contact's parent folder"
        },
        "changeKey": {
          "type": "string",
          "readOnly": true,
          "description": "Identifies the version of the contact"
        },
        "createdDateTime": {
          "type": "string",
          "format": "date-time",
          "readOnly": true,
          "description": "The time the contact was created"
        },
        "lastModifiedDateTime": {
          "type": "string",
          "format": "date-time",
          "readOnly": true,
          "description": "The time the contact was last modified"
        },
        "yomiGivenName": {
          "type": "string",
          "description": "Phonetic Japanese given name"
        },
        "yomiSurname": {
          "type": "string",
          "description": "Phonetic Japanese surname"
        },
        "yomiCompanyName": {
          "type": "string",
          "description": "Phonetic Japanese company name"
        }
      }
    },
    "EmailAddress": {
      "type": "object",
      "description": "Email address of a contact",
      "properties": {
        "name": {
          "type": "string",
          "description": "The display name"
        },
        "address": {
          "type": "string",
          "format": "email",
          "description": "The email address"
        }
      }
    },
    "PhysicalAddress": {
      "type": "object",
      "description": "Physical street address",
      "properties": {
        "street": {
          "type": "string",
          "description": "The street address"
        },
        "city": {
          "type": "string",
          "description": "The city"
        },
        "state": {
          "type": "string",
          "description": "The state or province"
        },
        "countryOrRegion": {
          "type": "string",
          "description": "The country or region"
        },
        "postalCode": {
          "type": "string",
          "description": "The postal code"
        }
      }
    }
  }
}