Day view of a map: status, vessel, contract, presence, release, fit, deadlines and anomalies per element on the night of date (default today); customer names only with customers.read (map.view)

GET

/api/admin/v1/marinas/{marinaId}/maps/{mapId}/day

Shell / cURL

curl --request GET \
  --url https://example.com/api/admin/v1/marinas/example/maps/example/day \
  --cookie porto_session=<porto_session>

Authorizations

Parameters

Path Parameters

marinaId

required

string

mapId

required

string

Query Parameters

date

Calendar date YYYY-MM-DD in the marina timezone

string format: date

Night (default today in the marina timezone)

Responses

200

application/json

object

map_id

required

string

date

required

Calendar date YYYY-MM-DD in the marina timezone

string format: date

map_version

required

integer

generated_at

required

string format: date-time

elements

required

Array<object>

object

resource_type

required

string

Allowed values: berth dynamic_area land_resource

resource_id

required

string

code

required

string

status

required

string

Allowed values: free hold contract transit block maintenance owner released closed

allocation_id

string

allocation_version

integer

kind

string

Allowed values: hold contract transit owner block maintenance

hold_expires_at

string format: date-time

contract

object

required

string

kind

required

string

Allowed values: mooring transit storage charter

term

string

Allowed values: annual seasonal monthly period

status

required

Mooring statuses (draft..suspended) and transit statuses (held..awaiting_approval)

string

Allowed values: draft awaiting_signature active expired renewed terminated cancelled suspended held pending_payment confirmed arrived departed no_show awaiting_approval

code

required

ORM-2026-0001, TRN-2026-0001

string

vessel

The vessel embedded in occupancy and contract views (no registration, no owner)

object

required

string

name

required

string

loa_cm

required

Length in integer centimetres

integer format: int64

beam_cm

required

Length in integer centimetres

integer format: int64

hull_type

required

string

Allowed values: monohull_motor monohull_sail catamaran trimaran rib gozzo other

draft_cm

Length in integer centimetres

integer format: int64

customer

The customer embedded in views; display_name only with customers.read

object

required

string

display_name

string

presence

object

state

required

string

Allowed values: in_port out ashore yard

since

required

string format: date-time

expected_return_on

Calendar date YYYY-MM-DD in the marina timezone

string format: date

away_days

required

integer

release

object

required

string

from

required

Calendar date YYYY-MM-DD in the marina timezone

string format: date

required

Calendar date YYYY-MM-DD in the marina timezone

string format: date

resold

required

boolean

arrival_today

required

boolean

departure_today

required

boolean

fit

object

fill_bp

required

Percentage in integer basis points (1 % = 100)

integer format: int64

override

required

boolean

blocking_codes

required

Array<string>

Allowed values: loa_exceeds beam_exceeds draft_exceeds air_draft_exceeds multihull_not_allowed vessel_invalid fill_below_threshold depth_near_limit power_insufficient insurance_missing insurance_expires_in_period overhang support_not_allowed weight_exceeds

deadlines

object

contract_ends_on

Calendar date YYYY-MM-DD in the marina timezone

string format: date

insurance

required

string

Allowed values: ok expiring expired missing

documents

required

string

Allowed values: ok expiring expired missing

utilities

object

power_a

integer

power_phase

string

Allowed values: single three

water

required

boolean

anomalies

required

Array<string>

Allowed values: presence_without_allocation not_arrived departure_overdue vessel_exceeds_limits insurance_expired_active hold_lost_draft

area_placements

required

Array<object>

object

area_id

required

string

allocation_id

required

string

allocation_version

required

integer

x_cm

required

Length in integer centimetres

integer format: int64

y_cm

Length in integer centimetres

integer format: int64

rotation_dd

Angle in tenths of a degree, 0 = +x, 900 = +y (y down, clockwise on screen)

integer format: int64

<= 3599

cells

required

Occupied cells of an area placement; linear areas give first/last, surfaces the indexes

object

first

integer

last

integer

indexes

Array<integer>

status

required

string

Allowed values: free hold contract transit block maintenance owner released closed

kind

required

string

Allowed values: hold contract transit owner block maintenance

contract

object

required

string

kind

required

string

Allowed values: mooring transit storage charter

term

string

Allowed values: annual seasonal monthly period

status

required

Mooring statuses (draft..suspended) and transit statuses (held..awaiting_approval)

string

Allowed values: draft awaiting_signature active expired renewed terminated cancelled suspended held pending_payment confirmed arrived departed no_show awaiting_approval

code

required

ORM-2026-0001, TRN-2026-0001

string

vessel

required

The vessel embedded in occupancy and contract views (no registration, no owner)

object

required

string

name

required

string

loa_cm

required

Length in integer centimetres

integer format: int64

beam_cm

required

Length in integer centimetres

integer format: int64

hull_type

required

string

Allowed values: monohull_motor monohull_sail catamaran trimaran rib gozzo other

draft_cm

Length in integer centimetres

integer format: int64

customer

The customer embedded in views; display_name only with customers.read

object

required

string

display_name

string

presence

object

state

required

string

Allowed values: in_port out ashore yard

since

required

string format: date-time

expected_return_on

Calendar date YYYY-MM-DD in the marina timezone

string format: date

away_days

required

integer

fit

object

fill_bp

required

Percentage in integer basis points (1 % = 100)

integer format: int64

override

required

boolean

blocking_codes

required

Array<string>

anomalies

required

Array<string>

Allowed values: presence_without_allocation not_arrived departure_overdue vessel_exceeds_limits insurance_expired_active hold_lost_draft

unplaced

required

Array<object>

object

vessel

required

The vessel embedded in occupancy and contract views (no registration, no owner)

object

required

string

name

required

string

loa_cm

required

Length in integer centimetres

integer format: int64

beam_cm

required

Length in integer centimetres

integer format: int64

hull_type

required

string

Allowed values: monohull_motor monohull_sail catamaran trimaran rib gozzo other

draft_cm

Length in integer centimetres

integer format: int64

presence_id

required

string

reason

required

string

Allowed values: arrived_without_booking

counts

required

object

anomalies

required

integer

Example

{
  "elements": [
    {
      "resource_type": "berth",
      "status": "free",
      "kind": "hold",
      "contract": {
        "kind": "mooring",
        "term": "annual",
        "status": "draft"
      },
      "vessel": {
        "hull_type": "monohull_motor"
      },
      "presence": {
        "state": "in_port"
      },
      "fit": {
        "blocking_codes": [
          "loa_exceeds"
        ]
      },
      "deadlines": {
        "insurance": "ok",
        "documents": "ok"
      },
      "utilities": {
        "power_phase": "single"
      },
      "anomalies": [
        "presence_without_allocation"
      ]
    }
  ],
  "area_placements": [
    {
      "status": "free",
      "kind": "hold",
      "contract": {
        "kind": "mooring",
        "term": "annual",
        "status": "draft"
      },
      "vessel": {
        "hull_type": "monohull_motor"
      },
      "presence": {
        "state": "in_port"
      },
      "fit": {
        "blocking_codes": [
          "loa_exceeds"
        ]
      },
      "anomalies": [
        "presence_without_allocation"
      ]
    }
  ],
  "unplaced": [
    {
      "vessel": {
        "hull_type": "monohull_motor"
      },
      "reason": "arrived_without_booking"
    }
  ]
}

400

Malformed request or validation failure

application/problem+json

object

type

required

string

Allowed values: bad_request validation_failed weak_password invalid_reset_token invalid_totp pairing_code_invalid invalid_scope invalid_webhook_url unknown_event_type unauthorized invalid_credentials totp_required forbidden csrf_failed totp_enrolment_required totp_required_by_policy not_found method_not_allowed conflict slug_taken already_member last_owner totp_already_enabled totp_not_enrolled endpoint_disabled idempotency_in_progress version_conflict unsupported_media_type idempotency_key_reused precondition_required rate_limited internal_error not_ready map_invalid map_not_empty map_not_georeferenced invalid_file file_too_large csv_invalid customer_anonymized customer_merged download_link_expired no_price promo_not_applicable price_list_invalid price_list_immutable price_list_overlap in_use resource_taken fit_blocked placement_invalid invalid_transition quote_expired hold_expired closure_active undo_unavailable release_invalid customer_required not_implemented renewal_exists proposal_closed signature_open invalid_signature otp_invalid otp_locked otp_rate_limited link_invalid template_invalid template_limits paper_scan_required insurance_required customer_email_missing shares_invalid table_incomplete table_active transfer_requirements mandate_overlap vessel_in_other_fleet vessel_not_in_fleet import_not_undoable provider_unknown code_taken charge_immutable charge_cancelled use_edit match_exceeds refund_exceeds already_reversed credit_insufficient not_deposit nothing_to_settle charge_exists no_termination_amount not_exported export_empty export_too_large charges_not_open release_not_resold cash_session_required cash_session_open cash_session_closed cash_insufficient register_in_use provider_disabled provider_refund_unsupported provider_error billing_item_missing first_run_token_invalid first_run_done lan_port_unavailable lan_no_address backup_in_progress restore_failed restore_backup_newer allocation_changed offline_not_allowed remote_unreachable remote_pin_mismatch peripheral_unavailable claim_expired app_pin_invalid invalid_period invalid_report_filter report_too_large unknown_indicator booking_unavailable booking_rules booking_busy consent_required text_outdated refund_changed price_changed cancellation_not_allowed nothing_due idempotency_mismatch storage_target_invalid storage_no_space area_exits_invalid pinned_invalid too_many_items scenario_window_invalid scenario_not_draft scenario_conflicts movement_not_pending element_invalid maintenance_conflicts task_already_done reading_charged consumption_frozen formula_invalid work_order_closed work_order_has_charges qualification_mismatch capacity_exceeded dependency_violation duration_too_long offline_time_out_of_range timer_already_running return_exceeds_issued nothing_to_bill equipment_slot_taken operator_busy equipment_out_of_service equipment_capacity_exceeded operator_not_enabled outside_lift_window ingest_unauthorized ingest_timestamp_out_of_range invalid_payload segment_overlap resource_has_sensor invalid_sensor_resource alert_stale alert_action_not_allowed profile_incomplete photo_invalid

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

errors

Array<object>

object

field

required

string

code

required

string

message

string

retry_after_seconds

integer

issues

Map validation issues (map_invalid)

Array<object>

object

code

required

ValidateMap rule (m1-plan §2.3), e.g. berth_overlap

string

severity

required

string

Allowed values: error warning

element_type

required

string

refs

required

Array<string>

field

string

params

Numbers only (cm, counts)

object

key

additional properties

integer format: int64

price_list_issues

Price list validation issues (price_list_invalid)

Array<object>

object

code

required

Pricing.Validate issue code (m2-plan §4.8), e.g. period_overlap

string

severity

required

string

Allowed values: error warning

ref

required

object

kind

required

string

Allowed values: list settings period band rule item

Id of the row, or the client key of an unsaved one

string

field

string

params

Codes and integers as strings; never personal data

object

key

additional properties

string

details

Machine-readable details: no_price {item_id, contract_type, night, unit, category, band, reason}; price_list_overlap {conflicts: [{id, code, valid_from, valid_to}]}; in_use {references}; resource_taken ConflictDetail; fit_blocked FitResult; placement_invalid {reason, allocation_id?}; invalid_transition {from, action}; closure_active {closure_id, from_date, to_date}; release_invalid {reason}; allocation_changed {current_resource_id, current_resource_code} (null when the allocation is gone); remote_pin_mismatch {expected_fingerprint, presented_fingerprint}; scenario_conflicts {conflicts: [StorageScenarioConflict]}; maintenance_conflicts {conflicts: [MaintenanceConflict]}; storage_no_space {area_id, from, to}. Ids, codes, dates and integers only.

object

key

additional properties

any

Example

{
  "type": "bad_request",
  "issues": [
    {
      "severity": "error"
    }
  ],
  "price_list_issues": [
    {
      "severity": "error",
      "ref": {
        "kind": "list"
      }
    }
  ]
}

401

Not authenticated, or invalid credentials

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

errors

Array<object>

object

field

required

string

code

required

string

message

string

retry_after_seconds

integer

issues

Map validation issues (map_invalid)

Array<object>

object

code

required

ValidateMap rule (m1-plan §2.3), e.g. berth_overlap

string

severity

required

string

Allowed values: error warning

element_type

required

string

refs

required

Array<string>

field

string

params

Numbers only (cm, counts)

object

key

additional properties

integer format: int64

price_list_issues

Price list validation issues (price_list_invalid)

Array<object>

object

code

required

Pricing.Validate issue code (m2-plan §4.8), e.g. period_overlap

string

severity

required

string

Allowed values: error warning

ref

required

object

kind

required

string

Allowed values: list settings period band rule item

Id of the row, or the client key of an unsaved one

string

field

string

params

Codes and integers as strings; never personal data

object

key

additional properties

string

details

object

key

additional properties

any

Example

{
  "type": "bad_request",
  "issues": [
    {
      "severity": "error"
    }
  ],
  "price_list_issues": [
    {
      "severity": "error",
      "ref": {
        "kind": "list"
      }
    }
  ]
}

403

Authenticated but not allowed

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

errors

Array<object>

object

field

required

string

code

required

string

message

string

retry_after_seconds

integer

issues

Map validation issues (map_invalid)

Array<object>

object

code

required

ValidateMap rule (m1-plan §2.3), e.g. berth_overlap

string

severity

required

string

Allowed values: error warning

element_type

required

string

refs

required

Array<string>

field

string

params

Numbers only (cm, counts)

object

key

additional properties

integer format: int64

price_list_issues

Price list validation issues (price_list_invalid)

Array<object>

object

code

required

Pricing.Validate issue code (m2-plan §4.8), e.g. period_overlap

string

severity

required

string

Allowed values: error warning

ref

required

object

kind

required

string

Allowed values: list settings period band rule item

Id of the row, or the client key of an unsaved one

string

field

string

params

Codes and integers as strings; never personal data

object

key

additional properties

string

details

object

key

additional properties

any

Example

{
  "type": "bad_request",
  "issues": [
    {
      "severity": "error"
    }
  ],
  "price_list_issues": [
    {
      "severity": "error",
      "ref": {
        "kind": "list"
      }
    }
  ]
}

404

Not found (or not visible to the principal)

application/problem+json

object

type

required

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

errors

Array<object>

object

field

required

string

code

required

string

message

string

retry_after_seconds

integer

issues

Map validation issues (map_invalid)

Array<object>

object

code

required

ValidateMap rule (m1-plan §2.3), e.g. berth_overlap

string

severity

required

string

Allowed values: error warning

element_type

required

string

refs

required

Array<string>

field

string

params

Numbers only (cm, counts)

object

key

additional properties

integer format: int64

price_list_issues

Price list validation issues (price_list_invalid)

Array<object>

object

code

required

Pricing.Validate issue code (m2-plan §4.8), e.g. period_overlap

string

severity

required

string

Allowed values: error warning

ref

required

object

kind

required

string

Allowed values: list settings period band rule item

Id of the row, or the client key of an unsaved one

string

field

string

params

Codes and integers as strings; never personal data

object

key

additional properties

string

details

object

key

additional properties

any

Example

{
  "type": "bad_request",
  "issues": [
    {
      "severity": "error"
    }
  ],
  "price_list_issues": [
    {
      "severity": "error",
      "ref": {
        "kind": "list"
      }
    }
  ]
}

Porto è sviluppato da Coste360 SRL. Codice sorgente disponibile con licenza BSL 1.1; il marchio Porto è escluso dalla licenza.