Spaces

Get a warehouse or space

Returns the detail of a warehouse or space by its identifier, with its capacity, surface area, amenities and custom fields.

Tool

filmo_spaces_get

Readspaces:read

spaces:read
120/min
Server annotation: Read-only
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_spaces_get",
    "arguments": {
      "spaceId": "spac_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "name": "Example",
      "internalReference": "<internalReference>",
      "isWarehouse": true,
      "collectionId": "coll_8f2a1c",
      "collectionName": "Example",
      "building": "<building>",
      "floor": 1,
      "location": {
        "address": "<address>",
        "city": "<city>",
        "postalCode": "<postalCode>",
        "country": "ES",
        "lat": 1,
        "lng": 1
      },
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z",
      "description": "<description>",
      "capacity": 1,
      "area": 1,
      "dimensions": "<dimensions>",
      "amenities": [
        "<amenities>"
      ],
      "equipments": [
        "<equipments>"
      ],
      "pricingSettings": {
        "type": "periodPrice",
        "price": "1234.50",
        "period": "hour"
      },
      "insuranceEnabled": true,
      "discountEnabled": true,
      "depositValue": "1234.50",
      "bufferBefore": 1,
      "bufferBeforeUnit": "hour",
      "bufferAfter": 1,
      "bufferAfterUnit": "hour",
      "customFields": {
        "key": "<key>"
      }
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}

generated from the schema

Arguments

spaceIdstringRequired

Space identifier.

Limits: min length 1

Result

On success the result carries structuredContent with data and meta. These are the attributes of data.

Show the attributes of data

idstring

Unique space identifier.

namestring

Space name.

internalReferencestring | null

Internal reference of the space, useful for matching with external systems; null if it has none.

isWarehouseboolean

true if the space is a warehouse that manages stock and can be the main warehouse of an order; false if it is a rentable space.

collectionIdstring | null

Identifier of the collection it belongs to; null if it is in none.

collectionNamestring | null

Full collection path, for example "Estudios > Fotografía"; null if not applicable.

buildingstring | null

Building it is located in; null if not applicable.

floornumber | null

Floor it is located on; null if not applicable.

locationobject

Physical location of the space.

Show child attributes

location.addressstring | null

Postal address; null if not recorded.

location.citystring | null

Municipality; null if not recorded.

location.postalCodestring | null

Postal code; null if not recorded.

location.countrystring | null

Country; null if not recorded.

location.latnumber | null

Latitude in decimal degrees; null if not geolocated.

location.lngnumber | null

Longitude in decimal degrees; null if not geolocated.

createdAtstring<date-time>

Creation date in ISO 8601 UTC.

updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

descriptionstring | null

Space description; null if it has none.

capacitynumber | null

Capacity in people; null if not defined.

areanumber | null

Area in square metres; null if not defined.

dimensionsstring | null

Dimensions as free text; null if not defined.

amenitiesstring[]

Additional services available (wifi, projector...).

equipmentsstring[]

Fixed equipment available in the space.

pricingSettingsobject | null

Rental pricing of the space; null if not configured. The same fields that PATCH /pricing accepts.

Show child attributes

pricingSettings.typestring | null

Pricing mode; null if not configured.

Available options: periodPrice, fixedPrice, pricingStructure

pricingSettings.pricestring | null

Base rental price as a decimal string; null if not configured.

Limits: pattern ^-?\d+\.\d{2}$

pricingSettings.periodstring | null

Period unit of the price; null if not configured.

Available options: hour, day, week, month

insuranceEnabledboolean

Whether the space allows insurance.

discountEnabledboolean

Whether the space allows a discount.

depositValuestring | null

Security deposit amount as a decimal string; null if not set.

Limits: pattern ^-?\d+\.\d{2}$

bufferBeforenumber | null

Time buffer reserved BEFORE the rental; null if none.

bufferBeforeUnitstring | null

Unit of the preceding buffer; null if none.

Available options: hour, day

bufferAfternumber | null

Time buffer reserved AFTER the rental; null if none.

bufferAfterUnitstring | null

Unit of the following buffer; null if none.

Available options: hour, day

customFieldsobject<string, any>

Custom field values by custom field identifier; the definitions are in /api/v1/custom-fields.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

The same operation by REST

This tool runs GET /api/v1/spaces/{spaceId}.

Spaces
Get a warehouse or space
Returns the detail of a warehouse or space by its identifier, with its capacity, surface area, amenities and custom fields.
Guides
Safe writes
An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.
Guides
Errors
A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?

Result

Arguments

Result

The same operation by REST

Related pages

Get a warehouse or space

Safe writes

Errors