--- updatedAt: 2026-10-13T21:16:16.000Z agentTools: projectIndex: https://docs.usestable.com/llms.txt --- # Place a filing Places a filing and charges for it. Retrying with the same Idempotency-Key and the same body returns the original filing instead of placing a second one. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Stable API", "version": "1" }, "paths": { "/v1/companies/{id}/jurisdictions/{jurisdiction}/filings": { "post": { "summary": "Place a filing", "description": "Places a filing and charges for it. Retrying with the same Idempotency-Key and the same body returns the original filing instead of placing a second one.", "tags": [ "Filings" ], "operationId": "createFiling.post.v1/companies/{id}/jurisdictions/{jurisdiction}/filings", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "The company, from the companies list.", "schema": { "type": "string" } }, { "name": "jurisdiction", "in": "path", "required": true, "description": "Two-letter uppercase state code, such as `DE`.", "schema": { "type": "string" } }, { "in": "header", "name": "idempotency-key", "required": true, "description": "Your own key for this filing, 1 to 128 letters, digits, hyphens or underscores.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateFilingRequestBody" } } }, "description": "Body required in the request", "required": true }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Filing" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilingBadRequestError" } } } }, "402": { "description": "Payment was declined. Nothing was filed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilingPaymentRequiredError" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Forbidden" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilingNotFoundError" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilingConflictError" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InternalError" } } } } }, "security": [ { "x-api-key": [] } ] } } }, "servers": [ { "url": "https://api.usestable.com", "description": "Production" }, { "url": "https://api.dev.usestable.com", "description": "Development" } ], "components": { "securitySchemes": { "x-api-key": { "type": "apiKey", "name": "x-api-key", "in": "header" } }, "schemas": { "FilingStatus": { "enum": [ "inProgress", "complete", "cancelled" ], "title": "FilingStatus", "type": "string" }, "FilingSpeed": { "enum": [ "standard", "expedited", "rush" ], "title": "FilingSpeed", "type": "string" }, "FilingType": { "enum": [ "amendment", "beneficial-ownership-information-report", "certificate-of-good-standing", "certified-copy", "change-registered-agent", "compliance", "dissolve-a-company", "dissolve-a-company-long-form", "ein-tax-id", "form-a-company", "initial-report", "plain-copy", "register-a-company", "registered-agent-resignation", "s-corp", "trade-name", "withdraw-a-company" ], "title": "FilingType", "type": "string" }, "Filing": { "properties": { "id": { "title": "Filing.id", "description": "The filing's ID.", "type": "string", "example": "6c4d7272-7390-4b38-8c9f-fecedfc33d3c" }, "name": { "title": "Filing.name", "description": "The filing's display name.", "type": "string", "example": "Delaware Form a Company Filing" }, "status": { "title": "Filing.status", "description": "One of `inProgress`, `complete` or `cancelled`.", "example": "inProgress", "allOf": [ { "$ref": "#/components/schemas/FilingStatus" } ] }, "jurisdiction": { "title": "Filing.jurisdiction", "description": "Two-letter uppercase state code for the jurisdiction the filing was placed in. Always present,\nand `null` when the filing has no jurisdiction.", "type": "string", "example": "DE" }, "createdAt": { "title": "Filing.createdAt", "description": "When the filing was placed, as an ISO 8601 timestamp in UTC.", "type": "string", "example": "2026-09-16T18:10:51.350Z" } }, "required": [ "id", "name", "status", "createdAt" ], "additionalProperties": false, "title": "Filing", "type": "object" }, "CreateFilingRequestBody": { "properties": { "filingType": { "title": "CreateFilingRequestBody.filingType", "description": "The filing to place. Get the filing types available for this company in this jurisdiction\nfrom the filing types endpoint.", "example": "form-a-company", "allOf": [ { "$ref": "#/components/schemas/FilingType" } ] }, "filingSpeed": { "title": "CreateFilingRequestBody.filingSpeed", "description": "The speed tier to place the filing at, from the filing speeds list for this filing. Ordering a\nfiling at a speed that is not offered results in a 404.", "example": "standard", "allOf": [ { "$ref": "#/components/schemas/FilingSpeed" } ] }, "filingContact": { "properties": { "email": { "title": "CreateFilingRequestBody.filingContact.email", "type": "string" } }, "required": [ "email" ], "additionalProperties": false, "title": "CreateFilingRequestBody.filingContact", "description": "The person Stable should contact if there's a problem with this filing.", "type": "object" }, "values": { "title": "CreateFilingRequestBody.values", "description": "The values for this filing's fields, keyed by each field's `key`. For an `object` field, send\na nested object with the same shape. The filing speed endpoint lists the fields.", "type": "object" } }, "required": [ "filingType", "filingSpeed", "filingContact", "values" ], "additionalProperties": false, "title": "CreateFilingRequestBody", "type": "object" }, "Forbidden": { "properties": { "message": { "title": "Forbidden.message", "enum": [ "Forbidden" ], "type": "string" } }, "required": [ "message" ], "additionalProperties": false, "title": "Forbidden", "type": "object" }, "FilingBadRequestCode": { "enum": [ "VALIDATION_ERROR", "IDEMPOTENCY_KEY_REQUIRED", "MISSING_ENTITY_INFORMATION", "NO_REGISTERED_AGENT" ], "title": "FilingBadRequestCode", "type": "string" }, "FilingNotFoundCode": { "enum": [ "COMPANY_NOT_FOUND", "NOT_IN_JURISDICTION", "FILING_NOT_AVAILABLE", "FILING_SPEED_NOT_AVAILABLE" ], "title": "FilingNotFoundCode", "type": "string" }, "FilingConflictCode": { "enum": [ "REGISTERED_AGENT_PENDING", "IDEMPOTENCY_CONFLICT" ], "title": "FilingConflictCode", "type": "string" }, "FilingPaymentRequiredCode": { "title": "FilingPaymentRequiredCode", "enum": [ "FILING_PAYMENT_ERROR" ], "type": "string" }, "FilingBadRequestError": { "properties": { "code": { "title": "FilingBadRequestError.code", "description": "`VALIDATION_ERROR`: the request did not match the schema.\n\n`IDEMPOTENCY_KEY_REQUIRED`: send an Idempotency-Key of 1 to 128 letters, digits, hyphens or\nunderscores.\n\n`MISSING_ENTITY_INFORMATION`: the company is missing something the filing needs, such as its\nentity type. Update the company, then retry.\n\n`NO_REGISTERED_AGENT`: the company has no registered agent in this jurisdiction.\n\nSome errors don't include a code yet. Read `message` when `code` is missing.", "example": "VALIDATION_ERROR", "allOf": [ { "$ref": "#/components/schemas/FilingBadRequestCode" } ] }, "message": { "title": "FilingBadRequestError.message", "type": "string", "example": "filingSpeed must be one of: standard, expedited, rush" } }, "required": [ "message" ], "additionalProperties": false, "title": "FilingBadRequestError", "type": "object" }, "FilingNotFoundError": { "properties": { "code": { "title": "FilingNotFoundError.code", "description": "`COMPANY_NOT_FOUND`: no company with that id on your account.\n\n`NOT_IN_JURISDICTION`: the company does not operate in this state.\n\n`FILING_NOT_AVAILABLE`: this filing type is not offered for this company here. The filing\ntypes list has the ones that are.\n\n`FILING_SPEED_NOT_AVAILABLE`: the filing is offered, but not at that speed. The filing speeds\nlist has the ones it is.", "example": "FILING_SPEED_NOT_AVAILABLE", "allOf": [ { "$ref": "#/components/schemas/FilingNotFoundCode" } ] }, "message": { "title": "FilingNotFoundError.message", "type": "string", "example": "This filing is not offered at rush speed here. Available: standard, expedited." } }, "required": [ "message" ], "additionalProperties": false, "title": "FilingNotFoundError", "type": "object" }, "FilingConflictError": { "properties": { "code": { "title": "FilingConflictError.code", "description": "`REGISTERED_AGENT_PENDING`: registered agent service is still being set up for this company.\nRetry once it is active.\n\n`IDEMPOTENCY_CONFLICT`: this Idempotency-Key was already used on this company for a different\nfiling. Retrying the same filing returns the original; use a fresh key to place a different one.", "example": "IDEMPOTENCY_CONFLICT", "allOf": [ { "$ref": "#/components/schemas/FilingConflictCode" } ] }, "message": { "title": "FilingConflictError.message", "type": "string", "example": "A request with this idempotency key already exists." } }, "required": [ "message" ], "additionalProperties": false, "title": "FilingConflictError", "type": "object" }, "FilingPaymentRequiredError": { "properties": { "code": { "title": "FilingPaymentRequiredError.code", "description": "`FILING_PAYMENT_ERROR`: the payment was declined, so nothing was filed. Fix the payment method\nand send the request again with the same Idempotency-Key.", "example": "FILING_PAYMENT_ERROR", "allOf": [ { "$ref": "#/components/schemas/FilingPaymentRequiredCode" } ] }, "message": { "title": "FilingPaymentRequiredError.message", "type": "string", "example": "Your card was declined." } }, "required": [ "message" ], "additionalProperties": false, "title": "FilingPaymentRequiredError", "type": "object" }, "InternalError": { "properties": { "message": { "title": "InternalError.message", "enum": [ "Internal Error" ], "type": "string" } }, "required": [ "message" ], "additionalProperties": false, "title": "InternalError", "type": "object" } } } } ```