Use counts to follow progress and done to identify a finished batch. done: true means every job is either completed or failed; inspect the individual jobs to distinguish their outcomes.See progress and timing for the difference between execution timestamps and final completion.For authentication, limits, and HTTP errors, see the workflow and error guide.
Earliest known actual execution start across its jobs; null if no start is known.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Perceptron Docs","colors":{"primary":"#3B63FF","light":"#8BA6FF","dark":"#193BFF"},"logo":{"light":"https://mintcdn.com/perceptron/CuyGah1e2BqRrsVm/logo/perceptron-full-logo-light.svg?fit=max\u0026auto=format\u0026n=CuyGah1e2BqRrsVm\u0026q=85\u0026s=f5d2ffd0aaf71daba362f13fc9f7decf","dark":"https://mintcdn.com/perceptron/CuyGah1e2BqRrsVm/logo/perceptron-full-logo-dark.svg?fit=max\u0026auto=format\u0026n=CuyGah1e2BqRrsVm\u0026q=85\u0026s=859b1eeb3fa33674275135e6590684df"},"favicon":{"light":"https://mintcdn.com/perceptron/h8MQ12qmkOCPxnyY/logo/favicon_light.png?fit=max\u0026auto=format\u0026n=h8MQ12qmkOCPxnyY\u0026q=85\u0026s=9fed764e4a310a0a735776364bae108f","dark":"https://mintcdn.com/perceptron/h8MQ12qmkOCPxnyY/logo/favicon_dark.png?fit=max\u0026auto=format\u0026n=h8MQ12qmkOCPxnyY\u0026q=85\u0026s=c3ee1fadf844c0278101787211ea413c"},"api":{"openapi":{"source":"api-reference/openapi.json","directory":"api-reference"},"mdx":{"auth":{"method":"bearer"}}},"navbar":{"links":[{"href":"https://www.perceptron.inc/demo","label":"Demo"},{"href":"mailto:support@perceptron.inc","label":"Support"},{"href":"https://discord.gg/fgBeaACQzE","label":"Discord"}]},"footer":{"socials":{"discord":"https://discord.gg/fgBeaACQzE","github":"https://github.com/perceptron-ai-inc","linkedin":"https://www.linkedin.com/company/perceptron-ai-inc","x":"https://x.com/perceptroninc"}},"contextual":{"options":["copy","chatgpt","claude","cursor","mcp","perplexity","view","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"perceptron","hasAudioNarration":false,"actualSubdomain":"perceptron","customDomains":["docs.perceptron.inc"],"gitSource":{"type":"github","owner":"perceptron-ai-inc","repo":"mintlify_docs","deployBranch":"production","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab61f6fc6fb6f41c7bf742a","collectionId":"47c4f240-aa64-46f0-a5e2-b4675a405dae","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab61f6fc6fb6f41c7bf742a"},"entitlements":{},"buildId":"6aeb0a42c8520f7b8ee1fd76","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Models","count":74},{"language":"default","tag":"Perceptron Mk1.5","count":60},{"language":"default","tag":"Perceptron Mk1","count":46},{"language":"default","tag":"API reference","count":38},{"language":"default","tag":"Capabilities","count":28},{"language":"default","tag":"Developer guides","count":23},{"language":"default","tag":"Services","count":21},{"language":"default","tag":"Egocentric","count":16},{"language":"default","tag":"Python SDK","count":12},{"language":"default","tag":"Image","count":11}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"ABCArizonaFlare\";font-style:normal;font-weight:400;font-display:swap;src:url(/fonts/ABCArizonaFlare/ABCArizonaFlare-Regular-Trial.woff2) format(\"woff2\")}#page-title,.api-endpoint h3,.api-section h2,.mdx-content h1,.mdx-content h2,.page-title{font-family:\"ABCArizonaFlare\";font-weight:400}.h-5,h5{text-transform:uppercase;font-size:.85rem}"}],"page":{"pagePath":"api-reference/egocentric/retrieve-an-egocentric-batch","slug":"/api-reference/egocentric/retrieve-an-egocentric-batch","pageMetadata":{"title":"Retrieve an egocentric batch","description":"Retrieve an egocentric batch with the Egocentric API.","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}","href":"/api-reference/egocentric/retrieve-an-egocentric-batch"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve an egocentric batch with the Egocentric API.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`counts`}),` to follow progress and `,_jsx(_components.code,{children:`done`}),` to identify a finished batch. `,_jsx(_components.code,{children:`done: true`}),` means every job is either `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`failed`}),`; inspect the individual jobs to distinguish their outcomes.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/services/egocentric#follow-progress`,children:`progress and timing`}),` for the difference between execution timestamps and final completion.`]}),`\n`,_jsxs(_components.p,{children:[`For authentication, limits, and HTTP errors, see the `,_jsx(_components.a,{href:`/services/egocentric`,children:`workflow`}),` and `,_jsx(_components.a,{href:`/services/egocentric-limits-and-errors`,children:`error guide`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retrieve an egocentric batch","description":"Retrieve an egocentric batch with the Egocentric API.","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}","href":"/api-reference/egocentric/retrieve-an-egocentric-batch"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Egocentric"],"summary":"Retrieve an egocentric batch","description":"Retrieve an egocentric batch with the Egocentric API.","operationId":"get_batch","parameters":["b9d4a888-014c-4d17-90f5-ddf18a16bf36"],"responses":{"200":"a8761c6a-2b08-4c36-8490-3ddead1eed07","400":"7898613b-2de7-4a8f-9a96-a146ecbce31a","401":"5923f387-73cb-433f-bae3-bcfb2a8d62cc","404":"c5270c13-7f2f-4fa0-ba9c-a3de757cb88a","429":"1b94b781-7427-49e1-a1c5-d5e87f8f99d5","500":"d6e8a1e4-7557-4915-be54-5ab2df0ae379","503":"e4e2e375-95d1-4798-b200-11306a4b80d7"},"security":["67aafc66-5632-485a-ada9-562b86dd6b79"],"method":"get","type":"path","servers":["16d03011-ad5e-449c-a789-eb4f6a23bc43"],"path":"/v1/egocentric/batches/{batch_id}","baseUrlOptions":["https://api.perceptron.inc"],"title":"Retrieve an egocentric batch","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b9d4a888-014c-4d17-90f5-ddf18a16bf36":{"name":"batch_id","in":"path","description":"Batch identifier.","required":true,"schema":{"type":"string","isRequired":true,"description":"Batch identifier.","uniqueKey":"","typeLabel":"string"}}},"responses":{"a8761c6a-2b08-4c36-8490-3ddead1eed07":{"description":"Batch","content":{"application/json":{"schema":{"type":"object","description":"Progress, options, and timing for a batch of videos.","required":["object","id","job_count","options","counts","done","created_at","started_at","execution_finished_at","finished_at"],"properties":{"counts":{"type":"object","description":"Job counts by public state, including zero counts.","required":["queued","submitted","processing","completed","failed"],"properties":{"completed":{"type":"integer","format":"int32","description":"Jobs that finished successfully.","minimum":0,"isRequired":true,"uniqueKey":"counts.completed","typeLabel":"integer\u003cint32>"},"failed":{"type":"integer","format":"int32","description":"Jobs that finished without a result.","minimum":0,"isRequired":true,"uniqueKey":"counts.failed","typeLabel":"integer\u003cint32>"},"processing":{"type":"integer","format":"int32","description":"Jobs whose execution has started and that are not yet finished.","minimum":0,"isRequired":true,"uniqueKey":"counts.processing","typeLabel":"integer\u003cint32>"},"queued":{"type":"integer","format":"int32","description":"Jobs preparing inputs or waiting for capacity.","minimum":0,"isRequired":true,"uniqueKey":"counts.queued","typeLabel":"integer\u003cint32>"},"submitted":{"type":"integer","format":"int32","description":"Jobs accepted for execution and waiting to run.","minimum":0,"isRequired":true,"uniqueKey":"counts.submitted","typeLabel":"integer\u003cint32>"}},"isRequired":true,"uniqueKey":"counts","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","description":"UTC time the batch was accepted.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"done":{"type":"boolean","description":"True once every job has completed or failed.","isRequired":true,"uniqueKey":"done","typeLabel":"boolean"},"execution_finished_at":{"oneOf":[{"type":"string","format":"date-time","description":"Latest actual execution end once every job has a known end or is confirmed never to have run.\nNull if any end is unknown or no job ran.","isRequired":true,"uniqueKey":"execution_finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Latest actual execution end once every job has a known end or is confirmed never to have run.\nNull if any end is unknown or no job ran.","isRequired":true,"uniqueKey":"execution_finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"execution_finished_at","typeLabel":"string\u003cdate-time> | null"},"finished_at":{"oneOf":[{"type":"string","format":"date-time","description":"Time the last job finished; null until done is true.","isRequired":true,"uniqueKey":"finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Time the last job finished; null until done is true.","isRequired":true,"uniqueKey":"finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"finished_at","typeLabel":"string\u003cdate-time> | null"},"id":{"type":"string","description":"Unique batch identifier.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"job_count":{"type":"integer","format":"int32","description":"Number of submitted inputs and jobs.","maximum":1000,"minimum":1,"isRequired":true,"uniqueKey":"job_count","typeLabel":"integer\u003cint32>"},"object":{"type":"string","description":"Object type, always egocentric.batch.","example":"egocentric.batch","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"options":{"type":"object","description":"Options applied to every job, with defaults filled in at acceptance.","required":["hand_tracking","hand_activity"],"properties":{"hand_activity":{"type":"boolean","description":"Whether hand activity annotations are included.","isRequired":true,"uniqueKey":"options.hand_activity","typeLabel":"boolean"},"hand_tracking":{"oneOf":[{"type":"boolean","title":"Hand tracking disabled","description":"Disabled, or enabled with the output format fixed when the batch was accepted.","enum":[false],"isRequired":true,"uniqueKey":"options.hand_tracking.oneOf.0","typeLabel":"enum\u003cboolean>"},{"type":"object","title":"Hand tracking settings","description":"Disabled, or enabled with the output format fixed when the batch was accepted.","required":["output"],"properties":{"output":{"type":"string","description":"Hand tracking format: 2d includes per-frame boxes and keypoints;\n3d also includes a mesh and 3D joints.","enum":["2d","3d"],"isRequired":true,"uniqueKey":"options.hand_tracking.oneOf.1.output","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"options.hand_tracking.oneOf.1","typeLabel":"Hand tracking settings · object"}],"isRequired":true,"uniqueKey":"options.hand_tracking","typeLabel":"enum\u003cboolean> | Hand tracking settings · object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"options","typeLabel":"object"},"started_at":{"oneOf":[{"type":"string","format":"date-time","description":"Earliest known actual execution start across its jobs; null if no start is known.","isRequired":true,"uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Earliest known actual execution start across its jobs; null if no start is known.","isRequired":true,"uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"counts":{"completed":1,"failed":1,"processing":1,"queued":1,"submitted":1},"created_at":"2023-11-07T05:31:56Z","done":true,"execution_finished_at":"2023-11-07T05:31:56Z","finished_at":"2023-11-07T05:31:56Z","id":"\u003cstring>","job_count":500,"object":"egocentric.batch","options":{"hand_activity":true,"hand_tracking":false},"started_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"7898613b-2de7-4a8f-9a96-a146ecbce31a":{"description":"Invalid request or query parameter","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5923f387-73cb-433f-bae3-bcfb2a8d62cc":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c5270c13-7f2f-4fa0-ba9c-a3de757cb88a":{"description":"Batch not found","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1b94b781-7427-49e1-a1c5-d5e87f8f99d5":{"description":"Request or submission limit reached","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying; omitted for insufficient credits."}},"content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d6e8a1e4-7557-4915-be54-5ab2df0ae379":{"description":"Unexpected error","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e4e2e375-95d1-4798-b200-11306a4b80d7":{"description":"Temporarily unavailable","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying; omitted for insufficient credits."}},"content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"67aafc66-5632-485a-ada9-562b86dd6b79":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Bearer token authentication using your Perceptron API key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"16d03011-ad5e-449c-a789-eb4f6a23bc43":{"url":"https://api.perceptron.inc"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer token authentication using your Perceptron API key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication using your Perceptron API key","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"perceptron","siteName":"Perceptron Docs","title":"Retrieve an egocentric batch - Perceptron Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T10:34:48.769Z","originalFileLocation":"api-reference/egocentric/retrieve-an-egocentric-batch.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve an egocentric batch with the Egocentric API.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Perceptron Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve an egocentric batch - Perceptron Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve an egocentric batch with the Egocentric API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Perceptron Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://perceptron.mintlify.app/_mintlify/api/og/v2?division=Egocentric\u0026amp;title=Retrieve+an+egocentric+batch\u0026amp;description=Retrieve+an+egocentric+batch+with+the+Egocentric+API.\u0026amp;theme=ceaeb19d1c5c0da2f2187829\u0026amp;signature=6e520baada7d200842aa2bbb17642a2228cedf9a4ec8d9b5ec7e75f086bbd4a9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Retrieve an egocentric batch - Perceptron Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve an egocentric batch with the Egocentric API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://perceptron.mintlify.app/_mintlify/api/og/v2?division=Egocentric\u0026amp;title=Retrieve+an+egocentric+batch\u0026amp;description=Retrieve+an+egocentric+batch+with+the+Egocentric+API.\u0026amp;theme=ceaeb19d1c5c0da2f2187829\u0026amp;signature=6e520baada7d200842aa2bbb17642a2228cedf9a4ec8d9b5ec7e75f086bbd4a9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Perceptron Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B63FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/egocentric/retrieve-an-egocentric-batch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.perceptron.inc/#organization\",\"name\":\"Perceptron Docs\",\"url\":\"https://docs.perceptron.inc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/perceptron/CuyGah1e2BqRrsVm/logo/perceptron-full-logo-light.svg?fit=max\u0026auto=format\u0026n=CuyGah1e2BqRrsVm\u0026q=85\u0026s=f5d2ffd0aaf71daba362f13fc9f7decf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.perceptron.inc#website\",\"name\":\"Perceptron Docs\",\"url\":\"https://docs.perceptron.inc\",\"publisher\":{\"@id\":\"https://docs.perceptron.inc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch#webpage\",\"url\":\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch\",\"name\":\"Retrieve an egocentric batch\",\"description\":\"Retrieve an egocentric batch with the Egocentric API.\",\"dateModified\":\"2026-11-04T10:34:48.769Z\",\"isPartOf\":{\"@id\":\"https://docs.perceptron.inc#website\"},\"breadcrumb\":{\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Services\",\"item\":\"https://docs.perceptron.inc/api-reference/detection/detect-objects\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Egocentric\",\"item\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve an egocentric batch\",\"item\":\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch#apireference\",\"headline\":\"Retrieve an egocentric batch\",\"name\":\"Retrieve an egocentric batch\",\"description\":\"Retrieve an egocentric batch with the Egocentric API.\",\"url\":\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/retrieve-an-egocentric-batch#webpage\"},\"dateModified\":\"2026-11-04T10:34:48.769Z\",\"publisher\":{\"@id\":\"https://docs.perceptron.inc/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.perceptron.inc#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Perceptron Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Perceptron Docs","nav":{"global":null,"tabs":[{"tab":"Overview","icon":"house","pages":[{"title":"Overview","href":""}]},{"tab":"Models","icon":"microchip","dropdowns":[{"dropdown":"Perceptron Mk1.5","icon":"microchip","description":"Latest","groups":[{"group":"Get started","pages":[{"title":"Models overview","sidebarTitle":"All models","href":"/models"},{"title":"Quickstart","icon":"rocket","href":"/perceptron-mk1.5/index"},{"title":"Perceptron Mk1.5","sidebarTitle":"Model spec","href":"/perceptron-mk1.5/models/perceptron-mk1.5"},{"title":"Release notes","href":"/perceptron-mk1.5/changelog"}]},{"group":"Capabilities","pages":[{"group":"Image","pages":[{"title":"Image understanding","href":"/perceptron-mk1.5/capabilities/image-understanding"},{"title":"Image Q\u0026A","sidebarTitle":"Image Q\u0026A","href":"/perceptron-mk1.5/capabilities/image-qa"},{"title":"Image captioning","href":"/perceptron-mk1.5/capabilities/image-captioning"},{"title":"Object detection","href":"/perceptron-mk1.5/capabilities/object-detection"},{"title":"OCR","href":"/perceptron-mk1.5/capabilities/ocr"},{"title":"In-context learning (image)","sidebarTitle":"ICL (image)","href":"/perceptron-mk1.5/capabilities/in-context-learning-image"}]},{"group":"Video","pages":[{"title":"Video understanding","href":"/perceptron-mk1.5/capabilities/video-understanding"},{"title":"Video Q\u0026A","sidebarTitle":"Video Q\u0026A","href":"/perceptron-mk1.5/capabilities/video-qa"},{"title":"Video clipping","sidebarTitle":"Video clipping","href":"/perceptron-mk1.5/capabilities/video-clipping"},{"title":"In-context learning (video)","sidebarTitle":"ICL (video)","href":"/perceptron-mk1.5/capabilities/in-context-learning-video"},{"title":"Video tracking","href":"/perceptron-mk1.5/capabilities/video-tracking"}]},{"group":"Audio","pages":[{"title":"Audio understanding","href":"/perceptron-mk1.5/capabilities/audio"},{"title":"Audio Q\u0026A","sidebarTitle":"Audio Q\u0026A","href":"/perceptron-mk1.5/capabilities/audio-qa"},{"title":"Audio transcription","href":"/perceptron-mk1.5/capabilities/audio-transcription"},{"title":"Audio clipping","href":"/perceptron-mk1.5/capabilities/audio-clipping"}]},{"title":"Tools","sidebarTitle":"Tools","href":"/perceptron-mk1.5/capabilities/tool-calling"},{"title":"Reasoning","href":"/perceptron-mk1.5/capabilities/thinking"},{"title":"Structured outputs","href":"/perceptron-mk1.5/capabilities/structured-outputs"}]},{"group":"Developer guides","pages":[{"group":"Python SDK","pages":[{"title":"Get started with Python","sidebarTitle":"Get started","href":"/perceptron-mk1.5/guides/python/getting-started"},{"title":"Authentication","href":"/perceptron-mk1.5/guides/python/auth"},{"title":"Request basics","href":"/perceptron-mk1.5/guides/python/request-basics"},{"title":"Rendering annotations","href":"/perceptron-mk1.5/guides/rendering-annotations"},{"title":"Coordinate system","href":"/perceptron-mk1.5/concepts/coordinates"},{"title":"Python FAQs","sidebarTitle":"FAQs","href":"/perceptron-mk1.5/guides/python/faqs"}]},{"title":"Annotation format","href":"/perceptron-mk1.5/concepts/annotations"},{"title":"Multiple assets","href":"/perceptron-mk1.5/guides/multiple-assets"},{"title":"Function calling","href":"/perceptron-mk1.5/guides/tool-calling"},{"title":"Files","href":"/perceptron-mk1.5/guides/files"},{"title":"Multilook","href":"/perceptron-mk1.5/guides/multilook"},{"title":"MCP","href":"/perceptron-mk1.5/guides/mcp"},{"title":"Error messages","href":"/perceptron-mk1.5/guides/error-messages"}]},{"group":"Scaling \u0026 deployment","pages":[{"title":"Batch processing","href":"/perceptron-mk1.5/guides/batch"},{"title":"Scaling","href":"/perceptron-mk1.5/guides/scaling"},{"title":"Tokenization","href":"/perceptron-mk1.5/guides/tokenization"}]},{"group":"Best practices","pages":[{"title":"Prompting reference","href":"/perceptron-mk1.5/best-practices/prompting-reference"},{"title":"Security","href":"/perceptron-mk1.5/best-practices/security"},{"title":"Building a tool agent","href":"/perceptron-mk1.5/guides/tool-agents"},{"title":"High-fidelity object tracking","href":"/perceptron-mk1.5/guides/high-fidelity-object-tracking"}]}]},{"dropdown":"Perceptron Mk1","icon":"microchip","groups":[{"group":"Get started","pages":[{"title":"Quickstart","icon":"rocket","sidebarTitle":"Quickstart","href":"/perceptron-mk1/index"},{"title":"Perceptron Mk1","sidebarTitle":"Model spec","href":"/perceptron-mk1/models/perceptron-mk1"},{"title":"Release notes","href":"/perceptron-mk1/changelog"}]},{"group":"Capabilities","pages":[{"group":"Image","pages":[{"title":"Image Q\u0026A","sidebarTitle":"Image Q\u0026A","href":"/perceptron-mk1/capabilities/image-qa"},{"title":"Image captioning","sidebarTitle":"Image captioning","href":"/perceptron-mk1/capabilities/image-captioning"},{"title":"Object detection","href":"/perceptron-mk1/capabilities/object-detection"},{"title":"OCR","href":"/perceptron-mk1/capabilities/ocr"},{"title":"In-context learning (image)","sidebarTitle":"ICL (image)","href":"/perceptron-mk1/capabilities/in-context-learning-image"}]},{"group":"Video","pages":[{"title":"Video Q\u0026A","sidebarTitle":"Video Q\u0026A","href":"/perceptron-mk1/capabilities/video-qa"},{"title":"Video clipping","sidebarTitle":"Video clipping","href":"/perceptron-mk1/capabilities/video-clipping"},{"title":"In-context learning (video)","sidebarTitle":"ICL (video)","href":"/perceptron-mk1/capabilities/in-context-learning-video"}]},{"title":"Thinking","href":"/perceptron-mk1/capabilities/thinking"},{"title":"Structured outputs","href":"/perceptron-mk1/capabilities/structured-outputs"}]},{"group":"Developer guides","pages":[{"group":"Python SDK","pages":[{"title":"Get started","href":"/perceptron-mk1/guides/python-sdk/getting-started"},{"title":"Authentication","href":"/perceptron-mk1/guides/python-sdk/auth"},{"title":"Pointing basics","href":"/perceptron-mk1/guides/python-sdk/pointing-basics"},{"title":"Perceive basics","href":"/perceptron-mk1/guides/python-sdk/perceive-basics"},{"title":"Coordinate system","href":"/perceptron-mk1/concepts/coordinates"},{"title":"Python SDK FAQs","sidebarTitle":"FAQs","href":"/perceptron-mk1/guides/python-sdk/faqs"}]},{"title":"Files","href":"/perceptron-mk1/guides/files"},{"title":"Multilook","href":"/perceptron-mk1/guides/multilook"},{"title":"MCP","href":"/perceptron-mk1/guides/mcp"},{"title":"Error messages","href":"/perceptron-mk1/guides/error-messages"}]},{"group":"Scaling \u0026 deployment","pages":[{"title":"Batch processing","href":"/perceptron-mk1/guides/batch"},{"title":"Scaling","href":"/perceptron-mk1/guides/scaling"},{"title":"Tokenization","href":"/perceptron-mk1/guides/tokenization"}]},{"group":"Best practices","pages":[{"title":"Prompting reference","href":"/perceptron-mk1/best-practices/prompting-reference"},{"title":"Security","href":"/perceptron-mk1/best-practices/security"}]}]}]},{"tab":"Services","icon":"server","pages":[{"title":"Services","href":"/services"}]},{"tab":"API reference","icon":"code","dropdowns":[{"dropdown":"Perceptron Mk1.5","icon":"microchip","description":"Latest","groups":[{"group":"API reference","pages":[{"title":"API reference","sidebarTitle":"Overview","href":"/api-reference"}]},{"group":"Chat completions","pages":[{"title":"Create chat completion","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/chat/completions","href":"/api-reference/chat-completions/create-chat-completion"},{"title":"Create multilook chat completions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/chat/completions/multilook","href":"/api-reference/chat-completions/create-multilook-chat-completions"}]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files","href":"/api-reference/files/list-files"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/files","href":"/api-reference/files/upload-a-file"},{"title":"Retrieve a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files/{file_id}","href":"/api-reference/files/retrieve-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/files/{file_id}","href":"/api-reference/files/delete-a-file"},{"title":"Download a file's contents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files/{file_id}/content","href":"/api-reference/files/download-a-files-contents"}]},{"group":"Models","pages":[{"title":"List available models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/models","href":"/api-reference/models/list-available-models"},{"title":"Retrieve a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/models/{model_id}","href":"/api-reference/models/retrieve-a-model"}]},{"group":"Services","pages":[{"group":"Detect","pages":[{"title":"Detect objects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/detect","href":"/api-reference/detection/detect-objects"}]},{"group":"Egocentric","pages":[{"title":"Submit an egocentric batch","openapi":"api-reference/openapi.json POST /v1/egocentric/batches","href":"/api-reference/egocentric/submit-an-egocentric-batch"},{"title":"List egocentric batches","description":"List egocentric batches with the Egocentric API.","openapi":"api-reference/openapi.json GET /v1/egocentric/batches","href":"/api-reference/egocentric/list-egocentric-batches"},{"title":"Retrieve an egocentric batch","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}","href":"/api-reference/egocentric/retrieve-an-egocentric-batch"},{"title":"List jobs in an egocentric batch","description":"List jobs in an egocentric batch with the Egocentric API.","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}/jobs","href":"/api-reference/egocentric/list-jobs-in-an-egocentric-batch"},{"title":"List egocentric jobs","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs","href":"/api-reference/egocentric/list-egocentric-jobs"},{"title":"Retrieve an egocentric job","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs/{job_id}","href":"/api-reference/egocentric/retrieve-an-egocentric-job"},{"title":"Download an egocentric result","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs/{job_id}/result","href":"/api-reference/egocentric/download-an-egocentric-result"}]}]}]},{"dropdown":"Perceptron Mk1","icon":"microchip","groups":[{"group":"API reference","pages":[{"title":"Perceptron Mk1 API reference","sidebarTitle":"Overview","href":"/perceptron-mk1/api-reference"}]},{"group":"Chat completions","pages":[{"title":"Create chat completion (Mk1)","api":"POST https://api.perceptron.inc/v1/chat/completions","playground":"simple","href":"/perceptron-mk1/api-reference/endpoint/chat-completions"},{"title":"Create multilook chat completions (Mk1)","api":"POST https://api.perceptron.inc/v1/chat/completions/multilook","playground":"simple","href":"/perceptron-mk1/api-reference/endpoint/multilook-chat-completions"}]},{"group":"Files","pages":[{"title":"List files","openapi":"api-reference/openapi.json GET /v1/files","href":"/perceptron-mk1/api-reference/files/list-files"},{"title":"Upload a file","openapi":"api-reference/openapi.json POST /v1/files","href":"/perceptron-mk1/api-reference/files/upload-a-file"},{"title":"Retrieve a file","openapi":"api-reference/openapi.json GET /v1/files/{file_id}","href":"/perceptron-mk1/api-reference/files/retrieve-a-file"},{"title":"Delete a file","openapi":"api-reference/openapi.json DELETE /v1/files/{file_id}","href":"/perceptron-mk1/api-reference/files/delete-a-file"},{"title":"Download a file's contents","openapi":"api-reference/openapi.json GET /v1/files/{file_id}/content","href":"/perceptron-mk1/api-reference/files/download-a-files-contents"}]},{"group":"Models","pages":[{"title":"List available models","openapi":"api-reference/openapi.json GET /v1/models","href":"/perceptron-mk1/api-reference/models/list-available-models"},{"title":"Retrieve a model","openapi":"api-reference/openapi.json GET /v1/models/{model_id}","href":"/perceptron-mk1/api-reference/models/retrieve-a-model"}]},{"group":"Services","pages":[{"group":"Detect","pages":[{"title":"Detect objects","openapi":"api-reference/openapi.json POST /v1/detect","href":"/perceptron-mk1/api-reference/services/detect-objects"}]},{"group":"Egocentric","pages":[{"title":"Submit an egocentric batch","openapi":"api-reference/openapi.json POST /v1/egocentric/batches","href":"/perceptron-mk1/api-reference/services/egocentric/submit-an-egocentric-batch"},{"title":"List egocentric batches","openapi":"api-reference/openapi.json GET /v1/egocentric/batches","href":"/perceptron-mk1/api-reference/services/egocentric/list-egocentric-batches"},{"title":"Retrieve an egocentric batch","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}","href":"/perceptron-mk1/api-reference/services/egocentric/retrieve-an-egocentric-batch"},{"title":"List jobs in an egocentric batch","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}/jobs","href":"/perceptron-mk1/api-reference/services/egocentric/list-jobs-in-an-egocentric-batch"},{"title":"List egocentric jobs","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs","href":"/perceptron-mk1/api-reference/services/egocentric/list-egocentric-jobs"},{"title":"Retrieve an egocentric job","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs/{job_id}","href":"/perceptron-mk1/api-reference/services/egocentric/retrieve-an-egocentric-job"},{"title":"Download an egocentric result","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs/{job_id}/result","href":"/perceptron-mk1/api-reference/services/egocentric/download-an-egocentric-result"}]}]}]}]}]},"basePath":"","title":"Retrieve an egocentric batch - Perceptron Docs","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}