State Department · Schema

PassportLocation

A US passport acceptance facility location returned by the State Department Consular Affairs Data API

US GovernmentTravelPassportsVisasTravel AdvisoriesConsular AffairsForeign PolicyDiplomaticCountry InformationPublic Safety

Properties

Name Type Description
FacilityName string Official name of the passport acceptance facility. May contain '#N/A' if data is unavailable.
StreetAddress string Physical street address of the facility
City string City where the facility is located
ZipCode string US postal code of the facility
StateCode string Two-letter US state abbreviation
State string Full US state name
PhoneNumber string Contact phone number (digits only, no formatting). May contain '#N/A' if data is unavailable.
Latitude number Geographic latitude coordinate of the facility in decimal degrees
Longitude number Geographic longitude coordinate of the facility in decimal degrees
FacilityTypeCode string Single-letter code indicating facility type: G=Postal, A=Court, E=Municipal, C=Library
FacilityType string Human-readable facility type category
EmailContact string Contact email address for the facility
HourComment string Operating hours and appointment requirements for the facility
View JSON Schema on GitHub

JSON Schema

passport-location.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/state-dept/main/json-schema/passport-location.json",
  "title": "PassportLocation",
  "description": "A US passport acceptance facility location returned by the State Department Consular Affairs Data API",
  "type": "object",
  "properties": {
    "FacilityName": {
      "type": "string",
      "description": "Official name of the passport acceptance facility. May contain '#N/A' if data is unavailable.",
      "example": "USPS COLUMBIA MAIN POST OFFICE"
    },
    "StreetAddress": {
      "type": "string",
      "description": "Physical street address of the facility",
      "example": "6801 OAK HALL LANE"
    },
    "City": {
      "type": "string",
      "description": "City where the facility is located",
      "example": "COLUMBIA"
    },
    "ZipCode": {
      "type": "string",
      "pattern": "^[0-9]{5}(-[0-9]{4})?$",
      "description": "US postal code of the facility",
      "example": "21045"
    },
    "StateCode": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Z]{2}$",
      "description": "Two-letter US state abbreviation",
      "example": "MD"
    },
    "State": {
      "type": "string",
      "description": "Full US state name",
      "example": "MARYLAND"
    },
    "PhoneNumber": {
      "type": "string",
      "description": "Contact phone number (digits only, no formatting). May contain '#N/A' if data is unavailable.",
      "example": "4103814373"
    },
    "Latitude": {
      "type": "number",
      "format": "double",
      "minimum": -90,
      "maximum": 90,
      "description": "Geographic latitude coordinate of the facility in decimal degrees",
      "example": 39.1843708
    },
    "Longitude": {
      "type": "number",
      "format": "double",
      "minimum": -180,
      "maximum": 180,
      "description": "Geographic longitude coordinate of the facility in decimal degrees",
      "example": -76.8208305
    },
    "FacilityTypeCode": {
      "type": "string",
      "enum": ["G", "A", "E", "C"],
      "description": "Single-letter code indicating facility type: G=Postal, A=Court, E=Municipal, C=Library",
      "example": "G"
    },
    "FacilityType": {
      "type": "string",
      "enum": ["Postal", "Court", "Municipal", "Library"],
      "description": "Human-readable facility type category",
      "example": "Postal"
    },
    "EmailContact": {
      "type": "string",
      "format": "email",
      "description": "Contact email address for the facility",
      "example": "[email protected]"
    },
    "HourComment": {
      "type": "string",
      "description": "Operating hours and appointment requirements for the facility",
      "example": "No Appointment Necessary - Mon-Fri (8:00am -4:00pm) Sat 8:00am - 3:00pm"
    }
  },
  "required": ["StreetAddress", "City", "ZipCode", "StateCode", "State", "Latitude", "Longitude", "FacilityTypeCode", "FacilityType"],
  "examples": [
    {
      "FacilityName": "USPS COLUMBIA MAIN POST OFFICE",
      "StreetAddress": "6801 OAK HALL LANE",
      "City": "COLUMBIA",
      "ZipCode": "21045",
      "StateCode": "MD",
      "State": "MARYLAND",
      "PhoneNumber": "4103814373",
      "Latitude": 39.1843708,
      "Longitude": -76.8208305,
      "FacilityTypeCode": "G",
      "FacilityType": "Postal",
      "EmailContact": "[email protected]",
      "HourComment": "No Appointment Necessary - Mon-Fri (8:00am -4:00pm) Sat 8:00am - 3:00pm"
    },
    {
      "FacilityName": "MONTGOMERY COUNTY CIRCUIT COURT",
      "StreetAddress": "50 MARYLAND AVENUE",
      "City": "ROCKVILLE",
      "ZipCode": "20850",
      "StateCode": "MD",
      "State": "MARYLAND",
      "PhoneNumber": "3017779922",
      "Latitude": 39.0837,
      "Longitude": -77.1533,
      "FacilityTypeCode": "A",
      "FacilityType": "Court",
      "EmailContact": "#N/A",
      "HourComment": "By Appointment Only - Mon-Fri 8:30am-4:30pm"
    }
  ]
}