{"schemaVersion":"1.0","sourceCommit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca","sourceVisibility":"private","article":{"id":"api-client-mansoq-web-src-pages-facility-settings-rcm-sourceevidenceapi-ts","title":"Source Evidence Api client API reference · mansoq-web","summary":"4 client route/call declarations with path parameters, named payload/response types and source references. Exact server acceptance and permissions require the matched backend contract.","module":"RCM & insurance","roles":["IT administrator","Developer","Integration engineer"],"facilities":["All configured facility types"],"kind":"reference","minutes":4,"prerequisites":["Use the API contract from the installed deployment and an authorized synthetic test environment.","Confirm facility/organization scope, action permissions and optional app enablement.","This reference is static source evidence; complete payload, authorization, failure and end-to-end review remains recorded as pending."],"steps":[],"sections":[{"title":"Client contract scope","body":"These 4 declarations come from **repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts**. Client types and noAuth flags describe the caller; they do not authorize a server action. Dynamic paths and missing backend matches are retained as review work, not repaired into invented endpoints."},{"title":"Operation map","body":"| Client method | HTTP method | Path pattern | Resolution |\n| --- | --- | --- | --- |\n| default.list | GET | `/api/v1/facility/{facilityId}/rcm/source_evidence/` | literal |\n| default.upload | POST | `/api/v1/facility/{facilityId}/rcm/source_evidence/` | literal |\n| default.download | GET | `/api/v1/facility/{facilityId}/rcm/source_evidence/{sourceId}/download/` | literal |\n| default.verify | POST | `/api/v1/facility/{facilityId}/rcm/source_evidence/{sourceId}/verify/` | literal |"},{"title":"default.list","body":"**GET /api/v1/facility/{facilityId}/rcm/source_evidence/**. typed route object; literal. single static method/path match; deployment boundary still requires review.\n\n**Path parameters:** `facilityId`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**response type:** `PaginatedResponse<SourceEvidence>`. client-side declaration; not proof of accepted server payload.\n\n**PaginatedResponse declared fields:**\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| count | number | true | — |\n| results | TItem[] | true | — |\n\n**SourceEvidence declared fields:**\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| id | string | true | — |\n| register_id | string | true | — |\n| authority | string | true | — |\n| title | string | true | — |\n| document_version | string | true | — |\n| effective_from | string \\| null | true | — |\n| content_sha256 | string | true | — |\n| reviewer | object \\| null | true | — |\n| reviewed_at | string \\| null | true | — |\n| is_activation_grade | boolean | true | — |\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."},{"title":"default.upload","body":"**POST /api/v1/facility/{facilityId}/rcm/source_evidence/**. typed route object; literal. single static method/path match; deployment boundary still requires review.\n\n**Path parameters:** `facilityId`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**request type:** `FormData`. client-side declaration; not proof of accepted server payload.\n\n**response type:** `SourceEvidence`. client-side declaration; not proof of accepted server payload.\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."},{"title":"default.download","body":"**GET /api/v1/facility/{facilityId}/rcm/source_evidence/{sourceId}/download/**. typed route object; literal. single static method/path match; deployment boundary still requires review.\n\n**Path parameters:** `facilityId`, `sourceId`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**response type:** `object`. client-side declaration; not proof of accepted server payload.\n\n**default.download.response declared fields:**\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| url | string | true | — |\n| sha256 | string | true | — |\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."},{"title":"default.verify","body":"**POST /api/v1/facility/{facilityId}/rcm/source_evidence/{sourceId}/verify/**. typed route object; literal. single static method/path match; deployment boundary still requires review.\n\n**Path parameters:** `facilityId`, `sourceId`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**request type:** `object`. client-side declaration; not proof of accepted server payload.\n\n**default.verify.request declared fields:**\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| reviewed_contents | boolean | true | — |\n| review_note | string | true | — |\n| mfa_code | string | false | — |\n\n**response type:** `SourceEvidence`. client-side declaration; not proof of accepted server payload.\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."}],"troubleshooting":[{"problem":"A declared route is unavailable or a request is rejected","solution":"Compare the installed revision, actual API schema, optional plugin mount, HTTP-method restrictions and recorded validation/permission evidence. Do not bypass a refusal or send a production transaction to test documentation."}],"sources":[{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":17,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":22,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":28,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":33,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-web/src/Utils/request/types.ts","line":66,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":3,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":31,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":37,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}],"related":["it-api-contract","it-api-auth","security-rcm-roles"],"verification":"Static API contract — behavior review pending","version":"f6e9f05f76d4","apiReferenceIds":["frontend-operation-bd393f5b5fcafb816d","frontend-operation-67b6c9cf85f293659b","frontend-operation-473be18785e8360a6c","frontend-operation-57af8ebc6ecb406a59"]},"backend":{"resources":[],"operations":[],"methodEvidence":[],"schemas":[],"frameworkSettings":[]},"frontend":{"operations":[{"id":"frontend-operation-bd393f5b5fcafb816d","repository":"repositories/platform/mansoq-web","apiModule":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","operationKey":"default.list","method":"GET","path":"/api/v1/facility/{facilityId}/rcm/source_evidence/","resolution":"literal","originOmitted":false,"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":17,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":null,"response":{"type":"PaginatedResponse<SourceEvidence>","schemaIds":["repositories/platform/mansoq-web/src/Utils/request/types.ts#PaginatedResponse","repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts#SourceEvidence"],"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":20,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"reviewStatus":"client-side declaration; not proof of accepted server payload"},"query":null,"clientNoAuth":null,"contractKind":"typed route object","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":["backend-resource-160fff17613ee5f6:GET:list"],"sourceFamily":"primary frontend","backendMatchStatus":"single static method/path match; deployment boundary still requires review"},{"id":"frontend-operation-67b6c9cf85f293659b","repository":"repositories/platform/mansoq-web","apiModule":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","operationKey":"default.upload","method":"POST","path":"/api/v1/facility/{facilityId}/rcm/source_evidence/","resolution":"literal","originOmitted":false,"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":22,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":{"type":"FormData","schemaIds":[],"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":26,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"reviewStatus":"client-side declaration; not proof of accepted server payload"},"response":{"type":"SourceEvidence","schemaIds":["repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts#SourceEvidence"],"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":25,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"reviewStatus":"client-side declaration; not proof of accepted server payload"},"query":null,"clientNoAuth":null,"contractKind":"typed route object","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":["backend-resource-160fff17613ee5f6:POST:create"],"sourceFamily":"primary frontend","backendMatchStatus":"single static method/path match; deployment boundary still requires review"},{"id":"frontend-operation-473be18785e8360a6c","repository":"repositories/platform/mansoq-web","apiModule":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","operationKey":"default.download","method":"GET","path":"/api/v1/facility/{facilityId}/rcm/source_evidence/{sourceId}/download/","resolution":"literal","originOmitted":false,"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":28,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"sourceId","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":null,"response":{"type":"object","schemaIds":["repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts#default.download.response"],"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":31,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"reviewStatus":"client-side declaration; not proof of accepted server payload"},"query":null,"clientNoAuth":null,"contractKind":"typed route object","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":["backend-resource-160fff17613ee5f6:GET:download"],"sourceFamily":"primary frontend","backendMatchStatus":"single static method/path match; deployment boundary still requires review"},{"id":"frontend-operation-57af8ebc6ecb406a59","repository":"repositories/platform/mansoq-web","apiModule":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","operationKey":"default.verify","method":"POST","path":"/api/v1/facility/{facilityId}/rcm/source_evidence/{sourceId}/verify/","resolution":"literal","originOmitted":false,"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":33,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"sourceId","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":{"type":"object","schemaIds":["repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts#default.verify.request"],"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":37,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"reviewStatus":"client-side declaration; not proof of accepted server payload"},"response":{"type":"SourceEvidence","schemaIds":["repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts#SourceEvidence"],"source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":36,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"reviewStatus":"client-side declaration; not proof of accepted server payload"},"query":null,"clientNoAuth":null,"contractKind":"typed route object","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":["backend-resource-160fff17613ee5f6:POST:verify"],"sourceFamily":"primary frontend","backendMatchStatus":"single static method/path match; deployment boundary still requires review"}],"schemas":[{"id":"repositories/platform/mansoq-web/src/Utils/request/types.ts#PaginatedResponse","name":"PaginatedResponse","kind":"InterfaceDeclaration","description":"","source":{"path":"repositories/platform/mansoq-web/src/Utils/request/types.ts","line":66,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"typeParameters":["TItem"],"fields":[{"name":"count","type":"number","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/Utils/request/types.ts","line":67,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"results","type":"TItem[]","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/Utils/request/types.ts","line":68,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]}],"baseSchemaIds":[],"reviewStatus":"declared TypeScript fields extracted; server payload/validation review pending","baseTypes":[]},{"id":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts#SourceEvidence","name":"SourceEvidence","kind":"InterfaceDeclaration","description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":3,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"typeParameters":[],"fields":[{"name":"id","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":4,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"register_id","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":5,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"authority","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":6,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"title","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":7,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"document_version","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":8,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"effective_from","type":"string | null","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":9,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"content_sha256","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":10,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"reviewer","type":"object | null","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":11,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"reviewed_at","type":"string | null","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":12,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"is_activation_grade","type":"boolean","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":13,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]}],"baseSchemaIds":[],"reviewStatus":"declared TypeScript fields extracted; server payload/validation review pending","baseTypes":[]},{"id":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts#default.download.response","name":"default.download.response","kind":"inline object type","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":31,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"fields":[{"name":"url","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":31,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"sha256","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":31,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]}],"baseSchemaIds":[],"typeParameters":[],"reviewStatus":"declared TypeScript fields extracted; server payload/validation review pending"},{"id":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts#default.verify.request","name":"default.verify.request","kind":"inline object type","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":37,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"fields":[{"name":"reviewed_contents","type":"boolean","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":38,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"review_note","type":"string","required":true,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":39,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]},{"name":"mfa_code","type":"string","required":false,"readOnly":false,"hasInitializer":false,"description":"","source":{"path":"repositories/platform/mansoq-web/src/pages/Facility/settings/rcm/sourceEvidenceApi.ts","line":40,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"schemaIds":[]}],"baseSchemaIds":[],"typeParameters":[],"reviewStatus":"declared TypeScript fields extracted; server payload/validation review pending"}]},"services":{"operations":[]},"boundaries":[]}