{ "info": { "_postman_id": "41e65af5-57ce-4f61-94df-ba18318ab396", "name": "Kita Capture Applications Batch API", "description": "Kita Capture turns scanned or photographed financial and identity documents into clean\nJSON \u2014 transactions, metadata, metrics, and fraud signals. Upload a file (multipart or\nbase64), submit a URL, or batch up to 100 documents, then poll for results or receive an\nHMAC-signed webhook.\n\nAuthentication uses an organization API key prefixed `kita_prod_` sent as\n`Authorization: Bearer `. Errors return `{ \"error\": ..., \"message\": ... }`.\nRate limiting is per organization; 429 responses carry a `Retry-After` header.\n\nNOTE: Kita does not publish a machine-readable OpenAPI description. This document was\ngenerated by the API Evangelist enrichment pipeline from Kita's own published API\ndocumentation (shipped verbatim inside the official `kita-docs-mcp` npm package and\nserved at https://www.kita.ai/documentation). Only operations, parameters, fields and\nstatus codes that Kita documents are represented here.\n\n\nContact Support:\n Name: Kita Support\n Email: support@kita.ai", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:59:50.000Z", "updatedAt": "2026-07-28T01:59:50.000Z", "lastUpdatedBy": "35240", "uid": "35240-41e65af5-57ce-4f61-94df-ba18318ab396" }, "item": [ { "name": "api", "item": [ { "name": "v1", "item": [ { "name": "batch", "item": [ { "name": "{batchId}", "item": [ { "name": "results", "item": [ { "name": "Get results for every document in a batch", "id": "91e8c040-0b21-414e-af3b-ca8ad15e9b6f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v1/batch/:batchId/results", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch", ":batchId", "results" ], "variable": [ { "id": "339e4bb5-1bf0-446e-8a70-349663dbe48f", "key": "batchId", "value": "", "description": "(Required) " } ] } }, "response": [ { "id": "866340e2-13d4-4d12-861e-be6291dcdb9d", "name": "Full extracted data for each document in the batch.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/v1/batch/:batchId/results", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch", ":batchId", "results" ], "variable": [ { "key": "batchId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-866340e2-13d4-4d12-861e-be6291dcdb9d" }, { "id": "910c7a06-20b4-4bca-b761-2a4092463c1b", "name": "Invalid or missing API key.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/v1/batch/:batchId/results", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch", ":batchId", "results" ], "variable": [ { "key": "batchId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-910c7a06-20b4-4bca-b761-2a4092463c1b" }, { "id": "3e9ade7b-de03-4953-8a41-45f2ae5d1132", "name": "Document or batch ID does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/v1/batch/:batchId/results", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch", ":batchId", "results" ], "variable": [ { "key": "batchId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-3e9ade7b-de03-4953-8a41-45f2ae5d1132" } ], "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-91e8c040-0b21-414e-af3b-ca8ad15e9b6f" } ], "id": "6cfa6d11-67a1-45cc-b5e7-b4a9fc1400d7", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-6cfa6d11-67a1-45cc-b5e7-b4a9fc1400d7" }, { "name": "Get batch status", "id": "d8927919-4cea-4add-8c64-2747ae414936", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v1/batch/:batchId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch", ":batchId" ], "variable": [ { "id": "7ede64b7-a498-4afa-ad44-4a3ea51db2b0", "key": "batchId", "value": "", "description": "(Required) " } ] } }, "response": [ { "id": "6fc3107d-a5a0-427b-9cea-0f43b23a3c47", "name": "Batch progress.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/v1/batch/:batchId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch", ":batchId" ], "variable": [ { "key": "batchId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"batch_id\": \"\",\n \"status\": \"\",\n \"total_documents\": \"\",\n \"completed\": \"\",\n \"failed\": \"\",\n \"progress_percent\": \"\",\n \"status_url\": \"\",\n \"documents\": [\n {\n \"document_id\": \"\",\n \"filename\": \"\",\n \"status\": \"failed\"\n },\n {\n \"document_id\": \"\",\n \"filename\": \"\",\n \"status\": \"pending\"\n }\n ]\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-6fc3107d-a5a0-427b-9cea-0f43b23a3c47" }, { "id": "d33b1c92-742d-4fbd-a40f-4d4070c1872e", "name": "Invalid or missing API key.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/v1/batch/:batchId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch", ":batchId" ], "variable": [ { "key": "batchId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-d33b1c92-742d-4fbd-a40f-4d4070c1872e" }, { "id": "76487ecb-1cac-480d-b056-f0ba3bc9ef5b", "name": "Document or batch ID does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/v1/batch/:batchId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch", ":batchId" ], "variable": [ { "key": "batchId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-76487ecb-1cac-480d-b056-f0ba3bc9ef5b" } ], "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-d8927919-4cea-4add-8c64-2747ae414936" } ], "id": "9ea3ca10-e24f-4492-b618-85105dd2a0a0", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-9ea3ca10-e24f-4492-b618-85105dd2a0a0" }, { "name": "Process documents from URLs", "id": "e29f1a27-eda6-45a1-9d67-fe1fe8657b31", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"documents\": [\n {\n \"file_url\": \"\",\n \"document_type\": \"mayors_permit\",\n \"filename\": \"\"\n },\n {\n \"file_url\": \"\",\n \"document_type\": \"payslip\",\n \"filename\": \"\"\n }\n ],\n \"webhook_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch" ] }, "description": "Submit up to 100 documents by URL in a single request. Each entry requires `file_url` and `document_type`; optional `filename` overrides auto-detection. Batch processing requires a paid plan." }, "response": [ { "id": "26f1e386-757c-40c2-ad37-513c00ee7dea", "name": "Batch created.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"documents\": [\n {\n \"file_url\": \"\",\n \"document_type\": \"mayors_permit\",\n \"filename\": \"\"\n },\n {\n \"file_url\": \"\",\n \"document_type\": \"payslip\",\n \"filename\": \"\"\n }\n ],\n \"webhook_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"batch_id\": \"\",\n \"status\": \"\",\n \"total_documents\": \"\",\n \"completed\": \"\",\n \"failed\": \"\",\n \"progress_percent\": \"\",\n \"status_url\": \"\",\n \"documents\": [\n {\n \"document_id\": \"\",\n \"filename\": \"\",\n \"status\": \"failed\"\n },\n {\n \"document_id\": \"\",\n \"filename\": \"\",\n \"status\": \"pending\"\n }\n ]\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-26f1e386-757c-40c2-ad37-513c00ee7dea" }, { "id": "3e4b500d-1f6b-4d5a-8049-6fb029c8f5fc", "name": "Bad request \u2014 check the request body and parameters.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"documents\": [\n {\n \"file_url\": \"\",\n \"document_type\": \"mayors_permit\",\n \"filename\": \"\"\n },\n {\n \"file_url\": \"\",\n \"document_type\": \"payslip\",\n \"filename\": \"\"\n }\n ],\n \"webhook_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-3e4b500d-1f6b-4d5a-8049-6fb029c8f5fc" }, { "id": "0e5c3d9c-dc66-4d30-8224-0d1bfcc76e28", "name": "Invalid or missing API key.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"documents\": [\n {\n \"file_url\": \"\",\n \"document_type\": \"mayors_permit\",\n \"filename\": \"\"\n },\n {\n \"file_url\": \"\",\n \"document_type\": \"payslip\",\n \"filename\": \"\"\n }\n ],\n \"webhook_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-0e5c3d9c-dc66-4d30-8224-0d1bfcc76e28" }, { "id": "5d799e27-f229-4898-b558-0d9a30ad7b03", "name": "Upgrade required, or the document type is not enabled for this organization.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"documents\": [\n {\n \"file_url\": \"\",\n \"document_type\": \"mayors_permit\",\n \"filename\": \"\"\n },\n {\n \"file_url\": \"\",\n \"document_type\": \"payslip\",\n \"filename\": \"\"\n }\n ],\n \"webhook_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-5d799e27-f229-4898-b558-0d9a30ad7b03" }, { "id": "c8832264-41f0-4d2b-9317-e80887e56b7f", "name": "Rate limited. Wait and retry; check the `Retry-After` header.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"documents\": [\n {\n \"file_url\": \"\",\n \"document_type\": \"mayors_permit\",\n \"filename\": \"\"\n },\n {\n \"file_url\": \"\",\n \"document_type\": \"payslip\",\n \"filename\": \"\"\n }\n ],\n \"webhook_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v1/batch", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "batch" ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Seconds to wait before retrying.", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-c8832264-41f0-4d2b-9317-e80887e56b7f" } ], "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-e29f1a27-eda6-45a1-9d67-fe1fe8657b31" } ], "id": "940ab375-602e-4ea7-9b90-cc8c907fcf35", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-940ab375-602e-4ea7-9b90-cc8c907fcf35" } ], "id": "34181074-11db-4e53-a632-f0b886a80943", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-34181074-11db-4e53-a632-f0b886a80943" } ], "id": "ba5f2dab-5bf2-4bec-9053-019f5ce5fbfc", "createdAt": "2026-07-28T01:59:51.000Z", "updatedAt": "2026-07-28T01:59:51.000Z", "uid": "35240-ba5f2dab-5bf2-4bec-9053-019f5ce5fbfc" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://portal.usekita.com" } ] }