---
title: "What to film, for one type of space"
method: GET
path: "/capture-profiles/{space_type}"
---

# What to film, for one type of space

`GET /capture-profiles/{space_type}`

## Request

- Base URL: `https://api.spacecontext.app/v1`
- URL: `https://api.spacecontext.app/v1/capture-profiles/{space_type}`
- Auth: none required

One type of space: its key locations with a hint each, and its areas. Errors: 400 `VALIDATION_ERROR` (unknown language), 404 `NOT_FOUND` (unknown type).

## Path parameters

- `space_type` 'apartment' | 'house' | 'office' | 'warehouse' | 'vehicle' | 'boat' | 'camper' | 'shop' | 'garage' | 'appliance' | 'other', required

## Query parameters

- `language` 'en' | 'it' | 'es' | 'fr' | 'de' | 'pt' | 'nl'

## Response `200`

The capture profile

- CaptureProfile
  - `object` 'capture_profile', required
  - `space_type` 'apartment' | 'house' | 'office' | 'warehouse' | 'vehicle' | 'boat' | 'camper' | 'shop' | 'garage' | 'appliance' | 'other', required
  - `language` 'en' | 'it' | 'es' | 'fr' | 'de' | 'pt' | 'nl', required
  - `key_locations` object[], required: In the order to show them.
    - `kind` 'electrical_panel' | 'water_shutoff' | 'gas_shutoff' | 'water_heater' | 'heating_control' | 'air_conditioning_control' | 'router' | 'fire_extinguisher' | 'smoke_detector' | 'first_aid' | 'emergency_exit' | 'keys' | 'waste_recycling' | 'electricity_meter' | 'gas_meter' | 'water_meter' | 'alarm_panel' | 'spare_supplies' | 'identification_plate' | 'instrument_panel' | 'engine_bay' | 'spare_wheel' | 'safety_equipment' | 'battery_isolator' | 'bilge_pump' | 'seacock' | 'fuel_shutoff' | 'water_tank' | 'sprinkler_valve' | 'control_panel' | 'filter' | 'utility_connections' | 'other', required
    - `label` string, required
    - `hint` string, required: What to film, in one line.
    - `expected` boolean, required: Usually there: worth a reminder when not filmed. Otherwise: if there is one.
  - `areas` object[], required: The areas `POST /frames/check?space_type=` can answer. Empty for an appliance.
    - `value` 'entrance' | 'hallway' | 'living_room' | 'kitchen' | 'dining_room' | 'bedroom' | 'bathroom' | 'laundry' | 'storage' | 'balcony' | 'garden' | 'garage' | 'stairs' | 'exterior' | 'reception' | 'open_space' | 'office_room' | 'meeting_room' | 'server_room' | 'sales_floor' | 'checkout' | 'fitting_room' | 'stockroom' | 'loading_dock' | 'storage_area' | 'mezzanine' | 'cab' | 'living_area' | 'deck' | 'cockpit' | 'cabin' | 'galley' | 'engine_room' | 'exterior_front' | 'exterior_rear' | 'exterior_side' | 'interior_front' | 'interior_rear' | 'trunk' | 'engine_compartment', required
    - `label` string, required

## Other responses

- `400`: Error response
- `404`: Error response

---

[API](https://skmtc.dev/spacecontext/apis/space-context-api.md) · [All operations](https://skmtc.dev/spacecontext/apis/space-context-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacecontext/apis/space-context-api/revisions/1dca940259b4?raw)