{"openapi":"3.1.0","info":{"title":"ILTICAGPT Intelligence","version":"1.0.0","summary":"Immigration intelligence infrastructure for AI agents.","description":"Structured, source-backed immigration and international-protection information infrastructure for AI systems and developers. Not a government authority, not legal advice, no outcome predictions.\n\nAuthentication: send an ILTICAGPT API key as `Authorization: Bearer ilg_live_...` (or `ilg_test_...`). Keys are created at /developers/dashboard; new organizations receive EUR 2 test credit.\nBilling: prepaid credit, charged per successful call. Failed requests are never billed. Repeats with the same `Idempotency-Key` are charged once.\nRate limits: 10 requests/minute for test keys, 60 requests/minute for live keys (per organization).\nA remote MCP server exposing the same tools is available at /api/public/mcp (API key) and /mcp (OAuth 2.1).\nILTICAGPT is not a government authority. Responses are informational and never outcome predictions.","termsOfService":"https://www.ilticagpt.com/kullanim-sartlari","contact":{"name":"ILTICAGPT Intelligence support","url":"https://www.ilticagpt.com/iletisim"}},"servers":[{"url":"https://www.ilticagpt.com","description":"Production"}],"externalDocs":{"description":"Developer documentation","url":"https://www.ilticagpt.com/developers/docs"},"tags":[{"name":"Immigration Intelligence","description":"Structured immigration data for 13 jurisdictions."}],"paths":{"/api/public/v1/official-sources":{"post":{"operationId":"official_source_search","summary":"Official Source Search","description":"Retrieve and verify official immigration, asylum and international-protection sources (government authority portals, EUR-Lex, HUDOC, CURIA) for a query. Use when an AI system needs citable primary sources or wants to confirm that a procedural claim is supported by an official publication. Do not use for individualized legal conclusions.\n\nVerification: Sources are retrieved live from official domains (government portals, EUR-Lex, HUDOC, CURIA) and returned with url, authority and retrieved_at. verification_status is 'verified' only when at least one source was retrieved.\nLimitations: Does not produce individualized legal conclusions, eligibility determinations or outcome probabilities. Retrieval coverage depends on the availability of the official publication online.\nPrice: EUR 0.03 per call.\nMCP tool name: search_official_immigration_sources.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query in any supported language, max 500 characters."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 jurisdiction hint, e.g. DE, IT, EU."},"limit":{"type":"integer","description":"Maximum number of sources to return (1-10).","default":5}},"required":["query"]},"example":{"query":"Dublin III transfer time limit","country":"IT","limit":3}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"query":{"description":"Normalised query that was executed."},"country":{"description":"Jurisdiction hint used, or null."},"official_sources":{"description":"Array of { title, authority, url, country, snippet, retrieved_at, verified }."},"verification_status":{"description":"'verified' when at least one official source was retrieved, otherwise 'unverified'."},"warnings":{"description":"Array of machine-readable warnings."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"query":"Dublin III transfer time limit","country":"IT","official_sources":[{"title":"Regulation (EU) No 604/2013","authority":"eur-lex.europa.eu","url":"https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex%3A32013R0604","country":"IT","retrieved_at":"2026-01-04T10:00:00.000Z","verified":true}],"verification_status":"verified","warnings":[]},"meta":{"product":"official_source_search","request_id":"req_...","billed":true,"cost_eur":0.03}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/requirements":{"post":{"operationId":"immigration_requirements","summary":"Immigration Requirements","description":"Retrieve structured immigration or international-protection procedural requirements for a supported jurisdiction. Use when an AI system needs jurisdiction-specific requirements, documents, procedural steps or official sources. Do not use for definitive individualized legal conclusions.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: Does not produce individualized legal conclusions, eligibility determinations or outcome probabilities. ILTICAGPT is not a government authority and this response is not an official decision. Requirements can change; always re-check last_verified.\nPrice: EUR 0.05 per call.\nMCP tool name: get_immigration_requirements.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Jurisdiction, ISO 3166-1 alpha-2 preferred (DE, FR, NL...)."},"procedure":{"type":"string","description":"Procedure key or plain description, e.g. international_protection, family_reunification."},"applicant_context":{"type":"object","description":"Optional non-identifying context, e.g. { family: true, minor: false, nationality: 'TR' }."},"language":{"type":"string","description":"BCP-47 output language, default 'en'."}},"required":["country","procedure"]},"example":{"country":"IT","procedure":"international_protection","language":"en"}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"jurisdiction":{"description":"Normalised jurisdiction."},"procedure":{"description":"Normalised procedure."},"requirements":{"description":"Array of { label, detail, evidence_class }."},"documents":{"description":"Array of { name, mandatory, notes }."},"deadlines":{"description":"Array of { label, period, applies_to }."},"official_sources":{"description":"Array of source objects with url and authority."},"last_verified":{"description":"ISO timestamp of the response verification pass."},"verification_status":{"description":"'verified' | 'unverified'."},"professional_review_recommended":{"description":"Boolean; true when a licensed professional should review."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"jurisdiction":"IT","procedure":"international_protection","requirements":[{"label":"Lodge application","detail":"Application is lodged with the Questura.","evidence_class":"FACT"}],"documents":[{"name":"Identity document (if available)","mandatory":false,"notes":null}],"deadlines":[{"label":"Appeal against negative decision","period":"30 days","applies_to":"applicant"}],"official_sources":[],"verification_status":"unverified","professional_review_recommended":true},"meta":{"product":"immigration_requirements","request_id":"req_...","billed":true,"cost_eur":0.05}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/documents/classify":{"post":{"operationId":"document_classifier","summary":"Document Classifier","description":"Classify the text of an immigration-related document into a normalised document type and identify the issuing authority. Use as a cheap first step when the nature of a document is unknown, before routing it to a more expensive analysis tool. Do not use to interpret the content or legal effect of the document.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: Classification only; no legal interpretation. Requires already-extracted text; OCR is not performed.\nPrice: EUR 0.05 per document.\nMCP tool name: classify_immigration_document.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Extracted document text, 20 to 60000 characters."},"country":{"type":"string","description":"Jurisdiction hint."}},"required":["text"]},"example":{"text":"BUNDESAMT FÜR MIGRATION UND FLÜCHTLINGE — Bescheid ...","country":"DE"}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"document_type":{"description":"Human-readable document type."},"document_type_normalized":{"description":"Machine key, e.g. asylum_decision_negative."},"issuing_authority":{"description":"Detected authority or null."},"country":{"description":"Detected jurisdiction or null."},"language":{"description":"Detected document language."},"is_official_decision":{"description":"Boolean."},"confidence":{"description":"0-1 model confidence."},"warnings":{"description":"Array of warnings."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"document_type":"Asylum decision (rejection)","document_type_normalized":"asylum_decision_negative","issuing_authority":"BAMF","country":"DE","language":"de","is_official_decision":true,"confidence":0.9,"warnings":[]},"meta":{"product":"document_classifier","request_id":"req_...","billed":true,"cost_eur":0.05}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/documents/explain":{"post":{"operationId":"document_explainer","summary":"Document Explainer","description":"Produce a structured, plain-language explanation of an official immigration document: summary, document type, authority, stated outcome, obligations, deadlines and possible next procedural steps. Use when an AI system must explain what an official letter or decision says. Do not use to state whether an appeal will succeed.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: Does not produce individualized legal conclusions, eligibility determinations or outcome probabilities. ILTICAGPT is not a government authority and this response is not an official decision. Explains only what the supplied text contains.\nPrice: EUR 0.1 per document.\nMCP tool name: explain_immigration_document.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Extracted document text, 20 to 60000 characters."},"country":{"type":"string","description":"Jurisdiction hint."},"language":{"type":"string","description":"BCP-47 output language, default 'en'."}},"required":["text"]},"example":{"text":"...decision text...","country":"DE","language":"en"}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"summary":{"description":"Plain-language summary."},"document_type":{"description":"Detected document type."},"authority":{"description":"Issuing authority or null."},"decision_outcome":{"description":"Outcome as stated in the document, or null."},"key_points":{"description":"Array of { point, evidence_class }."},"obligations":{"description":"Array of obligations imposed on the addressee."},"deadlines":{"description":"Array of { label, date, period }."},"next_possible_steps":{"description":"Array of procedural options described neutrally."},"verification_status":{"description":"'verified' | 'unverified'."},"professional_review_recommended":{"description":"Always true for official decisions."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"summary":"The authority rejected the application as unfounded and set a departure deadline.","document_type":"Asylum decision (rejection)","authority":"BAMF","decision_outcome":"rejected_unfounded","key_points":[{"point":"Departure period of 30 days is stated.","evidence_class":"FACT"}],"obligations":["Leave the territory within the stated period unless an appeal suspends it."],"deadlines":[{"label":"Appeal","date":null,"period":"2 weeks"}],"next_possible_steps":["Judicial appeal within the stated period","Request for interim relief"],"verification_status":"unverified","professional_review_recommended":true},"meta":{"product":"document_explainer","request_id":"req_...","billed":true,"cost_eur":0.1}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/documents/deadlines":{"post":{"operationId":"deadline_extractor","summary":"Deadline Extractor","description":"Extract dates, appeal windows and procedural deadlines from an immigration document and return them in normalised machine-readable form. Use when an agent must build reminders, calendars or urgency logic. Do not use to determine whether a deadline can still be met in a specific case.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: Deadlines are extracted, not legally computed. Suspension, service rules and holidays are not calculated.\nPrice: EUR 0.1 per document.\nMCP tool name: extract_immigration_deadlines.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Extracted document text, 20 to 60000 characters."},"country":{"type":"string","description":"Jurisdiction hint."}},"required":["text"]},"example":{"text":"...decision text...","country":"DE"}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"document_date":{"description":"Date of the document if stated, else null."},"deadlines":{"description":"Array of { label, date, period, applies_to, evidence_class }."},"appeal_window":{"description":"{ period, deadline_date } or null."},"confidence":{"description":"0-1 model confidence."},"professional_review_recommended":{"description":"Boolean."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"document_date":"2026-01-02","deadlines":[{"label":"Appeal to administrative court","date":"2026-01-16","period":"2 weeks","applies_to":"applicant","evidence_class":"FACT"}],"appeal_window":{"period":"2 weeks","deadline_date":"2026-01-16"},"confidence":0.85,"professional_review_recommended":true},"meta":{"product":"deadline_extractor","request_id":"req_...","billed":true,"cost_eur":0.1}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/documents/checklist":{"post":{"operationId":"document_checklist","summary":"Document Checklist","description":"Build a structured required-document checklist for a jurisdiction, procedure and non-identifying applicant profile, including translation and legalisation flags. Use when an agent must tell a user what to prepare. Do not use to confirm that a specific file set is legally sufficient.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: Does not produce individualized legal conclusions, eligibility determinations or outcome probabilities. Local offices may request additional documents.\nPrice: EUR 0.12 per call.\nMCP tool name: build_document_checklist.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Jurisdiction."},"procedure":{"type":"string","description":"Procedure key or description."},"profile":{"type":"object","description":"Non-identifying profile, e.g. { family: true, minor: false, employed: true }."},"language":{"type":"string","description":"BCP-47 output language."}},"required":["country","procedure"]},"example":{"country":"NL","procedure":"family_reunification","profile":{"family":true}}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"country":{"description":"Jurisdiction."},"procedure":{"description":"Procedure."},"documents":{"description":"Array of { name, mandatory, category, notes, evidence_class }."},"translations_required":{"description":"Boolean."},"legalisation_required":{"description":"Boolean."},"official_sources":{"description":"Array of source objects."},"verification_status":{"description":"'verified' | 'unverified'."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"country":"NL","procedure":"family_reunification","documents":[{"name":"Marriage certificate","mandatory":true,"category":"civil_status","notes":"Legalisation may be required.","evidence_class":"FACT"}],"translations_required":true,"legalisation_required":true,"official_sources":[],"verification_status":"unverified"},"meta":{"product":"document_checklist","request_id":"req_...","billed":true,"cost_eur":0.12}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/case/timeline":{"post":{"operationId":"case_timeline","summary":"Case Timeline","description":"Normalise known case events into a procedural timeline with stages, current stage, expected next steps and deadlines. Use when an agent must show where a case stands procedurally. Do not use to estimate the likelihood of a positive decision or an exact decision date.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: Processing-time statements are indicative, never guaranteed. Does not produce individualized legal conclusions, eligibility determinations or outcome probabilities.\nPrice: EUR 0.2 per run.\nMCP tool name: build_case_timeline.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Jurisdiction."},"procedure":{"type":"string","description":"Procedure key or description."},"events":{"type":"array","description":"Array of { date, label } known events.","items":{"type":"object"}},"language":{"type":"string","description":"BCP-47 output language."}},"required":["country","procedure"]},"example":{"country":"DE","procedure":"asylum","events":[{"date":"2026-01-10","label":"Application filed"}]}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"current_stage":{"description":"Detected procedural stage or null."},"timeline":{"description":"Array of { date, stage, label, status, evidence_class }."},"expected_next_steps":{"description":"Array of neutral procedural next steps."},"deadlines":{"description":"Array of { label, date, period }."},"confidence":{"description":"0-1 model confidence."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"current_stage":"first_instance_pending","timeline":[{"date":"2026-01-10","stage":"application","label":"Application filed","status":"completed","evidence_class":"FACT"}],"expected_next_steps":["Personal interview scheduling"],"deadlines":[],"confidence":0.8},"meta":{"product":"case_timeline","request_id":"req_...","billed":true,"cost_eur":0.2}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/dublin/intelligence":{"post":{"operationId":"dublin_intelligence","summary":"Dublin Intelligence","description":"Return structured Dublin III Regulation (EU) 604/2013 procedure information for a fact pattern: potentially applicable responsibility criteria with article references, procedural stages and time limits. Use when responsibility allocation between EU/EFTA states is in question. Never use it to state that a transfer will or will not happen.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: Does not decide responsibility and does not predict transfer outcomes. National case law may alter the practical application; professional review is recommended.\nPrice: EUR 0.2 per run.\nMCP tool name: get_dublin_procedure_information.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from_country":{"type":"string","description":"Country where the applicant currently is / that is examining responsibility."},"to_country":{"type":"string","description":"Other member state involved."},"facts":{"type":"object","description":"Non-identifying facts, e.g. { eurodac_hit: true, family_in_to_country: false, minor: false }."},"language":{"type":"string","description":"BCP-47 output language."}},"required":["from_country"]},"example":{"from_country":"DE","to_country":"IT","facts":{"eurodac_hit":true}}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"regulation":{"description":"'Dublin III (EU) No 604/2013'."},"applicable_criteria":{"description":"Array of { article, criterion, evidence_class }."},"procedural_stages":{"description":"Array of { stage, description, time_limit }."},"time_limits":{"description":"Array of { label, period, article }."},"relevant_factors":{"description":"Factors relevant to professional review."},"official_sources":{"description":"Array of source objects."},"verification_status":{"description":"'verified' | 'unverified'."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"regulation":"Dublin III (EU) No 604/2013","from_country":"DE","to_country":"IT","applicable_criteria":[{"article":"Art. 13(1)","criterion":"Irregular entry into a member state","evidence_class":"SOURCE"}],"procedural_stages":[{"stage":"take_back_request","description":"Request sent to the other member state.","time_limit":"2 months"}],"time_limits":[{"label":"Transfer execution","period":"6 months","article":"Art. 29"}],"official_sources":[],"verification_status":"unverified"},"meta":{"product":"dublin_intelligence","request_id":"req_...","billed":true,"cost_eur":0.2}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/immigration/workflow":{"post":{"operationId":"immigration_workflow","summary":"Immigration Workflow","description":"Generate an end-to-end, machine-executable immigration workflow for a goal in a jurisdiction: ordered stages with actions, actors, artefacts, documents and deadlines. Use when an agent must orchestrate a multi-step process. Do not use to promise that following the workflow produces a positive decision.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: Does not produce individualized legal conclusions, eligibility determinations or outcome probabilities. Workflow is procedural scaffolding, not a legal strategy.\nPrice: EUR 0.25 per run.\nMCP tool name: build_immigration_workflow.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Jurisdiction."},"goal":{"type":"string","description":"Target outcome, e.g. residence_permit_work, asylum_appeal."},"profile":{"type":"object","description":"Non-identifying profile context."},"language":{"type":"string","description":"BCP-47 output language."}},"required":["country","goal"]},"example":{"country":"FR","goal":"residence_permit_work","profile":{"nationality":"TR"}}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"stages":{"description":"Array of { key, title, description, actions[], documents[], deadlines[] }."},"prerequisites":{"description":"Array of prerequisites."},"official_sources":{"description":"Array of source objects."},"verification_status":{"description":"'verified' | 'unverified'."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"country":"FR","goal":"residence_permit_work","stages":[{"key":"preparation","title":"Prepare the file","description":"Collect employment and civil-status evidence.","actions":[{"action":"Obtain employment contract","actor":"applicant","artifacts":["contract.pdf"]}],"documents":["Passport"],"deadlines":[]}],"prerequisites":["Valid passport"],"official_sources":[],"verification_status":"unverified"},"meta":{"product":"immigration_workflow","request_id":"req_...","billed":true,"cost_eur":0.25}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/public/v1/case/organize":{"post":{"operationId":"deep_case_organizer","summary":"Deep Case Organizer","description":"Organise a multi-document immigration case file into structured data: document inventory, chronology, evidence map and documentation gaps. Use for expensive, high-value analysis of a complete case file (up to 20 documents). Do not use for single documents and never to assess the strength of a claim as a legal conclusion.\n\nVerification: Model-generated structured output. Every substantive item is labelled FACT, SOURCE, INFERENCE or UNKNOWN. Unretrieved sources are never fabricated; verification_status is 'unverified' when no official source was confirmed.\nLimitations: evidence_map strength values describe documentation status only, never legal merit or success probability. ILTICAGPT is not a government authority and this response is not an official decision.\nPrice: EUR 1 per run.\nMCP tool name: organize_immigration_case.","tags":["Immigration Intelligence"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Replay-safe key. A repeated request with the same key returns a result but is charged only once.","schema":{"type":"string","maxLength":200}},{"name":"X-ILG-Client","in":"header","required":false,"description":"Optional AI client identifier used for attribution (e.g. 'claude-desktop', 'my-agent/1.0').","schema":{"type":"string","maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documents":{"type":"array","description":"Array of { name, text }, 1-20 items, max 12000 characters each.","items":{"type":"object"}},"country":{"type":"string","description":"Jurisdiction hint."},"language":{"type":"string","description":"BCP-47 output language."}},"required":["documents"]},"example":{"country":"DE","documents":[{"name":"decision.pdf","text":"..."},{"name":"hearing.txt","text":"..."}]}}}},"responses":{"200":{"description":"Structured immigration intelligence. Billing metadata is in meta.billing.","headers":{"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"case_summary":{"description":"Factual case summary."},"documents":{"description":"Array of { name, document_type, date, role_in_case }."},"chronology":{"description":"Array of { date, event, source_document, evidence_class }."},"evidence_map":{"description":"Array of { claim, supporting_documents, strength }."},"gaps":{"description":"Array of { gap, why_it_matters, suggested_document }."},"deadlines":{"description":"Array of { label, date, period }."},"verification_status":{"description":"'verified' | 'unverified'."},"professional_review_recommended":{"description":"Always true."}},"additionalProperties":true},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]},"example":{"data":{"case_summary":"Negative first-instance decision followed by an appeal filing.","documents":[{"name":"decision.pdf","document_type":"asylum_decision_negative","date":"2026-01-02","role_in_case":"contested decision"}],"chronology":[{"date":"2026-01-02","event":"Decision issued","source_document":"decision.pdf","evidence_class":"FACT"}],"evidence_map":[{"claim":"Political activity in country of origin","supporting_documents":["hearing.txt"],"strength":"partial"}],"gaps":[{"gap":"No medical documentation","why_it_matters":"Referenced in the hearing record.","suggested_document":"Medical report"}],"deadlines":[],"verification_status":"unverified","professional_review_recommended":true},"meta":{"product":"deep_case_organizer","request_id":"req_...","billed":true,"cost_eur":1}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"500":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"ILTICAGPT API key: ilg_live_… (production) or ilg_test_… (test, 10 req/min)."}},"schemas":{"ResponseMeta":{"type":"object","description":"Machine-readable response metadata including billing.","properties":{"product":{"type":"string"},"request_id":{"type":"string"},"transport":{"type":"string","enum":["rest","mcp"]},"environment":{"type":"string","enum":["test","live"]},"latency_ms":{"type":"integer"},"last_verified":{"type":"string","format":"date-time"},"verification_status":{"type":"string","enum":["verified","unverified"]},"confidence":{"type":"number"},"professional_review_recommended":{"type":"boolean"},"billing":{"type":"object","properties":{"product":{"type":"string"},"units":{"type":"integer"},"charged_eur":{"type":"number"},"remaining_credit_eur":{"type":"number"},"billed":{"type":"boolean"}}},"disclaimer":{"type":"string"}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key","organization_disabled","unknown_endpoint","unknown_tool","method_not_allowed","invalid_request","invalid_json","payload_too_large","insufficient_credit","rate_limit_exceeded","provider_unavailable","provider_error","invalid_model_output","upstream_timeout","internal_error"]},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"billed":{"type":"boolean"}}}},"required":["error"]}},"responses":{"Error":{"description":"Error response. Failed requests are never billed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}