Reprompt
Guides

Entrances API

Get entrances, access points, and building data for any address

Overview

Given an address, the Entrances API returns the exact location of every entrance, what access points you need to pass through, and the building and compound context.

Response
├── place_name, address, lat/lng
├── entrances[]         shared and unit entrances to the place
├── access_points[]     gates / checkpoints to reach it
├── building {}         type, geofence, floor count
└── compound {} | null  compound context, if inside one

Most responses have compound: null — the address maps to a standalone building. When the building sits inside a compound (mall, campus, gated community), the compound field provides the boundary, type, and ID you can use to fetch the full compound view.


Request

POST /v1/entrances
curl -X POST \
  'https://api.repromptai.com/v1/entrances' \
  -H 'Authorization: Bearer {YOUR_API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "7 Carmine St, New York, NY 10014",
    "name": "Joes Pizza",
    "latitude": 40.7359,
    "longitude": -73.9911
  }'
import requests

response = requests.post(
    "https://api.repromptai.com/v1/entrances",
    headers={
        "Authorization": "Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "address": "7 Carmine St, New York, NY 10014",
        "name": "Joes Pizza",
        "latitude": 40.7359,
        "longitude": -73.9911,
    },
)
print(response.json())
const response = await fetch("https://api.repromptai.com/v1/entrances", {
  method: "POST",
  headers: {
    Authorization: "Bearer {YOUR_API_KEY}",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    address: "7 Carmine St, New York, NY 10014",
    name: "Joes Pizza",
    latitude: 40.7359,
    longitude: -73.9911,
  }),
});
console.log(await response.json());

Request Fields

FieldTypeRequiredDescription
addressstringYesFull street address
namestringNoPlace or business name — helps locate the right building within a compound
latitudenumberNoLatitude (-90 to 90) — improves geocoding accuracy
longitudenumberNoLongitude (-180 to 180) — improves geocoding accuracy

Response Example

{
  "place_name": "Joes Pizza",
  "address": "7 Carmine St, New York, NY 10014",
  "latitude": 40.7359,
  "longitude": -73.9911,
  "entrances": [
    {
      "entrance_id": "ent_main_01",
      "entrance_type": "MAIN",
      "entrance_scope": "SHARED",
      "latitude": 40.7359,
      "longitude": -73.9911,
      "name": "Front entrance",
      "floor": 0,
      "tags": ["wheelchair_accessible"],
      "preferred_parking": [],
      "unit": null
    }
  ],
  "access_points": [
    {
      "access_point_id": "ap_001",
      "access_type": "VEHICLE_ENTRY",
      "access_control": "OPEN",
      "latitude": 40.7358,
      "longitude": -73.9912,
      "name": "Main parking entrance",
      "operating_hours": { "open": "06:00", "close": "23:00" },
      "tags": ["parking"]
    }
  ],
  "building": {
    "building_type": "COMMERCIAL",
    "building_geofence": {
      "type": "Polygon",
      "coordinates": [[[-73.9913, 40.7358], [-73.9909, 40.7358], [-73.9909, 40.7361], [-73.9913, 40.7361], [-73.9913, 40.7358]]]
    },
    "floor_count": 2
  },
  "compound": null
}

Schema Reference

Entrance

FieldTypeDescription
entrance_idstringUnique identifier
entrance_typeenumMAIN, SECONDARY, SERVICE, EMERGENCY, GATE
entrance_scopeenumUNIT (specific unit) or SHARED (common entrance)
latitudenumberEntrance latitude
longitudenumberEntrance longitude
namestring | nullHuman-readable label
floornumber | nullFloor level (0 = ground)
tagsstring[]Descriptive tags (e.g. wheelchair_accessible)
unitstring | nullUnit number (when scope is UNIT)

Access Point

FieldTypeDescription
access_point_idstringUnique identifier
access_typeenumGATE, VEHICLE_ENTRY, PEDESTRIAN_ENTRY, SECURITY_CHECKPOINT, LOADING_DOCK_ENTRY
access_controlenumOPEN, BUZZER, KEY_CODE, GUARD, RFID, CALL_BOX, INTERCOM, NONE
latitudenumberAccess point latitude
longitudenumberAccess point longitude
namestring | nullHuman-readable label
operating_hoursobject | null{ "open": "HH:MM", "close": "HH:MM" }

Building

FieldTypeDescription
building_typeenumRESIDENTIAL, COMMERCIAL, INDUSTRIAL, CIVIC, EDUCATION, MEDICAL, ENTERTAINMENT, RELIGIOUS, TRANSPORTATION, HOSPITALITY, MIXED_USE, AGRICULTURAL, MILITARY, UTILITY
building_geofenceGeoJSON Polygon | nullBuilding footprint
floor_countnumber | nullNumber of floors

Compound

FieldTypeDescription
compound_idstringUnique identifier (use with /v1/compounds/{compound_id})
compound_namestringDisplay name
compound_typeenumAPARTMENT_COMPLEX, SHOPPING_MALL, STRIP_MALL, OFFICE_PARK, HOSPITAL_CAMPUS, UNIVERSITY_CAMPUS, GATED_COMMUNITY, MIXED_USE_COMPLEX, INDUSTRIAL_PARK
compound_geofenceGeoJSON PolygonBoundary of the compound

On this page