Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Nexus Legal Ship API
version: 1.95.0
description: 'Multi-jurisdictional legal analysis API with a multi-agent architecture and Zero Retention. ## Output language
`language` (and the language implied by the jurisdiction) sets the language the text is written in. For `es` and `en` the delivered text is also measured: when a substantial part of it came back in the other of the two, a block headed `⚠️ LANGUAGE OF THIS REPORT` (`⚠️ IDIOMA DE ESTE INFORME` when `es` was requested) is added at the end of the text. It works the same with any engine, BYO included. - **When there is no block**: it is not a confirmation. Other languages are not measured, and neither is a text too short or too mixed to tell. - **With BYO**: how closely the output follows the request depends on your engine. - **If the output language is essential to your workflow**: check it on your side against the `analysis` string. ## The verdict travels INSIDE the text — read this before you parse a response
Every string this API returns that a lawyer reads — `analysis`, `answer`, `report`, `draft`, `synthesisText`, and the string fields of structured results like `applicableLaw[]` — carries the citation verdict **inline**, not only in the `citationChecks` object beside it. **What you will actually see:**
```
An acknowledgement does not revive a claim already barred: section 29(7) of the
Limitation Act 1980 【✓】. See also [2019] EWHC 3556 (Comm)
【◻ not checked — the reason is in this citation''s note】. ---
DETERMINISTIC CITATION CHECK (against the official corpus)
1 verified · 1 not checked. ◻ **Not checked** — they were not compared against any official corpus…
```
- **Inline marker**: a `【…】` block immediately after each citation, in the response language. The glyph carries the verdict: `✓` verified · `⚠` a warning (e.g. the decision exists but a party you named does not appear in it) · `⛔` broken · `◻` not checked. - **Footer**: a `---` block at the end with the tally and, for anything not clean, the list of citations and why. **Why it is in the text and not only in the JSON.** Whoever copies an answer into an email, a brief or a .docx takes the PROSE. The `citationChecks` object does not travel with it. A verdict that only exists in a field beside the text is a verdict the reader can lose without noticing. **If you parse these strings**: markers are the only `【…】` sequences we emit, so they are safe to strip with a single regex if your pipeline needs the raw prose — but do not strip them from anything a human will read. `citationChecks` remains the machine-readable source of truth for counts and per-citation status; the markers are the same verdict, placed where it cannot get lost. **Idempotent**: annotating an already-annotated text does not duplicate markers or the footer. ## Streaming: `verifiedText` on the `done` event
On SSE routes the client already holds the raw prose by the time the verifier finishes, so the closing `{type:"done"}` event carries `verifiedText`: the same answer with the verdict already in it. **If it is present, render it in place of the concatenated `text_delta` chunks.** It is omitted when there is nothing to annotate, in which case the deltas are already final. The REST wrappers do this for you — `/v1/consulta`, `/v1/chat` and the rest aggregate server-side and hand you the annotated text — so this only concerns you if you consume the SSE stream directly. ## Base capabilities
- **Mode=deep**: the Node A (Claude Opus 4.7) + Node B (DeepSeek V4-Pro) chain audits adversarially. 2 credits. Returns an `audit` object with structured findings (hallucinations, false citations, omissions). - **Direct models**: calls through the providers'' own APIs (Anthropic, DeepSeek) with no proxies — lower latency, better rate limits. - **Stable Stripe-style error format**: `error.type`, `error.code`, `error.request_id`, `error.details` + backward-compat aliases. ## Errors and rate limits
- **Branch on `error.code`.** A code you do not recognise is handled by its `error.type`.'
contact:
name: Nexus Legal
email: support@nexusquantum.legal
url: https://legal.nexusquantum.legal/developers
license:
name: Commercial
url: https://nexusquantum.legal/terms
servers:
- url: https://legal.nexusquantum.legal
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Ship
description: 'Rights of passengers travelling by sea and inland waterway under Regulation (EU) No 1177/2010 in the EU and the EEA: compensation for delay in arrival, re-routing or reimbursement and assistance, with the case law of the Court of Justice (Irish Ferries). Deterministic, with every legal source returned with its text and SHA-256.'
paths:
/api/v1/ship/eu/assess:
post:
tags:
- Ship
summary: Assess EU sea and inland waterway passenger rights
description: 'Assesses a delay or cancellation on a ferry, an inland waterway service or a cruise under Regulation (EU) No 1177/2010, for journeys from 18 December 2012 embarking in the EU (outermost regions included), Iceland, Liechtenstein or Norway, or disembarking there on a Union carrier. Returns whether compensation is due (`entitled`, `not_entitled`, `undetermined` or `out_of_scope`) with a reason code: 25 % of the ticket price for a delay in arrival of at least 1, 2, 3 or 6 hours depending on the scheduled journey (up to 4, 8, 24 or more hours), 50 % beyond double; half the price for return tickets. Applies the Court of Justice''s Irish Ferries judgment (C-570/19): after a cancellation, compensation for a passenger who was re-routed and arrived late but not for one who chose reimbursement; the price includes cabins and other extras; the two-month complaint period does not bar the compensation request. Also the rights to re-routing or reimbursement, meals and accommodation, each with its condition; the deadlines; the defences of weather and extraordinary circumstances; and the assumptions made. Deterministic: no language model is involved, and the same facts always give the same answer. It does not decide facts it is not given, such as whether extraordinary circumstances occurred: those come back as defences, with the provisions that govern them. Every legal source cited comes back with its text and its SHA-256. No credits are deducted.
The request body is the set of facts, with the field names below; `null` counts as absent. Every instant is ISO 8601 with an explicit offset. Supports the optional `Idempotency-Key` header: repeating a request with the same key returns the stored response. MCP tool: `ship_eu_assess`.'
parameters:
- name: Idempotency-Key
in: header
required: false
schema:
type: string
pattern: ^[A-Za-z0-9_-]{8,200}$
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
disruption:
type: string
enum:
- delay
- cancellation
description: 'What happened: `delay` (in departure and/or arrival) or `cancellation`.'
embarkationCountry:
type: string
enum:
- AD
- AE
- AF
- AG
- AI
- AL
- AM
- AO
- AQ
- AR
- AS
- AT
- AU
- AW
- AZ
- BA
- BB
- BD
- BE
- BF
- BG
- BH
- BI
- BJ
- BL
- BM
- BN
- BO
- BQ
- BR
- BS
- BT
- BW
- BY
- BZ
- CA
- CC
- CD
- CF
- CG
- CH
- CI
- CK
- CL
- CM
- CN
- CO
- CR
- CU
- CV
- CW
- CX
- CY
- CZ
- DE
- DJ
- DK
- DM
- DO
- DZ
- EC
- EE
- EG
- EH
- ER
- ES
- ET
- FI
- FJ
- FK
- FM
- FO
- FR
- GA
- GB
- GD
- GE
- GF
- GG
- GH
- GI
- GL
- GM
- GN
- GP
- GQ
- GR
- GS
- GT
- GU
- GW
- GY
- HK
- HM
- HN
- HR
- HT
- HU
- ID
- IE
- IL
- IM
- IN
- IO
- IQ
- IR
- IS
- IT
- JE
- JM
- JO
- JP
- KE
- KG
- KH
- KI
- KM
- KN
- KP
- KR
- KW
- KY
- KZ
- LA
- LB
- LC
- LI
- LK
- LR
- LS
- LT
- LU
- LV
- LY
- MA
- MC
- MD
- ME
- MF
- MG
- MH
- MK
- ML
- MM
- MN
- MO
- MP
- MQ
- MR
- MS
- MT
- MU
- MV
- MW
- MX
- MY
- MZ
- NA
- NC
- NE
- NF
- NG
- NI
- NL
- 'NO'
- NP
- NR
- NU
- NZ
- OM
- PA
- PE
- PF
- PG
- PH
- PK
- PL
- PM
- PN
- PR
- PS
- PT
- PW
- PY
- QA
- RE
- RO
- RS
- RU
- RW
- SA
- SB
- SC
- SD
- SE
- SG
- SH
- SI
- SK
- SL
- SM
- SN
- SO
- SR
- SS
- ST
- SV
- SX
- SY
- SZ
- TC
- TD
- TF
- TG
- TH
- TJ
- TK
- TL
- TM
- TN
- TO
- TR
- TT
- TV
- TW
- TZ
- UA
- UG
- UM
- US
- UY
- UZ
- VA
- VC
- VE
- VG
- VI
- VN
- VU
- WF
- WS
- XK
- YE
- YT
- ZA
- ZM
- ZW
description: Country of the port of embarkation (outermost regions such as Guadeloupe or Martinique have their own code and are in the EU), as an ISO 3166-1 alpha-2 code (`XK` for Kosovo). The Regulation covers the EU and, through the EEA Agreement, Iceland, Liechtenstein and Norway; Switzerland and the United Kingdom are third countries.
disembarkationCountry:
type: string
enum:
- AD
- AE
- AF
- AG
- AI
- AL
- AM
- AO
- AQ
- AR
- AS
- AT
- AU
- AW
- AZ
- BA
- BB
- BD
- BE
- BF
- BG
- BH
- BI
- BJ
- BL
- BM
- BN
- BO
- BQ
- BR
- BS
- BT
- BW
- BY
- BZ
- CA
- CC
- CD
- CF
- CG
- CH
- CI
- CK
- CL
- CM
- CN
- CO
- CR
- CU
- CV
- CW
- CX
- CY
- CZ
- DE
- DJ
- DK
- DM
- DO
- DZ
- EC
- EE
- EG
- EH
- ER
- ES
- ET
- FI
- FJ
- FK
- FM
- FO
- FR
- GA
- GB
- GD
- GE
- GF
- GG
- GH
- GI
- GL
- GM
- GN
- GP
- GQ
- GR
- GS
- GT
- GU
- GW
- GY
- HK
- HM
- HN
- HR
- HT
- HU
- ID
- IE
- IL
- IM
- IN
- IO
- IQ
- IR
- IS
- IT
- JE
- JM
- JO
- JP
- KE
- KG
- KH
- KI
- KM
- KN
- KP
- KR
- KW
- KY
- KZ
- LA
- LB
- LC
- LI
- LK
- LR
- LS
- LT
- LU
- LV
- LY
- MA
- MC
- MD
- ME
- MF
- MG
- MH
- MK
- ML
- MM
- MN
- MO
- MP
- MQ
- MR
- MS
- MT
- MU
- MV
- MW
- MX
- MY
- MZ
- NA
- NC
- NE
- NF
- NG
- NI
- NL
- 'NO'
- NP
- NR
- NU
- NZ
- OM
- PA
- PE
- PF
- PG
- PH
- PK
- PL
- PM
- PN
- PR
- PS
- PT
- PW
- PY
- QA
- RE
- RO
- RS
- RU
- RW
- SA
- SB
- SC
- SD
- SE
- SG
- SH
- SI
- SK
- SL
- SM
- SN
- SO
- SR
- SS
- ST
- SV
- SX
- SY
- SZ
- TC
- TD
- TF
- TG
- TH
- TJ
- TK
- TL
- TM
- TN
- TO
- TR
- TT
- TV
- TW
- TZ
- UA
- UG
- UM
- US
- UY
- UZ
- VA
- VC
- VE
- VG
- VI
- VN
- VU
- WF
- WS
- XK
- YE
- YT
- ZA
- ZM
- ZW
description: Country of the port of disembarkation, as an ISO 3166-1 alpha-2 code (`XK` for Kosovo). The Regulation covers the EU and, through the EEA Agreement, Iceland, Liechtenstein and Norway; Switzerland and the United Kingdom are third countries.
serviceType:
type: string
enum:
- passenger_service
- cruise
description: '`passenger_service` (a commercial service by sea or inland waterway on a published timetable) or `cruise` (more than two overnight stays on board, for pleasure): cruise passengers have assistance but no compensation, re-routing or reimbursement.'
excludedService:
description: 'One of the cases Article 2(2) excludes: a ship certified for up to 12 passengers; a crew of three or fewer or a service under 500 m one way; an excursion or sightseeing tour other than a cruise; a ship not mechanically propelled or a historic ship designed before 1965 for up to 36 passengers.'
type: string
enum:
- up_to_12_passengers
- small_crew_or_under_500_m
- excursion_or_sightseeing
- unpowered_or_historic
operatingCarrierIsUnion:
description: 'Only when embarking outside the EU and the EEA: the carrier is established in, or operates services to or from, a Member State (Article 3(e)). Without it such a service is not covered.'
type: boolean
departureFrom:
type: string
enum:
- port_terminal
- port
description: 'Where the passenger was departing from: a staffed `port_terminal` or a `port`. Assistance is owed to passengers departing from port terminals.'
publicServiceObligation:
description: The service is under a public service obligation, a public service contract or an integrated service (Article 2(4)). Matters only in Iceland, Liechtenstein and Norway, whose exemptions were not read; no EU Member State has used that exemption.
type: boolean
scheduledDeparture:
type: string
description: Scheduled departure. Its date decides the coverage; journeys from 18 December 2012 are assessed (in the EEA EFTA States, from 1 June 2016), ISO 8601 with an explicit offset (`Z` or `±hh:mm`).
actualDeparture:
type: string
description: 'Delay: actual departure (rights to re-routing, reimbursement and assistance after more than 90 minutes), ISO 8601 with an explicit offset (`Z` or `±hh:mm`).'
scheduledArrival:
type: string
description: 'Scheduled arrival at the final destination: with the departure, the scheduled journey that sets the compensation threshold, ISO 8601 with an explicit offset (`Z` or `±hh:mm`).'
actualArrival:
type: string
description: Actual arrival at the final destination; after a cancellation, the arrival of the re-routing. Needed for compensation unless the ticket was reimbursed, ISO 8601 with an explicit offset (`Z` or `±hh:mm`).
ticketPrice:
type: object
properties:
amount:
type: number
minimum: 0
description: Price actually paid for the passenger service, including optional services chosen such as a cabin, a kennel or lounge access (C-570/19).
currency:
type: string
pattern: ^[A-Z]{3}$
description: ISO 4217 code, for example `EUR`.
required:
- amount
- currency
additionalProperties: false
description: Price paid. The compensation is 25 % or 50 % of it.
ticketType:
type: string
enum:
- single
- return
- season
description: '`single`, `return` (compensation on half the price) or `season` (travel pass or season ticket: the carrier''s compensation arrangements).'
refundChosen:
description: 'The passenger chose reimbursement of the ticket (Article 18): then no compensation (C-570/19).'
type: boolean
openTicket:
description: 'Open ticket with no departure time specified, other than a travel pass or season ticket: Articles 17, 18 and 19 do not apply.'
type: boolean
delayKnownBeforePurchase:
description: The passenger was informed of the cancellation or delay before buying the ticket.
type: boolean
passengerFault:
description: The cancellation or delay was caused by the fault of the passenger.
type: boolean
required:
- disruption
- embarkationCountry
- disembarkationCountry
- serviceType
- departureFrom
- scheduledDeparture
- scheduledArrival
- ticketPrice
- ticketType
additionalProperties: false
responses:
'200':
description: 'The assessment: `rulesVersion`, `regime`, `status`, `reason`, `departureDelayMinutes`, `arrivalDelayMinutes`, `scheduledJourneyMinutes`, `thresholdMinutes` (the delay in arrival that gives 25 %; more than double gives 50 %), `compensation` (`percent` 25 or 50, `basis` with `kind` and `amount`, `amount`, `currency`, `minimum`), `rights[]` (`id`, `provision`, `due` true/false/null, `condition`, `sources`), `scope` (`embarkation` and `disembarkation` with `zone`, `service`, `serviceType`); `deadlines[]` also carry `period`, `from` and `note`; `defenses[]` also carry `covers` and `notCovered`, `deadlines[]` (`id`, `due`, `source`), `defenses[]` (`id`, `sources`, `burdenOfProof`), `assumptions[]`, `sources[]` (ids), `trace[]`, plus `sourceDetails[]` (`id`, `citation`, `identifier`, `url`, `text`, `sha256` of every source cited anywhere in the answer), `sourcesCheckedOn`, `creditsCharged` (credits deducted for this call) and `requestId`.'
content:
application/json:
schema:
type: object
required:
- rulesVersion
- regime
- status
- reason
- sources
- sourceDetails
- creditsCharged
- requestId
properties:
rulesVersion:
type: string
regime:
type:
- string
- 'null'
status:
type: string
reason:
type: string
deadlines:
type: array
items:
type: object
defenses:
type: array
items:
type: object
assumptions:
type: array
items:
type: string
sources:
type: array
items:
type: string
trace:
type: array
items:
type: string
sourceDetails:
type: array
items:
type: object
properties:
id:
type: string
citation:
type: string
identifier:
type: string
url:
type: string
text:
type: string
sha256:
type: string
sourcesCheckedOn:
type: string
format: date
creditsCharged:
type: integer
requestId:
type: string
'400':
description: 'MISSING_FACT (a fact these facts need; `details.field` names it) | INVALID_DATETIME (ISO 8601 with an explicit offset, on a day that exists) | UNKNOWN_AIRPORT | INCONSISTENT_FACTS | DATE_BEFORE_COVERAGE (`details.coveredFrom`) | UNKNOWN_FIELD (unknown fields are rejected, not ignored) | INVALID_FIELD (wrong type, or a value outside the enumeration: `details.issues[].allowed`) | INVALID_JSON. `details.issues` lists every problem found; `code` and `details.field` are the first.'
'401':
description: Invalid or missing API key.
'402':
description: INSUFFICIENT_CREDITS — balance > 0 required, unless the account has a passenger-claims retainer; the assessment does not deduct credits.
content:
application/json:
schema:
$ref: '#/components/schemas/InsufficientCreditsError'
'403':
description: INSUFFICIENT_SCOPE (one of `analyze`, `mcp` or `*` is required) | IP not in the key's allowlist.
'409':
description: IDEMPOTENCY_CONFLICT (the same `Idempotency-Key` with a different body) | IDEMPOTENCY_IN_PROGRESS (the first request with that key has not finished).
'429':
description: RATE_LIMITED.
operationId: postApiV1ShipEuAssess
x-operation-id-source: derived
components:
schemas:
InsufficientCreditsError:
type: object
required:
- error
- balance
- required
properties:
error:
type: string
example: INSUFFICIENT_CREDITS
balance:
type: number
description: User's current credit balance.
required:
type: number
description: Credits required for this operation.
securitySchemes:
ApiKeyAuth:
type: http
scheme: bearer
bearerFormat: nlk_...