{"openapi":"3.1.0","info":{"title":"Lex API MX","description":"API mexicana de consulta normativa estructurada","version":"0.3.1"},"paths":{"/api/v1/normas":{"get":{"tags":["normas"],"summary":"List Normas","operationId":"list_normas","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"materia","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Materia"}},{"name":"jurisdiccion","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiccion"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/normas/{slug}":{"get":{"tags":["normas"],"summary":"Get Norma","operationId":"get_norma","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/normas/{slug}/estructura":{"get":{"tags":["normas"],"summary":"Get Estructura","description":"Árbol de la norma en `fecha` (hoy si se omite): los nodos con una versión oficial\nque rige en esa fecha. `include_text=true` agrega el texto de una página de nodos en\nel orden del documento (`page`, `page_size`; el árbol llega completo y `text_page`\ndice si hay más), cada uno con su vigencia, su fuente y el SHA-256 de su texto\n(`checksum`), y requiere un plan de la API (`403 paid_plan_required` en el plan\ngratuito). Los nodos con texto tienen un tope diario por cuenta\n(`text_nodes_per_day` en `GET /account`; `429 text_quota_exceeded` al rebasarlo). Una\n`fecha` anterior al baseline de la norma responde `404 outside_coverage`; una futura\n(más allá de mañana), `404 future_not_available`.","operationId":"get_estructura","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"fecha","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha"}},{"name":"include_text","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Text"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/articulos/search":{"get":{"tags":["articulos"],"summary":"Search Articulos","description":"Búsqueda full-text de artículos con el texto que rige en `fecha` (hoy si se omite).\n\n`text` es el artículo completo, con sus fracciones e incisos; `checksum` es su SHA-256\ny `components` lista el nodo y la versión de cada parte. `meta.coverage` declara la\ncobertura de las normas buscadas en esa fecha: `covered`, `partial` (las de\n`norms_outside_coverage` aún no tenían cobertura) u `outside_coverage` (`data` vacío,\n`coverage_start_date`, sin cobro) o `future_not_available` (`fecha` más allá de mañana:\nno se pronostican reformas; `data` vacío, sin cobro). Cada artículo trae\n`canonical_citation` y `citation_status` (`canonical`, `derived` o `ambiguous_legacy`).","operationId":"search_articulos","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"materia","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Materia"}},{"name":"jurisdiccion","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiccion"}},{"name":"norma","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Norma"}},{"name":"fecha","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/articulos/{id}":{"get":{"tags":["articulos"],"summary":"Get Articulo","description":"Un artículo completo (fracciones e incisos incluidos) con el texto que rige en `fecha`\n(hoy si se omite), su fuente, el SHA-256 del texto, su vigencia, `components` con la\nversión de cada parte y su cita (`canonical_citation`, `citation_status`). Una `fecha`\nanterior al baseline de su norma responde `404 outside_coverage`; una futura (más allá\nde mañana), `404 future_not_available`.","operationId":"get_articulo","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"name":"fecha","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/articulos/{id}/historial":{"get":{"tags":["articulos"],"summary":"Get Historial","operationId":"get_historial","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/map":{"post":{"tags":["mapa-normativo"],"summary":"Normative Map","operationId":"normative_map","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/resolve":{"post":{"tags":["resolucion-normativa"],"summary":"Resolve Package","operationId":"resolve_package","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/billing/plans":{"get":{"tags":["billing"],"summary":"List Commercial Plans","operationId":"list_commercial_plans","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"include_drafts","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Drafts"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/billing/summary":{"get":{"tags":["billing"],"summary":"Get Billing Summary","operationId":"get_billing_summary","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/billing/ledger":{"get":{"tags":["billing"],"summary":"List Credit Ledger","operationId":"list_credit_ledger","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":366,"minimum":1,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account":{"get":{"tags":["account"],"summary":"Get Account","operationId":"get_account","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/keys":{"get":{"tags":["account"],"summary":"List Keys","operationId":"list_keys","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["account"],"summary":"Create Key","operationId":"create_key","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/keys/{key_id}":{"delete":{"tags":["account"],"summary":"Revoke Key","operationId":"revoke_key","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/ledger":{"get":{"tags":["account"],"summary":"List Ledger","operationId":"list_ledger","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":366,"minimum":1,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/billing-profile":{"put":{"tags":["account"],"summary":"Update Billing Profile","operationId":"update_billing_profile","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingProfileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/payments":{"get":{"tags":["account"],"summary":"List Payments","operationId":"list_payments","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/payments/{payment_id}/cfdi":{"post":{"tags":["account"],"summary":"Request Cfdi","operationId":"request_cfdi","parameters":[{"name":"payment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Payment Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/payments/{payment_id}/cfdi.{file_format}":{"get":{"tags":["account"],"summary":"Download Cfdi","operationId":"download_cfdi","parameters":[{"name":"payment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Payment Id"}},{"name":"file_format","in":"path","required":true,"schema":{"enum":["pdf","xml"],"type":"string","title":"File Format"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/checkout":{"post":{"tags":["account"],"summary":"Create Checkout","operationId":"create_checkout","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/portal":{"post":{"tags":["account"],"summary":"Create Portal","operationId":"create_portal","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/checkout/catalog":{"get":{"tags":["billing"],"summary":"Get Catalog","description":"Planes y recargas a la venta. Montos en centavos MXN con IVA incluido.\n\nCada plan trae `limits` (claves, peticiones y resultados por búsqueda) para que la\nweb y los integradores lean las cifras de la API en vez de copiarlas.","operationId":"get_catalog","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/corpus/status":{"get":{"tags":["corpus"],"summary":"Get Corpus Status","description":"Cifras vigentes del corpus y última revisión de las fuentes. Sin clave ni cobro.\n\n`norms`, `articles` y `provisions` son los ordenamientos, artículos y disposiciones\ncon texto oficial vigente en `as_of` (las mismas cifras que publica la web).\n`latest_version_from` es la vigencia más reciente entre las versiones oficiales\n(reformas o correcciones). `monitor` dice cuándo se revisaron por última vez los\ndocumentos oficiales, cuántos se vigilan y cuántos cambios esperan revisión\njurídica. La respuesta se calcula como mucho cada diez minutos.","operationId":"get_corpus_status","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"BillingProfileRequest":{"properties":{"tax_id":{"type":"string","title":"Tax Id"},"legal_name":{"type":"string","maxLength":300,"minLength":1,"title":"Legal Name"},"tax_system":{"type":"string","title":"Tax System"},"zip":{"type":"string","title":"Zip"},"cfdi_use":{"type":"string","title":"Cfdi Use"}},"type":"object","required":["tax_id","legal_name","tax_system","zip","cfdi_use"],"title":"BillingProfileRequest"},"CheckoutRequest":{"properties":{"offer":{"type":"string","title":"Offer"}},"type":"object","required":["offer"],"title":"CheckoutRequest"},"CitationReference":{"properties":{"canonical":{"type":"string","title":"Canonical"},"urn":{"type":"string","title":"Urn"},"status":{"type":"string","enum":["canonical","derived","ambiguous_legacy"],"title":"Status"},"origin":{"type":"string","enum":["citation_catalog","node_metadata"],"title":"Origin"},"ambiguity_count":{"type":"integer","minimum":1.0,"title":"Ambiguity Count","default":1}},"type":"object","required":["canonical","urn","status","origin"],"title":"CitationReference"},"Coverage":{"properties":{"federal":{"type":"boolean","title":"Federal","default":false},"state_specific":{"type":"boolean","title":"State Specific","default":false},"requires_regulation":{"type":"boolean","title":"Requires Regulation","default":false},"requires_jurisprudence":{"type":"boolean","title":"Requires Jurisprudence","default":false},"coverage_status":{"type":"string","title":"Coverage Status","default":"not_found"}},"type":"object","title":"Coverage"},"DetectedTopic":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"confidence":{"type":"number","title":"Confidence","default":0.0}},"type":"object","required":["slug","name"],"title":"DetectedTopic"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ItemTemporalCoverage":{"properties":{"policy":{"type":"string","const":"current_baseline_and_prospective","title":"Policy","default":"current_baseline_and_prospective"},"coverage_start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Coverage Start Date"},"as_of":{"type":"string","format":"date","title":"As Of"},"status":{"type":"string","enum":["covered","outside_coverage"],"title":"Status"},"historical_audit":{"type":"boolean","title":"Historical Audit","default":false},"retrospective_exception":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retrospective Exception"}},"type":"object","required":["as_of","status"],"title":"ItemTemporalCoverage"},"KeyCreateRequest":{"properties":{"name":{"type":"string","maxLength":80,"title":"Name","default":""}},"type":"object","title":"KeyCreateRequest"},"MapApplicableNorm":{"properties":{"norm":{"type":"string","title":"Norm"},"slug":{"type":"string","title":"Slug"},"articles":{"items":{"type":"string"},"type":"array","title":"Articles","default":[]},"relevance":{"type":"string","title":"Relevance","default":"secondary"},"reason":{"type":"string","title":"Reason"},"matter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matter"},"norm_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Norm Type"},"status":{"type":"string","title":"Status","default":"vigente"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"federal"},"authority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authority"},"relationships":{"items":{"$ref":"#/components/schemas/NormRelationship"},"type":"array","title":"Relationships","default":[]},"articles_available":{"items":{"type":"string"},"type":"array","title":"Articles Available","default":[]},"articles_missing":{"items":{"type":"string"},"type":"array","title":"Articles Missing","default":[]},"coverage_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage Warning"},"sources":{"items":{"type":"string"},"type":"array","title":"Sources","default":[]},"data_origin":{"type":"string","title":"Data Origin","default":"official_ingestion"},"ingestion_status":{"type":"string","title":"Ingestion Status","default":"metadata_only"},"expected_citations_total":{"type":"integer","title":"Expected Citations Total","default":0},"expected_citations_found":{"items":{"type":"string"},"type":"array","title":"Expected Citations Found","default":[]},"expected_citations_missing":{"items":{"type":"string"},"type":"array","title":"Expected Citations Missing","default":[]}},"type":"object","required":["norm","slug","reason"],"title":"MapApplicableNorm"},"MapArticle":{"properties":{"id":{"type":"string","title":"Id"},"norm":{"type":"string","title":"Norm"},"stable_identifier":{"type":"string","title":"Stable Identifier"},"label":{"type":"string","title":"Label"},"text":{"type":"string","title":"Text"},"node_version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Node Version Id"},"valid_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid From"},"valid_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid To"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum"},"components":{"anyOf":[{"items":{"$ref":"#/components/schemas/TextComponent"},"type":"array"},{"type":"null"}],"title":"Components"}},"type":"object","required":["id","norm","stable_identifier","label","text"],"title":"MapArticle","description":"Artículo de referencia del mapa, completo: `text` con sus fracciones e incisos,\n`checksum` su SHA-256 y `components` la versión de cada parte."},"MapRequest":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":2,"title":"Query"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Jurisdiction"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"mode":{"type":"string","title":"Mode","default":"api"}},"type":"object","required":["query"],"title":"MapRequest"},"MapResponse":{"properties":{"query":{"type":"string","title":"Query"},"detected_topics":{"items":{"$ref":"#/components/schemas/DetectedTopic"},"type":"array","title":"Detected Topics","default":[]},"suggested_topics":{"items":{"$ref":"#/components/schemas/DetectedTopic"},"type":"array","title":"Suggested Topics","default":[]},"applicable_norms":{"items":{"$ref":"#/components/schemas/MapApplicableNorm"},"type":"array","title":"Applicable Norms","default":[]},"coverage":{"$ref":"#/components/schemas/Coverage","default":{"federal":false,"state_specific":false,"requires_regulation":false,"requires_jurisprudence":false,"coverage_status":"not_found"}},"traceability":{"items":{"$ref":"#/components/schemas/TraceabilityItem"},"type":"array","title":"Traceability","default":[]},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","default":[]},"matching_norms":{"items":{"$ref":"#/components/schemas/MapApplicableNorm"},"type":"array","title":"Matching Norms","default":[]},"articles":{"items":{"$ref":"#/components/schemas/MapArticle"},"type":"array","title":"Articles","default":[]}},"type":"object","required":["query"],"title":"MapResponse"},"NodeReference":{"properties":{"id":{"type":"string","title":"Id"},"urn":{"type":"string","title":"Urn"},"stable_identifier":{"type":"string","title":"Stable Identifier"},"node_type":{"type":"string","title":"Node Type"},"number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Number"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"}},"type":"object","required":["id","urn","stable_identifier","node_type"],"title":"NodeReference"},"NormReference":{"properties":{"id":{"type":"string","title":"Id"},"urn":{"type":"string","title":"Urn"},"slug":{"type":"string","title":"Slug"},"official_name":{"type":"string","title":"Official Name"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"matter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matter"},"norm_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Norm Type"}},"type":"object","required":["id","urn","slug","official_name","jurisdiction"],"title":"NormReference"},"NormRelationship":{"properties":{"id":{"type":"string","title":"Id"},"source_norm_id":{"type":"string","title":"Source Norm Id"},"target_norm_id":{"type":"string","title":"Target Norm Id"},"relationship_type":{"type":"string","title":"Relationship Type"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"target_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Slug"},"target_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Name"}},"type":"object","required":["id","source_norm_id","target_norm_id","relationship_type"],"title":"NormRelationship"},"NormativePackageItem":{"properties":{"norm":{"$ref":"#/components/schemas/NormReference"},"node":{"$ref":"#/components/schemas/NodeReference"},"version":{"$ref":"#/components/schemas/VersionReference"},"citation":{"$ref":"#/components/schemas/CitationReference"},"text":{"type":"string","title":"Text"},"source":{"$ref":"#/components/schemas/SourceReference"},"temporal_coverage":{"$ref":"#/components/schemas/ItemTemporalCoverage"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"match_reasons":{"items":{"type":"string"},"type":"array","title":"Match Reasons"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"full_text_checksum":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text Checksum"},"components":{"anyOf":[{"items":{"$ref":"#/components/schemas/TextComponent"},"type":"array"},{"type":"null"}],"title":"Components"}},"type":"object","required":["norm","node","version","citation","text","source","temporal_coverage","score"],"title":"NormativePackageItem"},"PackageRelationship":{"properties":{"source_norm_urn":{"type":"string","title":"Source Norm Urn"},"target_norm_urn":{"type":"string","title":"Target Norm Urn"},"relationship_type":{"type":"string","title":"Relationship Type"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["source_norm_urn","target_norm_urn","relationship_type"],"title":"PackageRelationship"},"ResolveCoverage":{"properties":{"policy":{"type":"string","const":"current_baseline_and_prospective","title":"Policy","default":"current_baseline_and_prospective"},"as_of":{"type":"string","format":"date","title":"As Of"},"coverage_start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Coverage Start Date"},"status":{"type":"string","enum":["covered","partial","outside_coverage","future_not_available","not_found"],"title":"Status"},"historical_audit":{"type":"boolean","title":"Historical Audit","default":false},"retrospective_exception":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retrospective Exception"}},"type":"object","required":["as_of","status"],"title":"ResolveCoverage"},"ResolveRequest":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":2,"title":"Query"},"norm":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Norm"},"jurisdiction":{"type":"string","maxLength":80,"minLength":2,"title":"Jurisdiction","default":"federal"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":10}},"type":"object","required":["query"],"title":"ResolveRequest"},"ResolveResponse":{"properties":{"contract_version":{"type":"string","const":"1.0","title":"Contract Version","default":"1.0"},"package_id":{"type":"string","title":"Package Id"},"query":{"type":"string","title":"Query"},"retrieval":{"$ref":"#/components/schemas/RetrievalMetadata"},"coverage":{"$ref":"#/components/schemas/ResolveCoverage"},"items":{"items":{"$ref":"#/components/schemas/NormativePackageItem"},"type":"array","title":"Items"},"relationships":{"items":{"$ref":"#/components/schemas/PackageRelationship"},"type":"array","title":"Relationships"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["package_id","query","retrieval","coverage"],"title":"ResolveResponse"},"RetrievalMetadata":{"properties":{"strategy":{"type":"string","const":"structured_full_text","title":"Strategy","default":"structured_full_text"},"query_normalized":{"type":"string","title":"Query Normalized"},"inferred_norm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inferred Norm"},"semantic_available":{"type":"boolean","title":"Semantic Available","default":false},"semantic_used":{"type":"boolean","title":"Semantic Used","default":false}},"type":"object","required":["query_normalized"],"title":"RetrievalMetadata"},"SourceReference":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256"},"is_official":{"type":"boolean","title":"Is Official","default":false}},"type":"object","title":"SourceReference"},"TextComponent":{"properties":{"node_id":{"type":"string","title":"Node Id"},"node_type":{"type":"string","title":"Node Type"},"number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Number"},"node_version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Node Version Id"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum"},"valid_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Valid From"},"valid_to":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Valid To"}},"type":"object","required":["node_id","node_type"],"title":"TextComponent","description":"Un nodo del artículo compuesto (el propio artículo, una fracción o un inciso)."},"TraceabilityItem":{"properties":{"topic_slug":{"type":"string","title":"Topic Slug"},"norm_slug":{"type":"string","title":"Norm Slug"},"node_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Node Id"},"node_version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Node Version Id"},"confidence":{"type":"string","title":"Confidence","default":"medium"}},"type":"object","required":["topic_slug","norm_slug"],"title":"TraceabilityItem"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VersionReference":{"properties":{"id":{"type":"string","title":"Id"},"urn":{"type":"string","title":"Urn"},"valid_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Valid From"},"valid_to":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Valid To"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum"}},"type":"object","required":["id","urn"],"title":"VersionReference"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"Authorization"}}}}