Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.
Partner API key. Send the raw key as the Authorization header value — e.g. dk_test_… in sandbox or dk_live_… in production. Generate and rotate keys in the doola Partner Portal.
Date the report was handed to doola's filing pipeline (yyyy-MM-dd). Null on a report that has only just been recorded; read status for where the report stands.
True when a report was already on file for this year and this one took its place, which is allowed only while the report is still FILLED.
Example:
false
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"doola Developers","description":"Build US company formation and compliance into your product with the doola Partner API, the embedded doola SDK, webhooks and the doola Formation MCP server.","colors":{"primary":"#276EF1","light":"#4F8FF6","dark":"#1E5ED8"},"logo":{"light":"https://mintcdn.com/doola/SFeoF_TYCRlE4Apz/logo/doola_logo_black.svg?fit=max\u0026auto=format\u0026n=SFeoF_TYCRlE4Apz\u0026q=85\u0026s=fdd4abb64b5833608e513ef10fa97314","dark":"https://mintcdn.com/doola/SFeoF_TYCRlE4Apz/logo/doola_logo.svg?fit=max\u0026auto=format\u0026n=SFeoF_TYCRlE4Apz\u0026q=85\u0026s=1ca0b509d4e07ac2f28422c4612aa121"},"favicon":"https://mintcdn.com/doola/YGCgGm1CbPVX-ivx/logo/favicon.ico?fit=max\u0026auto=format\u0026n=YGCgGm1CbPVX-ivx\u0026q=85\u0026s=3df3336ae81325012cdcf6719483eeb5","api":{"examples":{"languages":["curl","javascript","node","python","go","java","php"],"prefill":true}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"/api/openapi-spec","label":"OpenAPI spec"},{"href":"/api/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Get API access","href":"https://www.doola.com/partner-with-us/"}},"footer":{"socials":{"website":"https://www.doola.com"},"links":[{"header":"Partners","items":[{"label":"Partner Portal","href":"https://partners-portal.doola.com"},{"label":"Get API access","href":"https://www.doola.com/partner-with-us"}]},{"header":"Legal","items":[{"label":"Privacy policy","href":"https://www.doola.com/privacy-policy"},{"label":"Terms of service","href":"https://www.doola.com/terms-of-service"}]}]},"search":{"prompt":"Search the doola API docs"},"seo":{"organization":{"name":"doola","url":"https://www.doola.com"}},"fonts":{"family":"Inter"},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page moved or never existed. Start from the [introduction](/api/introduction), search the docs, or email [engineering@doola.com](mailto:engineering@doola.com)."}},"contextual":{"options":["copy","view","claude","chatgpt","download-spec",{"title":"Connect the doola MCP server","description":"Form a US LLC from your own AI client","icon":"plug","href":"https://docs.doola.com/mcp/connect"}],"display":"header"},"thumbnails":{"fonts":{"family":"Inter"}},"metadata":{"timestamp":true},"markdown":{"instructions":["Authenticate with the raw API key in the Authorization header. Never add a Bearer prefix.","Use the sandbox base URL https://api.test.doola.com and a dk_test_ key in examples unless the user asks for production.","Send an Idempotency-Key header on POST /v1/partner/customers and POST /v1/partner/companies. No other endpoint takes one.","Every response is wrapped as {payload, error}. Read fields from payload and branch on error.code, never on the message.","Drive formation progress from webhooks plus a reconciliation sweep, never a polling loop.","Embedded SDK (@doola/js): the dk_ key stays on the server and mints customer sessions; the browser gets only a pk_ key and the session. onFormed carries only companyId and can fire more than once. Before charging, read the company with the dk_ key, require formationSubmissionStatus AWAITING_PAYMENT, check the owner's email, and price on the server. Then POST payment-confirmed, which answers 200 with an empty body, and replace the SDK element with a new doola.create() (never append a second one).","The doola Formation MCP server at https://mcp.doola.com is for founders forming their own company with their own doola account. Partners integrate the Partner API or the Embedded SDK. The /mcp endpoint on this docs site only searches these docs.","For a full capability summary with the rules above, read https://docs.doola.com/skill.md."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"doola","hasAudioNarration":false,"actualSubdomain":"doola","customDomains":["docs.doola.com"],"gitSource":{"type":"github","owner":"doolahq","repo":"doola-data","deployBranch":"main","contentDirectory":"developer-docs","isPrivate":true,"mountPath":"","label":"","_id":"6adb9fb30954663ebe7b6469"},"chroma":{"liveDeploymentHistoryId":"6ae387b2f660141b8fd57caf","collectionId":"71791143-949f-40c8-aee1-9020fe631861","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae387b2f660141b8fd57caf"},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae387b2f660141b8fd57caf","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Partner API","count":51},{"language":"default","tag":"API reference","count":29},{"language":"default","tag":"Embedded SDK","count":18},{"language":"default","tag":"Core concepts","count":16},{"language":"default","tag":"Get started","count":9},{"language":"default","tag":"Reference","count":8},{"language":"default","tag":"MCP Server","count":7},{"language":"default","tag":"Required actions","count":6},{"language":"default","tag":"Annual Report Filing","count":6},{"language":"default","tag":"Company formation","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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":"byok-sep-25","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":"billing-updated-9-15","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/api-reference/annual-report-filing/submit-a-companys-annual-report","slug":"/api/api-reference/annual-report-filing/submit-a-companys-annual-report","pageMetadata":{"title":"Submit a company's annual report","description":"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/companies/{companyId}/compliance/annual-reports","href":"/api/api-reference/annual-report-filing/submit-a-companys-annual-report","autogeneratedByOpenApi":true},"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: \"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}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":"Submit a company's annual report","description":"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/companies/{companyId}/compliance/annual-reports","href":"/api/api-reference/annual-report-filing/submit-a-companys-annual-report","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Annual Report Filing"],"summary":"Submit a company's annual report","description":"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.","operationId":"submitAnnualReport","parameters":["5c67827d-7b9e-4ae5-8431-c34307922ff8"],"requestBody":"e665e30d-c895-490b-b75f-72bb0ba6d06d","responses":{"200":"11871caf-ee20-4ff5-be3d-81f07d9c79d6","201":"55c5117b-8ecc-468a-82e0-529d4d59d08e","400":"b5da4f68-47ba-4071-8717-867ab8b0235a","404":"3029fe0a-8c14-4825-a38e-1b8dc1bf4b63","409":"ac0d687a-298c-49f7-8050-fa11fa57aa10","422":"0fef6d55-eac2-4364-8cf3-eb3b546cf97c"},"method":"post","type":"path","servers":["2f7322d3-2f3c-419b-889e-fe6a49b0e7af","286fd81c-695c-4d97-939b-682164ac1a35"],"security":["0522888d-978c-44b8-a3d4-f4f3d1638ebc"],"path":"/v1/partner/companies/{companyId}/compliance/annual-reports","baseUrlOptions":["https://api.test.doola.com","https://api.doola.com"],"title":"Submit a company's annual report","codeSamples":[],"requestExampleLanguages":["bash","javascript","node","python","go","java","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.fiscalYear.oneOf.0":2026,"body.answers.oneOf.0.items.0.fieldId":"Q17","body.answers.oneOf.0.items.0.value":"1000000","body.companyDetails.oneOf.0.companyName.oneOf.0":"\u003cstring>","body.companyDetails.oneOf.0.address.oneOf.0.line1":"251 W 30th St","body.companyDetails.oneOf.0.address.oneOf.0.city":"New York","body.companyDetails.oneOf.0.address.oneOf.0.state":"NY","body.companyDetails.oneOf.0.address.oneOf.0.postalCode":"10001","body.companyDetails.oneOf.0.address.oneOf.0.country":"USA","body.companyDetails.oneOf.0.address.oneOf.0.line2":"Ste 12E","body.companyDetails.oneOf.0.address.oneOf.0.phone":"+12125550100","body.companyDetails.oneOf.0.mailingAddress.oneOf.0.line1":"251 W 30th St","body.companyDetails.oneOf.0.mailingAddress.oneOf.0.city":"New York","body.companyDetails.oneOf.0.mailingAddress.oneOf.0.state":"NY","body.companyDetails.oneOf.0.mailingAddress.oneOf.0.postalCode":"10001","body.companyDetails.oneOf.0.mailingAddress.oneOf.0.country":"USA","body.companyDetails.oneOf.0.mailingAddress.oneOf.0.line2":"Ste 12E","body.companyDetails.oneOf.0.mailingAddress.oneOf.0.phone":"+12125550100","body.companyDetails.oneOf.0.physicalAddress.oneOf.0.line1":"251 W 30th St","body.companyDetails.oneOf.0.physicalAddress.oneOf.0.city":"New York","body.companyDetails.oneOf.0.physicalAddress.oneOf.0.state":"NY","body.companyDetails.oneOf.0.physicalAddress.oneOf.0.postalCode":"10001","body.companyDetails.oneOf.0.physicalAddress.oneOf.0.country":"USA","body.companyDetails.oneOf.0.physicalAddress.oneOf.0.line2":"Ste 12E","body.companyDetails.oneOf.0.physicalAddress.oneOf.0.phone":"+12125550100","body.companyDetails.oneOf.0.phoneNumber.oneOf.0":"+13075550100","body.companyDetails.oneOf.0.authorizedShares.oneOf.0":10000000,"body.companyDetails.oneOf.0.issuedShares.oneOf.0":2500000,"body.companyDetails.oneOf.0.perValuedShares.oneOf.0":0.0001}]},"dependencies":{"parameters":{"5c67827d-7b9e-4ae5-8431-c34307922ff8":{"name":"companyId","in":"path","description":"doola company ID (KSUID).","required":true,"schema":{"type":"string","isRequired":true,"description":"doola company ID (KSUID).","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"An annual report to file, supplied whole.","properties":{"fiscalYear":{"oneOf":[{"type":"integer","format":"int32","description":"Fiscal year the report covers. Defaults to the current year when omitted.","example":2026,"maximum":2100,"minimum":2000,"uniqueKey":"fiscalYear.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","description":"Fiscal year the report covers. Defaults to the current year when omitted.","example":2026,"maximum":2100,"minimum":2000,"uniqueKey":"fiscalYear.oneOf.1","typeLabel":"null"}],"uniqueKey":"fiscalYear","typeLabel":"integer\u003cint32> | null"},"answers":{"oneOf":[{"type":"array","description":"One entry per question the requirements published. Omit for a state that asks none, which is most of them.","items":{"type":"object","description":"An answer to one of the fields the requirements published.","properties":{"fieldId":{"type":"string","description":"The field's fieldId from the requirements response, as published in fields[].fieldId.","example":"Q17","minLength":1,"isRequired":true,"uniqueKey":"answers.oneOf.0.items.[INDEX].fieldId","typeLabel":"string"},"value":{"type":"string","description":"The answer, as text. Typed against the field's own type before it is accepted.","example":"1000000","minLength":1,"isRequired":true,"uniqueKey":"answers.oneOf.0.items.[INDEX].value","typeLabel":"string"}},"required":["fieldId","value"],"uniqueKey":"answers.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"answers.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"One entry per question the requirements published. Omit for a state that asks none, which is most of them.","items":{"type":"object","description":"An answer to one of the fields the requirements published.","properties":{"fieldId":{"type":"string","description":"The field's fieldId from the requirements response, as published in fields[].fieldId.","example":"Q17","minLength":1},"value":{"type":"string","description":"The answer, as text. Typed against the field's own type before it is accepted.","example":"1000000","minLength":1}},"required":["fieldId","value"]},"uniqueKey":"answers.oneOf.1","typeLabel":"null"}],"uniqueKey":"answers","typeLabel":"object[] | null"},"companyDetails":{"oneOf":[{"type":"object","description":"Corrections to the company details doola holds. Omit when there are none.","properties":{"companyName":{"oneOf":[{"type":"string","description":"Company name as it should appear on the report.","uniqueKey":"companyDetails.oneOf.0.companyName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Company name as it should appear on the report.","uniqueKey":"companyDetails.oneOf.0.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails.oneOf.0.companyName","typeLabel":"string | null"},"address":{"oneOf":[{"type":"object","description":"Business address.","required":["city","country","line1","postalCode","state"],"properties":{"line1":{"type":"string","description":"Street address line 1.","example":"251 W 30th St","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.address.oneOf.0.line1","typeLabel":"string"},"city":{"type":"string","description":"City.","example":"New York","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.address.oneOf.0.city","typeLabel":"string"},"state":{"type":"string","description":"State or province.","example":"NY","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.address.oneOf.0.state","typeLabel":"string"},"postalCode":{"type":"string","description":"Postal or ZIP code.","example":"10001","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.address.oneOf.0.postalCode","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-3 country code (e.g. USA).","example":"USA","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.address.oneOf.0.country","typeLabel":"string"},"line2":{"type":"string","description":"Street address line 2.","example":"Ste 12E","uniqueKey":"companyDetails.oneOf.0.address.oneOf.0.line2","typeLabel":"string"},"phone":{"type":"string","description":"Phone number in E.164 format. Required for a person's address (the responsible party, a member, or an executive member); optional for a company `mailing` or `business` address.","example":"+12125550100","uniqueKey":"companyDetails.oneOf.0.address.oneOf.0.phone","typeLabel":"string"}},"uniqueKey":"companyDetails.oneOf.0.address.oneOf.0","typeLabel":"object"},{"type":"null","description":"Business address.","uniqueKey":"companyDetails.oneOf.0.address.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails.oneOf.0.address","typeLabel":"object | null"},"mailingAddress":{"oneOf":[{"type":"object","description":"Mailing address.","required":["city","country","line1","postalCode","state"],"properties":{"line1":{"type":"string","description":"Street address line 1.","example":"251 W 30th St","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.0.line1","typeLabel":"string"},"city":{"type":"string","description":"City.","example":"New York","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.0.city","typeLabel":"string"},"state":{"type":"string","description":"State or province.","example":"NY","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.0.state","typeLabel":"string"},"postalCode":{"type":"string","description":"Postal or ZIP code.","example":"10001","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.0.postalCode","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-3 country code (e.g. USA).","example":"USA","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.0.country","typeLabel":"string"},"line2":{"type":"string","description":"Street address line 2.","example":"Ste 12E","uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.0.line2","typeLabel":"string"},"phone":{"type":"string","description":"Phone number in E.164 format. Required for a person's address (the responsible party, a member, or an executive member); optional for a company `mailing` or `business` address.","example":"+12125550100","uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.0.phone","typeLabel":"string"}},"uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.0","typeLabel":"object"},{"type":"null","description":"Mailing address.","uniqueKey":"companyDetails.oneOf.0.mailingAddress.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails.oneOf.0.mailingAddress","typeLabel":"object | null"},"physicalAddress":{"oneOf":[{"type":"object","description":"Physical address. Required for a Delaware C-corp, which doola does not hold one for.","required":["city","country","line1","postalCode","state"],"properties":{"line1":{"type":"string","description":"Street address line 1.","example":"251 W 30th St","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.0.line1","typeLabel":"string"},"city":{"type":"string","description":"City.","example":"New York","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.0.city","typeLabel":"string"},"state":{"type":"string","description":"State or province.","example":"NY","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.0.state","typeLabel":"string"},"postalCode":{"type":"string","description":"Postal or ZIP code.","example":"10001","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.0.postalCode","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-3 country code (e.g. USA).","example":"USA","isRequired":true,"uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.0.country","typeLabel":"string"},"line2":{"type":"string","description":"Street address line 2.","example":"Ste 12E","uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.0.line2","typeLabel":"string"},"phone":{"type":"string","description":"Phone number in E.164 format. Required for a person's address (the responsible party, a member, or an executive member); optional for a company `mailing` or `business` address.","example":"+12125550100","uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.0.phone","typeLabel":"string"}},"uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.0","typeLabel":"object"},{"type":"null","description":"Physical address. Required for a Delaware C-corp, which doola does not hold one for.","uniqueKey":"companyDetails.oneOf.0.physicalAddress.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails.oneOf.0.physicalAddress","typeLabel":"object | null"},"phoneNumber":{"oneOf":[{"type":"string","description":"Phone number. Required for a Delaware C-corp, which doola does not hold one for.","example":"+13075550100","uniqueKey":"companyDetails.oneOf.0.phoneNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number. Required for a Delaware C-corp, which doola does not hold one for.","example":"+13075550100","uniqueKey":"companyDetails.oneOf.0.phoneNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails.oneOf.0.phoneNumber","typeLabel":"string | null"},"authorizedShares":{"oneOf":[{"type":"number","description":"Authorized shares. A whole number.","example":10000000,"uniqueKey":"companyDetails.oneOf.0.authorizedShares.oneOf.0","typeLabel":"number"},{"type":"null","description":"Authorized shares. A whole number.","example":10000000,"uniqueKey":"companyDetails.oneOf.0.authorizedShares.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails.oneOf.0.authorizedShares","typeLabel":"number | null"},"issuedShares":{"oneOf":[{"type":"number","description":"Issued shares. A whole number.","example":2500000,"uniqueKey":"companyDetails.oneOf.0.issuedShares.oneOf.0","typeLabel":"number"},{"type":"null","description":"Issued shares. A whole number.","example":2500000,"uniqueKey":"companyDetails.oneOf.0.issuedShares.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails.oneOf.0.issuedShares","typeLabel":"number | null"},"perValuedShares":{"oneOf":[{"type":"number","description":"Par value per share, in USD.","example":0.0001,"uniqueKey":"companyDetails.oneOf.0.perValuedShares.oneOf.0","typeLabel":"number"},{"type":"null","description":"Par value per share, in USD.","example":0.0001,"uniqueKey":"companyDetails.oneOf.0.perValuedShares.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails.oneOf.0.perValuedShares","typeLabel":"number | null"}},"uniqueKey":"companyDetails.oneOf.0","typeLabel":"object"},{"type":"null","description":"Corrections to the company details doola holds. Omit when there are none.","uniqueKey":"companyDetails.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyDetails","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"fiscalYear":2026,"answers":[{"fieldId":"Q17","value":"1000000"}],"companyDetails":{"companyName":"\u003cstring>","address":{"line1":"251 W 30th St","city":"New York","state":"NY","postalCode":"10001","country":"USA","line2":"Ste 12E","phone":"+12125550100"},"mailingAddress":{"line1":"251 W 30th St","city":"New York","state":"NY","postalCode":"10001","country":"USA","line2":"Ste 12E","phone":"+12125550100"},"physicalAddress":{"line1":"251 W 30th St","city":"New York","state":"NY","postalCode":"10001","country":"USA","line2":"Ste 12E","phone":"+12125550100"},"phoneNumber":"+13075550100","authorizedShares":10000000,"issuedShares":2500000,"perValuedShares":0.0001}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"11871caf-ee20-4ff5-be3d-81f07d9c79d6":{"description":"The report is on file and replaced an unconfirmed one for the same fiscal year; same annualReportId, isReplaced true.","content":{"*/*":{"schema":{"type":"object","description":"An annual report on record.","properties":{"annualReportId":{"type":"string","description":"Annual report ID (KSUID). Keep it: confirm and the status reads address the report by it.","example":"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ","uniqueKey":"annualReportId","typeLabel":"string"},"doolaCompanyId":{"type":"string","description":"doola company ID (KSUID).","example":"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ","uniqueKey":"doolaCompanyId","typeLabel":"string"},"fiscalYear":{"type":"integer","format":"int32","description":"Fiscal year the report covers.","example":2026,"uniqueKey":"fiscalYear","typeLabel":"integer\u003cint32>"},"state":{"type":"string","description":"US state the report is filed in.","example":"WY","uniqueKey":"state","typeLabel":"string"},"entityType":{"type":"string","description":"Entity type the report was filed for.","enum":["LLC","CCorp"],"example":"LLC","uniqueKey":"entityType","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"Where the report stands.","enum":["FILLED","IN_PROGRESS","AWAITING_INFORMATION","FILING_COMPLETED"],"example":"FILLED","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"priceInCents":{"type":"integer","format":"int64","description":"The state fee for this report in whole US cents, fixed when it was recorded. Nothing is charged through this API. 0 where the state charges nothing.","example":6225,"uniqueKey":"priceInCents","typeLabel":"integer\u003cint64>"},"submittedAt":{"oneOf":[{"type":"string","description":"Date the report was handed to doola's filing pipeline (yyyy-MM-dd). Null on a report that has only just been recorded; read status for where the report stands.","example":"2026-03-01","uniqueKey":"submittedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"Date the report was handed to doola's filing pipeline (yyyy-MM-dd). Null on a report that has only just been recorded; read status for where the report stands.","example":"2026-03-01","uniqueKey":"submittedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"submittedAt","typeLabel":"string | null"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the report was first recorded. Null if the row carries no timestamp.","example":"2026-02-01T09:00:00Z","uniqueKey":"createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the report was first recorded. Null if the row carries no timestamp.","example":"2026-02-01T09:00:00Z","uniqueKey":"createdAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time> | null"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the report last changed. Null if the row carries no timestamp.","example":"2026-02-02T09:00:00Z","uniqueKey":"updatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the report last changed. Null if the row carries no timestamp.","example":"2026-02-02T09:00:00Z","uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time> | null"},"answers":{"type":"array","description":"The answers on record, addressed by the field ids the requirements published. Empty for a state that asks no questions, which is most of them.","items":{"type":"object","description":"One answer on record for an annual report.","properties":{"fieldId":{"type":"string","description":"Field id, as published by the requirements endpoint's fields[].fieldId. An answer stays on record under it after doola stops asking that question, so it may name a field the requirements no longer publish.","example":"Q17","uniqueKey":"answers.items.[INDEX].fieldId","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"What was answered, as given.","example":"1000000","uniqueKey":"answers.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","description":"What was answered, as given.","example":"1000000","uniqueKey":"answers.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"answers.items.[INDEX].value","typeLabel":"string | null"}},"uniqueKey":"answers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"answers","typeLabel":"object[]"},"isReplaced":{"type":"boolean","description":"True when a report was already on file for this year and this one took its place, which is allowed only while the report is still FILLED.","example":false,"uniqueKey":"isReplaced","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"annualReportId":"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ","doolaCompanyId":"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ","fiscalYear":2026,"state":"WY","entityType":"LLC","status":"FILLED","priceInCents":6225,"submittedAt":"2026-03-01","createdAt":"2026-02-01T09:00:00Z","updatedAt":"2026-02-02T09:00:00Z","answers":[{"fieldId":"Q17","value":"1000000"}],"isReplaced":false}}},"exampleType":"generated"}},"exampleType":"generated"},"55c5117b-8ecc-468a-82e0-529d4d59d08e":{"description":"The report is on file, newly created for this fiscal year.","content":{"*/*":{"schema":{"type":"object","description":"An annual report on record.","properties":{"annualReportId":{"type":"string","description":"Annual report ID (KSUID). Keep it: confirm and the status reads address the report by it.","example":"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ","uniqueKey":"annualReportId","typeLabel":"string"},"doolaCompanyId":{"type":"string","description":"doola company ID (KSUID).","example":"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ","uniqueKey":"doolaCompanyId","typeLabel":"string"},"fiscalYear":{"type":"integer","format":"int32","description":"Fiscal year the report covers.","example":2026,"uniqueKey":"fiscalYear","typeLabel":"integer\u003cint32>"},"state":{"type":"string","description":"US state the report is filed in.","example":"WY","uniqueKey":"state","typeLabel":"string"},"entityType":{"type":"string","description":"Entity type the report was filed for.","enum":["LLC","CCorp"],"example":"LLC","uniqueKey":"entityType","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"Where the report stands.","enum":["FILLED","IN_PROGRESS","AWAITING_INFORMATION","FILING_COMPLETED"],"example":"FILLED","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"priceInCents":{"type":"integer","format":"int64","description":"The state fee for this report in whole US cents, fixed when it was recorded. Nothing is charged through this API. 0 where the state charges nothing.","example":6225,"uniqueKey":"priceInCents","typeLabel":"integer\u003cint64>"},"submittedAt":{"oneOf":[{"type":"string","description":"Date the report was handed to doola's filing pipeline (yyyy-MM-dd). Null on a report that has only just been recorded; read status for where the report stands.","example":"2026-03-01","uniqueKey":"submittedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"Date the report was handed to doola's filing pipeline (yyyy-MM-dd). Null on a report that has only just been recorded; read status for where the report stands.","example":"2026-03-01","uniqueKey":"submittedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"submittedAt","typeLabel":"string | null"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the report was first recorded. Null if the row carries no timestamp.","example":"2026-02-01T09:00:00Z","uniqueKey":"createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the report was first recorded. Null if the row carries no timestamp.","example":"2026-02-01T09:00:00Z","uniqueKey":"createdAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time> | null"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the report last changed. Null if the row carries no timestamp.","example":"2026-02-02T09:00:00Z","uniqueKey":"updatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the report last changed. Null if the row carries no timestamp.","example":"2026-02-02T09:00:00Z","uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time> | null"},"answers":{"type":"array","description":"The answers on record, addressed by the field ids the requirements published. Empty for a state that asks no questions, which is most of them.","items":{"type":"object","description":"One answer on record for an annual report.","properties":{"fieldId":{"type":"string","description":"Field id, as published by the requirements endpoint's fields[].fieldId. An answer stays on record under it after doola stops asking that question, so it may name a field the requirements no longer publish.","example":"Q17","uniqueKey":"answers.items.[INDEX].fieldId","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"What was answered, as given.","example":"1000000","uniqueKey":"answers.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","description":"What was answered, as given.","example":"1000000","uniqueKey":"answers.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"answers.items.[INDEX].value","typeLabel":"string | null"}},"uniqueKey":"answers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"answers","typeLabel":"object[]"},"isReplaced":{"type":"boolean","description":"True when a report was already on file for this year and this one took its place, which is allowed only while the report is still FILLED.","example":false,"uniqueKey":"isReplaced","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"annualReportId":"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ","doolaCompanyId":"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ","fiscalYear":2026,"state":"WY","entityType":"LLC","status":"FILLED","priceInCents":6225,"submittedAt":"2026-03-01","createdAt":"2026-02-01T09:00:00Z","updatedAt":"2026-02-02T09:00:00Z","answers":[{"fieldId":"Q17","value":"1000000"}],"isReplaced":false}}},"exampleType":"generated"}},"exampleType":"generated"},"b5da4f68-47ba-4071-8717-867ab8b0235a":{"description":"E_VALIDATION_FAILED: an answer or a correction was not one this company was offered, was missing, or was not the kind of value its field asks for. The refused field is reported under error.fields, keyed by its fieldId.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"3029fe0a-8c14-4825-a38e-1b8dc1bf4b63":{"description":"E_COMPANY_NOT_FOUND: the company does not exist, or is not owned by the calling partner.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"ac0d687a-298c-49f7-8050-fa11fa57aa10":{"description":"E_ANNUAL_REPORT_ALREADY_EXISTS: a report is on file for this company and fiscal year that must not be overwritten, because it has been confirmed, filed, or is being worked on.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"0fef6d55-eac2-4364-8cf3-eb3b546cf97c":{"description":"E_STATE_NOT_SUPPORTED: the company's state files no annual report, so there is nothing to submit.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"0522888d-978c-44b8-a3d4-f4f3d1638ebc":{"PartnerApiKey":{"type":"apiKey","description":"Partner API key. Send the raw key as the `Authorization` header value — e.g. `dk_test_…` in sandbox or `dk_live_…` in production. Generate and rotate keys in the doola Partner Portal.","name":"Authorization","in":"header","scopes":[],"schemeName":"PartnerApiKey"}}},"servers":{"2f7322d3-2f3c-419b-889e-fe6a49b0e7af":{"url":"https://api.test.doola.com","description":"Sandbox — use test keys (dk_test_…)"},"286fd81c-695c-4d97-939b-682164ac1a35":{"url":"https://api.doola.com","description":"Production — use live keys (dk_live_…)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Partner API key. Send the raw key as the `Authorization` header value — e.g. `dk_test_…` in sandbox or `dk_live_…` in production. Generate and rotate keys in the doola Partner Portal.","name":"Authorization","in":"header","scopes":[],"schemeName":"PartnerApiKey"},"schema":{"title":"Authorization","type":"string","description":"Partner API key. Send the raw key as the `Authorization` header value — e.g. `dk_test_…` in sandbox or `dk_live_…` in production. Generate and rotate keys in the doola Partner Portal.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"PartnerApiKey","name":"Authorization"}],"title":"PartnerApiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"doola","siteName":"doola Developers","title":"Submit a company's annual report - doola Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api/api-reference/annual-report-filing/submit-a-companys-annual-report.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=\"dark\"}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=\"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.\">\u003cmeta data-mint-head name=\"application-name\" content=\"doola Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/doola/CgqtkROOt5ypSrSx/_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/doola/CgqtkROOt5ypSrSx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/doola/CgqtkROOt5ypSrSx/_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/doola/CgqtkROOt5ypSrSx/_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/doola/CgqtkROOt5ypSrSx/_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/doola/CgqtkROOt5ypSrSx/_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/doola/CgqtkROOt5ypSrSx/_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/doola/CgqtkROOt5ypSrSx/_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/doola/CgqtkROOt5ypSrSx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Submit a company\u0026#x27;s annual report - doola Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"doola Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://doola.mintlify.app/_mintlify/api/og/v2?division=Annual+Report+Filing\u0026amp;title=Submit+a+company%27s+annual+report\u0026amp;description=Records+the+annual+report+in+one+call.+Send+the+answers+to+every+field+%2Frequirements+published+for+the+company%2C+and+only+those+-+a+field+it+was+not+offered+is+r\u0026amp;theme=d4e17b9ecf13deadca62a6e7\u0026amp;signature=cdc34ac1aaa6042a74acf300a5684d599630626204fd6e40ca19ad6f6c83b14d\">\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=\"Submit a company\u0026#x27;s annual report - doola Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://doola.mintlify.app/_mintlify/api/og/v2?division=Annual+Report+Filing\u0026amp;title=Submit+a+company%27s+annual+report\u0026amp;description=Records+the+annual+report+in+one+call.+Send+the+answers+to+every+field+%2Frequirements+published+for+the+company%2C+and+only+those+-+a+field+it+was+not+offered+is+r\u0026amp;theme=d4e17b9ecf13deadca62a6e7\u0026amp;signature=cdc34ac1aaa6042a74acf300a5684d599630626204fd6e40ca19ad6f6c83b14d\">\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/doola/CgqtkROOt5ypSrSx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"doola Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#276EF1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/api-reference/annual-report-filing/submit-a-companys-annual-report.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.doola.com/#organization\",\"name\":\"doola\",\"url\":\"https://www.doola.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/doola/SFeoF_TYCRlE4Apz/logo/doola_logo_black.svg?fit=max\u0026auto=format\u0026n=SFeoF_TYCRlE4Apz\u0026q=85\u0026s=fdd4abb64b5833608e513ef10fa97314\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.doola.com#website\",\"name\":\"doola Developers\",\"url\":\"https://docs.doola.com\",\"publisher\":{\"@id\":\"https://www.doola.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report#webpage\",\"url\":\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report\",\"name\":\"Submit a company's annual report\",\"description\":\"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.\",\"isPartOf\":{\"@id\":\"https://docs.doola.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.doola.com/api/api-reference/playground-sandbox-only/complete-formation-sandbox\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Annual Report Filing\",\"item\":\"https://docs.doola.com/api/api-reference/annual-report-filing/list-a-companys-annual-reports\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Submit a company's annual report\",\"item\":\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report#apireference\",\"headline\":\"Submit a company's annual report\",\"name\":\"Submit a company's annual report\",\"description\":\"Records the annual report in one call. Send the answers to every field /requirements published for the company, and only those - a field it was not offered is refused rather than ignored. This does not start the filing: the report rests at FILLED until you call /confirm, and waits there indefinitely. A report already on file for the year is replaced while it is still unconfirmed, and answers 409 once it is being worked on.\",\"url\":\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report\",\"mainEntityOfPage\":{\"@id\":\"https://docs.doola.com/api/api-reference/annual-report-filing/submit-a-companys-annual-report#webpage\"},\"publisher\":{\"@id\":\"https://www.doola.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.doola.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"doola Developers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"doola Developers","nav":{"global":null,"dropdowns":[{"dropdown":"Partner API","icon":"plug","groups":[{"group":"Get started","pages":[{"title":"doola Partner API","href":"/api/introduction"},{"title":"Authentication","href":"/api/authentication"}]},{"group":"Core concepts","pages":[{"group":"Company formation","expanded":true,"pages":[{"title":"Company formation","href":"/api/formation"},{"title":"SS-4 and Form 8821 signing","href":"/api/non-us-formation"},{"title":"Expedited EIN","href":"/api/expedited-ein"},{"title":"Choosing an industry","href":"/api/naics-industry"}]},{"title":"Company services","href":"/api/company-services"},{"title":"Compliance Calendar","href":"/api/compliance/calendar"},{"title":"Annual Report Filing","href":"/api/compliance/annual-report-filing"},{"title":"Webhooks","href":"/api/webhooks"},{"group":"Required actions","pages":[{"title":"Required actions","href":"/api/required-actions"},{"title":"New company names needed","href":"/api/required-actions/name-options"},{"title":"SS-4 signature needed again","href":"/api/required-actions/ss4-reset"},{"title":"Form 8821 signature needed","href":"/api/required-actions/form8821-required"},{"title":"Founder address needed","href":"/api/required-actions/founder-address"},{"title":"Annual report correction","href":"/api/required-actions/annual-report-correction"}]},{"title":"Sandbox playground","href":"/api/sandbox-playground"},{"title":"Errors","href":"/api/errors"}]},{"group":"Reference","pages":[{"title":"Domain objects","href":"/api/domain-objects"},{"title":"OpenAPI specification","href":"/api/openapi-spec"}]},{"group":"API reference","pages":[{"group":"Playground (sandbox only)","pages":[{"title":"Complete Formation (sandbox)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/playground/companies/{companyId}/formation/complete","href":"/api/api-reference/playground-sandbox-only/complete-formation-sandbox"},{"title":"Complete EIN creation (sandbox)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/playground/companies/{companyId}/eincreation/complete","href":"/api/api-reference/playground-sandbox-only/complete-ein-creation-sandbox"}]},{"group":"Customers","pages":[{"title":"List customers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/customers","href":"/api/api-reference/customers/list-customers"},{"title":"Create a customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/customers","href":"/api/api-reference/customers/create-a-customer"},{"title":"Get a customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/customers/{customerId}","href":"/api/api-reference/customers/get-a-customer"}]},{"group":"Customer sessions","pages":[{"title":"Create a customer session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/customer-sessions","href":"/api/api-reference/customer-sessions/create-a-customer-session"}]},{"group":"Companies","pages":[{"title":"List companies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies","href":"/api/api-reference/companies/list-companies"},{"title":"Create a company","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/companies","href":"/api/api-reference/companies/create-a-company"},{"title":"Confirm payment for a draft formation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/companies/{companyId}/payment-confirmed","href":"/api/api-reference/companies/confirm-payment-for-a-draft-formation"},{"title":"Get a company","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{companyId}","href":"/api/api-reference/companies/get-a-company"}]},{"group":"Signatures","pages":[{"title":"Create a signature session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/companies/{companyId}/signatures","href":"/api/api-reference/signatures/create-a-signature-session"}]},{"group":"Required Actions","pages":[{"title":"Resolve a required action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/companies/{companyId}/required-actions/{requiredActionId}/resolution","href":"/api/api-reference/required-actions/resolve-a-required-action"},{"title":"List open required actions across your companies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/required-actions","href":"/api/api-reference/required-actions/list-open-required-actions-across-your-companies"},{"title":"List a company's required actions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{companyId}/required-actions","href":"/api/api-reference/required-actions/list-a-companys-required-actions"},{"title":"Retrieve a required action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{companyId}/required-actions/{requiredActionId}","href":"/api/api-reference/required-actions/retrieve-a-required-action"}]},{"group":"Annual Report Filing","pages":[{"title":"List a company's annual reports","description":"The company's annual reports, one per fiscal year, newest first, each with where it stands and the price fixed on it. Read-only. A report in a state this API does not publish is left out, so the list can be shorter than what doola holds. An empty list means nothing to show; a company that does not exist or is not yours is 404.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{companyId}/compliance/annual-reports","href":"/api/api-reference/annual-report-filing/list-a-companys-annual-reports"},{"title":"Submit a company's annual report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/companies/{companyId}/compliance/annual-reports","href":"/api/api-reference/annual-report-filing/submit-a-companys-annual-report"},{"title":"Confirm an annual report and hand it to doola to file","description":"Hands the report to doola to file and starts the work. **Call this for every report, including one whose `priceInCents` is 0**: a state that charges nothing still has a report to file, and confirming is what starts the work. Until you do, the report stays at FILLED and nothing happens to it. Call it on your own timing — an unconfirmed report waits indefinitely. Nothing is charged here and no card is debited: the `priceInCents` fixed at submission is the state fee doola settles with you under your partner agreement, outside this API. Safe to repeat: a report already confirmed is returned unchanged and is never handed over twice.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/partner/companies/{companyId}/compliance/annual-reports/{annualReportId}/confirm","href":"/api/api-reference/annual-report-filing/confirm-an-annual-report-and-hand-it-to-doola-to-file"},{"title":"Get one annual report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{companyId}/compliance/annual-reports/{annualReportId}","href":"/api/api-reference/annual-report-filing/get-one-annual-report"},{"title":"Get the state fee for a company's annual report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{companyId}/compliance/annual-reports/state-fees","href":"/api/api-reference/annual-report-filing/get-the-state-fee-for-a-companys-annual-report"},{"title":"Get the annual report requirements for a company","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{companyId}/compliance/annual-reports/requirements","href":"/api/api-reference/annual-report-filing/get-the-annual-report-requirements-for-a-company"}]},{"group":"SDK","pages":[{"title":"Get your publishable key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/sdk/keys","href":"/api/api-reference/sdk/get-your-publishable-key"}]},{"group":"Reference data","pages":[{"title":"List states","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/references/states","href":"/api/api-reference/reference-data/list-states"},{"title":"List state filing fees","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/references/state-fees","href":"/api/api-reference/reference-data/list-state-filing-fees"},{"title":"List NAICS codes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/references/naics-codes","href":"/api/api-reference/reference-data/list-naics-codes"},{"title":"List countries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/references/countries","href":"/api/api-reference/reference-data/list-countries"}]},{"group":"Documents","pages":[{"title":"List company documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{doolaCompanyId}/documents","href":"/api/api-reference/documents/list-company-documents"},{"title":"Get a document download URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{doolaCompanyId}/documents/{documentId}","href":"/api/api-reference/documents/get-a-document-download-url"}]},{"group":"Compliance","pages":[{"title":"Get a company's compliance calendar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/partner/companies/{companyId}/compliance/calendar","href":"/api/api-reference/compliance/get-a-companys-compliance-calendar"}]}]},{"group":"Help","pages":[{"title":"FAQ","href":"/api/faq"}]},{"group":"Updates","pages":[{"title":"Changelog","href":"/api/changelog"}]}]},{"dropdown":"Embedded SDK","icon":"window-maximize","groups":[{"group":"Get started","pages":[{"title":"doola Embedded SDK","sidebarTitle":"Overview","href":"/sdk/overview"},{"title":"Quickstart","href":"/sdk/quickstart"},{"title":"How it works","href":"/sdk/how-it-works"},{"title":"Customer experience","href":"/sdk/customer-experience"}]},{"group":"Integrate","pages":[{"title":"Create sessions","href":"/sdk/sessions"},{"title":"Embed the SDK","href":"/sdk/embed"},{"title":"Take payment","href":"/sdk/payments"},{"title":"After payment","href":"/sdk/after-payment"}]},{"group":"Customize","pages":[{"title":"Branding","href":"/sdk/branding"},{"title":"Presentation and mobile","href":"/sdk/presentation"}]},{"group":"Test and launch","pages":[{"title":"Testing","href":"/sdk/testing"},{"title":"Go-live checklist","href":"/sdk/go-live"}]},{"group":"Reference","pages":[{"title":"Client reference","href":"/sdk/reference/client"},{"title":"Server reference","href":"/sdk/reference/server"},{"title":"Errors","href":"/sdk/reference/errors"},{"title":"Security and data","href":"/sdk/security"}]},{"group":"Help","pages":[{"title":"FAQ","href":"/sdk/faq"},{"title":"Changelog","href":"/sdk/changelog"}]}]},{"dropdown":"MCP Server","icon":"robot","groups":[{"group":"Get started","pages":[{"title":"doola Formation MCP Server","href":"/mcp/introduction"},{"title":"Connect a client","href":"/mcp/connect"},{"title":"Authentication","href":"/mcp/authentication"}]},{"group":"Tools","pages":[{"title":"Tools reference","href":"/mcp/tools"},{"title":"End-to-end flow","href":"/mcp/flow"}]},{"group":"Reference","pages":[{"title":"Errors","href":"/mcp/errors"},{"title":"Limitations","href":"/mcp/limitations"}]}]}]},"basePath":"","title":"Submit a company's annual report - doola Developers","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}