This guide will help you understand requisitions and how to use them.
Access to requisitioning is disabled by default and most users don’t need it. You only need to use
requisitions if you’re manufacturing your own collection kits.
Requisitions let you use Spot’s infrastructure to handle logistics, compliance and results for kits built outside of
Spot. Supply us with the sample’s barcode, the patient’s registration data, and tracking information, and we’ll provide
you with tracking updates and results, as well as handling any logistical problems along the way.We’ll send you updates via webhook when a requisition is updated. Alternatively, poll our API regularly for
results.
Requisition lifecycle
Requisitions will always possess a created event and either an approved or denied event from the time of creation. If you don't supply tracking information, then the delivered and delivery_exception statuses will be skipped.
Status
Description
created
The initial event marking the creation of the requisition.
approved
The supplied patient has passed the exclusion check.
denied
The supplied patient has failed the exclusion check. This could be due to details like the patient’s age, sex, or location
delivered
Once the courier marks the sample as delivered to the lab, we mark the sample as delivered.
delivery_exception
If there’s an issue with shipping or the sample is lost in transit we mark the sample as having had a delivery exception.
received
Some of our lab partners provide us an accession notification to let us know they’ve received the sample. If they do, we communicate this with the received event.
extra_quality_checks
Occasionally we may need to perform extra checks after receiving a report from the lab. This status indicates there may be a short delay in results being available.
resulted
The lab has analyzed the sample and have released a report to us.
rejected
The sample was not suitable for analysis. This is most commonly due to not enough blood being provided, too much time passing since the sample was collected, or user error during collection.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Spot","colors":{"primary":"#7E63F8","light":"#DB6082","dark":"#462BBE"},"favicon":"/favicon.png","logo":{"light":"https://mintcdn.com/spot/5oSV-2vR4214gDZI/logo.svg?fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=c3babda7ad42176c58dfe4ea2137cd7c","dark":"https://mintcdn.com/spot/5oSV-2vR4214gDZI/logo.svg?fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=c3babda7ad42176c58dfe4ea2137cd7c"},"api":{"mdx":{"server":"https://app.spotdx.com"}},"background":{"image":"https://mintlify.s3.us-west-1.amazonaws.com/spot/background.png","decoration":null},"navbar":{"primary":{"type":"button","label":"Book a Call","href":"https://calendly.com/jajack/30minutes"}},"footer":{"socials":{"website":"https://spotdx.com/","linkedin":"https://www.linkedin.com/company/spotkits/"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spot","hasAudioNarration":false,"actualSubdomain":"spot","customDomains":["docs.spotdx.com"],"gitSource":{"type":"github","owner":"spothealth","repo":"public-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae9140f572e4ca5d52f8e04:success","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Documentation","count":20},{"language":"default","tag":"API Reference - Orders","count":4},{"language":"default","tag":"Welcome","count":3},{"language":"default","tag":"Basic Guides","count":3},{"language":"default","tag":"API Reference - Requisitions","count":3},{"language":"default","tag":"Advanced Guides","count":2},{"language":"default","tag":"API Reference - Registration","count":2},{"language":"default","tag":"API Reference - Kits","count":2},{"language":"default","tag":"Integrations","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"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":"editor-metadata","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},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"docs/requisitions","slug":"/docs/requisitions","pageMetadata":{"title":"Using requisitions","description":"This guide will help you understand requisitions and how to use them.","href":"/docs/requisitions"},"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: \"This guide will help you understand requisitions and how to use them.\"\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={code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Table,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:`Access to requisitioning is disabled by default and most users don’t need it. You only need to use\nrequisitions if you’re manufacturing your own collection kits.`}),`\n`,_jsx(_components.p,{children:`Requisitions let you use Spot’s infrastructure to handle logistics, compliance and results for kits built outside of\nSpot. Supply us with the sample’s barcode, the patient’s registration data, and tracking information, and we’ll provide\nyou with tracking updates and results, as well as handling any logistical problems along the way.`}),`\n`,_jsx(_components.p,{children:`We’ll send you updates via webhook when a requisition is updated. Alternatively, poll our API regularly for\nresults.`}),`\n`,_jsx(Heading,{level:`2`,id:`requisition-lifecycle`,children:`Requisition lifecycle`}),`\n`,_jsx(Frame,{caption:`Requisitions will always possess a created event and either an approved or denied event from the time of creation. If you don't supply tracking information, then the delivered and delivery_exception statuses will be skipped.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/spot/5oSV-2vR4214gDZI/img/requisition-lifecycle.png?fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=f9a1b56e2c3ba75a23c42cf0897a0125`,width:`450`,\"data-og-width\":`880`,\"data-og-height\":`992`,\"data-path\":`img/requisition-lifecycle.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/spot/5oSV-2vR4214gDZI/img/requisition-lifecycle.png?w=280\u0026fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=e14d1b150b991f615fff9d635d694e9d 280w, https://mintcdn.com/spot/5oSV-2vR4214gDZI/img/requisition-lifecycle.png?w=560\u0026fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=1dc3ac6add7855d0c3e08a46f08daf94 560w, https://mintcdn.com/spot/5oSV-2vR4214gDZI/img/requisition-lifecycle.png?w=840\u0026fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=3796fd0b7a524591121e5b3cdfec37e2 840w, https://mintcdn.com/spot/5oSV-2vR4214gDZI/img/requisition-lifecycle.png?w=1100\u0026fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=6d264fc6a37b2e8e3d7a7c8af35e299b 1100w, https://mintcdn.com/spot/5oSV-2vR4214gDZI/img/requisition-lifecycle.png?w=1650\u0026fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=c2e2233fff8ee6eee62a0378a175c900 1650w, https://mintcdn.com/spot/5oSV-2vR4214gDZI/img/requisition-lifecycle.png?w=2500\u0026fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=676ac1d9349f1c6675d15ff1b7ef6c40 2500w`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created`})}),_jsx(_components.td,{children:`The initial event marking the creation of the requisition.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`approved`})}),_jsx(_components.td,{children:`The supplied patient has passed the exclusion check.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`denied`})}),_jsx(_components.td,{children:`The supplied patient has failed the exclusion check. This could be due to details like the patient’s age, sex, or location`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`delivered`})}),_jsx(_components.td,{children:`Once the courier marks the sample as delivered to the lab, we mark the sample as delivered.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`delivery_exception`})}),_jsx(_components.td,{children:`If there’s an issue with shipping or the sample is lost in transit we mark the sample as having had a delivery exception.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`received`})}),_jsx(_components.td,{children:`Some of our lab partners provide us an accession notification to let us know they’ve received the sample. If they do, we communicate this with the received event.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`extra_quality_checks`})}),_jsx(_components.td,{children:`Occasionally we may need to perform extra checks after receiving a report from the lab. This status indicates there may be a short delay in results being available.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resulted`})}),_jsx(_components.td,{children:`The lab has analyzed the sample and have released a report to us.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rejected`})}),_jsx(_components.td,{children:`The sample was not suitable for analysis. This is most commonly due to not enough blood being provided, too much time passing since the sample was collected, or user error during collection.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Using requisitions","description":"This guide will help you understand requisitions and how to use them.","href":"/docs/requisitions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Requisition lifecycle","slug":"requisition-lifecycle","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"spot","siteName":"Spot","title":"Using requisitions - Spot","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T22:45:22.725Z","originalFileLocation":"docs/requisitions.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=\"This guide will help you understand requisitions and how to use them.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Spot\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spot/i35owai1mOdoGnQM/_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/spot/i35owai1mOdoGnQM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spot/i35owai1mOdoGnQM/_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/spot/i35owai1mOdoGnQM/_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/spot/i35owai1mOdoGnQM/_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/spot/i35owai1mOdoGnQM/_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/spot/i35owai1mOdoGnQM/_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/spot/i35owai1mOdoGnQM/_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/spot/i35owai1mOdoGnQM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Using requisitions - Spot\">\u003cmeta data-mint-head property=\"og:description\" content=\"This guide will help you understand requisitions and how to use them.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Spot\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spotdx.com/docs/requisitions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spot.mintlify.site/_mintlify/api/og/v2?division=Advanced+Guides\u0026amp;title=Using+requisitions\u0026amp;description=This+guide+will+help+you+understand+requisitions+and+how+to+use+them.\u0026amp;theme=e8009bcc0c7b5b333b57e6b4\u0026amp;signature=6ef38175d9a4f696974469f748e96077247a51368bf52ef5b18f2b55067ba218\">\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=\"Using requisitions - Spot\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This guide will help you understand requisitions and how to use them.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spot.mintlify.site/_mintlify/api/og/v2?division=Advanced+Guides\u0026amp;title=Using+requisitions\u0026amp;description=This+guide+will+help+you+understand+requisitions+and+how+to+use+them.\u0026amp;theme=e8009bcc0c7b5b333b57e6b4\u0026amp;signature=6ef38175d9a4f696974469f748e96077247a51368bf52ef5b18f2b55067ba218\">\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/spot/i35owai1mOdoGnQM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Spot\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7E63F8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spotdx.com/docs/requisitions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/requisitions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spotdx.com/#organization\",\"name\":\"Spot\",\"url\":\"https://docs.spotdx.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spot/5oSV-2vR4214gDZI/logo.svg?fit=max\u0026auto=format\u0026n=5oSV-2vR4214gDZI\u0026q=85\u0026s=c3babda7ad42176c58dfe4ea2137cd7c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spotdx.com#website\",\"name\":\"Spot\",\"url\":\"https://docs.spotdx.com\",\"publisher\":{\"@id\":\"https://docs.spotdx.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spotdx.com/docs/requisitions#webpage\",\"url\":\"https://docs.spotdx.com/docs/requisitions\",\"name\":\"Using requisitions\",\"description\":\"This guide will help you understand requisitions and how to use them.\",\"dateModified\":\"2026-01-06T22:45:22.725Z\",\"isPartOf\":{\"@id\":\"https://docs.spotdx.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spotdx.com/docs/requisitions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spotdx.com/docs/requisitions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Advanced Guides\",\"item\":\"https://docs.spotdx.com/docs/advanced-kit-workflows\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Using requisitions\",\"item\":\"https://docs.spotdx.com/docs/requisitions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.spotdx.com/docs/requisitions#article\",\"headline\":\"Using requisitions\",\"name\":\"Using requisitions\",\"description\":\"This guide will help you understand requisitions and how to use them.\",\"url\":\"https://docs.spotdx.com/docs/requisitions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spotdx.com/docs/requisitions#webpage\"},\"dateModified\":\"2026-01-06T22:45:22.725Z\",\"publisher\":{\"@id\":\"https://docs.spotdx.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spotdx.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Spot\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Spot\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/requisitions.md","siteName":"Spot","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Welcome","pages":[{"title":"Introduction","href":"/docs/introduction"},{"title":"Authentication","href":"/docs/authentication"},{"title":"Errors \u0026 status codes","href":"/docs/errors"}]},{"group":"Basic Guides","pages":[{"title":"Quickstart","href":"/docs/quickstart"},{"title":"Core concepts","href":"/docs/concepts"},{"title":"Order, sample \u0026 kit lifecycles","href":"/docs/sample-kit-lifecycle"}]},{"group":"Advanced Guides","pages":[{"title":"Advanced kit workflows","description":"Learn how events shape the life of a kit as it travels to the customer and then to the lab to be processed.","href":"/docs/advanced-kit-workflows"},{"title":"Using requisitions","href":"/docs/requisitions"}]},{"group":"Integrations","pages":[{"title":"Ecommerce Integrations","description":"Learn how to link your ecommerce store to your Spot account to automatically fulfil orders.","href":"/docs/integrations"}]},{"group":"API Reference - Orders","pages":[{"title":"Create order","openapi":"POST /api/v2/orders/","href":"/reference/create-order"},{"title":"List orders","openapi":"GET /api/v2/orders/","href":"/reference/list-orders"},{"title":"Get order by ID","openapi":"GET /api/v2/orders/{public_id}/","href":"/reference/get-order"},{"title":"Update order metadata","openapi":"POST /api/v2/orders/{public_id}/","href":"/reference/update-order-metadata"}]},{"group":"API Reference - Kits","pages":[{"title":"List kits","openapi":"GET /api/v2/kits/","href":"/reference/list-kits"},{"title":"Get kit by ID","openapi":"GET /api/v2/kits/{public_id}/","href":"/reference/get-kit"}]},{"group":"API Reference - Requisitions","pages":[{"title":"Create requisition","openapi":"POST /api/v2/requisitions/","href":"/reference/create-requisition"},{"title":"List requisitions","openapi":"GET /api/v2/requisitions/","href":"/reference/list-requisitions"},{"title":"Get requisition","openapi":"GET /api/v2/requisitions/{id}","href":"/reference/get-requisition"}]},{"group":"API Reference - Registration","pages":[{"title":"Create patient","openapi":"POST /api/v2/patients/","href":"/reference/create-patient"},{"title":"Generate registration token","openapi":"POST /api/v2/tokens/patient_registration/","href":"/reference/generate-registration-token"}]}]},{"anchor":"Get in Touch","href":"https://calendly.com/jajack/30minutes","icon":"phone"},{"anchor":"Contact Us","href":"mailto:hello@spotkits.com","icon":"envelope"}]},"basePath":"","title":"Using requisitions - Spot","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}