--- title: US Article of Incorporation Extraction slug: us-apis/us-article-of-incorporation-extraction description: In this document, discover valuable insights and analysis on a wide range of topics. From industry trends and market research to strategic planning and optimization strategies, this comprehensive resource empowers you to make informed decisions and drive docTags: createdAt: 2023-06-02T09:43:14.000Z --- # Overview The US Article of Incorporation Extraction API is designed to extract key information from Articles of Incorporation documents for US-based corporations. This API enables automated retrieval of essential corporate data such as company name, business purpose, and registration details directly from the incorporation documents provided via a URL to the document. # Use Case - **Legal and Compliance**: Assists legal teams and compliance officers in quickly extracting structured information from incorporation documents for due diligence and regulatory compliance. - **Business Registration Services**: Used by business service providers to automate the setup and registration processes for new businesses by extracting necessary legal documents. - **Data Management**: Helps corporate data management teams to populate and maintain accurate business entity records in corporate databases. # API Details ## Request Body :::CodeblockTabs PreProduction ```curl curl --location 'https://api-preproduction.signzy.us/api/v3/us-api/aoi-extraction' \ --header 'Authorization: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "fileUrl": "https://persist.signzy.tech/api/files/1174103597/download/95f550e429444efa9fd2e0483acbc2863a130ec7cea042f88e002373cef43ea2.pdf" }' ``` Production ```curl curl --location 'https://api.signzy.us/api/v3/us-api/aoi-extraction' \ --header 'Authorization: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "fileUrl": "https://persist.signzy.tech/api/files/1174103597/download/95f550e429444efa9fd2e0483acbc2863a130ec7cea042f88e002373cef43ea2.pdf" }' ``` ::: ## Request Body Parameters | **Parameter** | **Type** | **Description** | **Required** | | ------------- | -------- | -------------------------------------------------------- | ------------ | | fileUrl | string | Link to the article of incorporation file for extraction | Yes | ## Response Body :::CodeblockTabs 200 ```curl { "result": { "legalCompanyName": "", "businessPurpose": "", "registrationNumber": "", "registeredAddress": "", "registeredState": "", "registeredAgent": "", "dateOfIncorporation": "" } } ``` ::: **Data Schema** | Field | Data Type | Description | Required | | ------------------------- | ------------------------ | ------------------------------------------------------------------------------------------ | ---------- | | legalCompanyName | String | The official registered legal name of the company. | Yes | | businessPurpose | String | The primary stated business purpose as per the company’s AOI | Yes | | registrationNumber | String | Unique registration/incorporation number. | Yes | | registeredAddress | String | The official registered business address in AOI | Yes | | registeredState | String | The state where the business is incorporated. | Yes | | registeredAgent | String | The registered agent in Article of Incorporation | Yes | | dateOfIncorporation | String
(YYYY-MM-DD) | The official incorporation date of the company. | Yes | ## Error Code and Response Mapping :::CodeblockTabs 400 (Bad Request) ```json { "error": { "name": "error", "message": "Bad Input and description ", "status": 400, "reason": "VALIDATION_ERROR", "type": "Bad Request", "statusCode": 400 } } ``` 401(Unauthorized) ```json { "error": { "name": "error", "message": "Invalid authentication credentials", "status": 401, "reason": "AUTHENTICATION_ERROR", "type": "Bad Request", "statusCode": 401 } } ``` 403 (Forbidden) ```json { "error": { "name": "error", "message": "Forbidden", "reason": "ERROR", "type": "Bad Request", "statusCode": "403" } } ``` 500 (Internal Server Error) ```json { "error": { "name": "error", "message": "Internal server error", "status": 500, "reason": "ERROR", "type": "Bad Request", "statusCode": 500 } } ``` 409(Upstream Down ```json { "error": { "name": "error", "message": "Upstream Down", "status": 409, "reason": "ERROR", "type": "Bad Request", "statusCode": 409 } } ``` ::: | **Field** | **Type** | **Description** | | ------------ | -------- | --------------------------------------------------- | | `name` | string | Text displayed on the screen explaining error type. | | `reason` | string | Reason for the error. | | `status` | number | HTTP status code. | | `message` | string | Error message indicating an upstream error. | | `type` | string | Error type. | | `statusCode` | number | Status code representing the error scenario. | :::hint{type="info"} ### Getting help Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better. You can reach out to us at [help@signzy.com](#). We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively. We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you! :::