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 |
JSON Schema
{
"$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"
}
]
}