Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Nexus Legal Bus 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: Bus
description: 'Bus and coach passenger rights under Regulation (EU) No 181/2011 in the EU and the EEA: continuation, re-routing or reimbursement, the 50 % compensation when the carrier does not offer that choice, and assistance, for regular services of 250 km or more. Deterministic, with every legal source returned with its text and SHA-256.'
paths:
/api/v1/bus/eu/assess:
post:
tags:
- Bus
summary: Assess EU bus and coach passenger rights
description: 'Assesses a cancellation, a delay in departure, overbooking or a breakdown on a regular bus or coach service under Regulation (EU) No 181/2011, for journeys from 1 March 2021 boarding or alighting in the EU, Iceland, Liechtenstein or Norway, on services whose scheduled distance (of the whole line) is 250 km or more. Returns whether compensation is due (`entitled`, `not_entitled`, `undetermined` or `out_of_scope`) with a reason code: 50 % of the ticket price on top of the reimbursement when, after a cancellation, a delay in departure from a terminal of more than 120 minutes or overbooking, the carrier did not offer the choice between continuation and reimbursement (`choiceOffered`). Also the rights to continuation, re-routing or reimbursement, continuation after a breakdown, meals and accommodation, each with its condition; the deadlines; the defence of severe weather or natural disasters for accommodation; 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: `bus_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
- overbooking
- breakdown
description: 'What happened: `delay` (in departure), `cancellation`, `overbooking` (no seat for the passenger) or `breakdown` (the bus became inoperable during the journey).'
boardingCountry:
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 passenger's boarding point, 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.
alightingCountry:
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 passenger's alighting point, 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:
- regular
- occasional
description: '`regular` (at specified intervals along specified routes, with predetermined stops) or `occasional` (groups constituted on the initiative of the customer or the carrier): occasional services have no rights in the event of cancellation or delay.'
serviceDistanceKm:
type: number
description: Scheduled distance of the SERVICE (the whole line), not of the passenger's own journey. Under 250 km, the rights in the event of cancellation or delay do not apply.
exclusiveMinimum: 0
departureFrom:
type: string
enum:
- terminal
- bus_stop
description: 'Where the passenger was departing from: a staffed `terminal` or a `bus_stop`. The 50 % compensation and the assistance apply to departures from a terminal.'
scheduledDeparture:
type: string
description: Scheduled departure from the passenger's boarding point. Its date decides whether a national exemption could apply; journeys from 1 March 2021 are assessed, ISO 8601 with an explicit offset (`Z` or `±hh:mm`).
actualDeparture:
type: string
description: 'Delay: actual departure from the passenger''s boarding point, ISO 8601 with an explicit offset (`Z` or `±hh:mm`).'
scheduledArrival:
type: string
description: 'Scheduled arrival at the passenger''s destination: decides whether the journey lasts more than 3 hours (assistance), ISO 8601 with an explicit offset (`Z` or `±hh:mm`).'
choiceOffered:
description: The carrier offered, immediately, the choice between continuation or re-routing and reimbursement. If it did not, the passenger is owed 50 % of the ticket price on top of the reimbursement. Absent = not known.
type: boolean
ticketPrice:
type: object
properties:
amount:
type: number
minimum: 0
description: Price paid for the ticket of the journey concerned.
currency:
type: string
pattern: ^[A-Z]{3}$
description: ISO 4217 code, for example `EUR`.
required:
- amount
- currency
additionalProperties: false
description: Price paid for the ticket. The compensation is 50 % of it.
openTicket:
description: 'Open ticket with no departure time specified, other than a travel pass or season ticket: Articles 19 and 21 do not apply.'
type: boolean
required:
- disruption
- boardingCountry
- alightingCountry
- serviceType
- serviceDistanceKm
- departureFrom
- scheduledDeparture
- ticketPrice
additionalProperties: false
responses:
'200':
description: 'The assessment: `rulesVersion`, `regime`, `status`, `reason`, `delayMinutes` (in departure), `scheduledJourneyMinutes`, `compensation` (`percent` 50, `basis` with `kind` `ticket_price` and `amount`, `amount`, `currency`, `inAdditionToReimbursement`), `rights[]` (`id`, `provision`, `due` true/false/null, `condition`, `sources`), `scope` (`boarding` and `alighting` with `zone`, `service`, `serviceType`, `serviceDistanceKm`); `deadlines[]` also carry `period` and `from`; `defenses[]` also carry `covers`, `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: postApiV1BusEuAssess
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_...