> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Minnesota
> Country-specific identifiers, data sources, and integration details
## Start here
This guide contains public integration notes for Minnesota. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Legal Forms](#legal-forms)
* [Officer Roles](#officer-roles)
* [Data Availability](#data-availability)
**API access:** `US-MN` is not yet part of the public `countryCode` enum. Contact us to enable it on your workspace. Requests sent with `countryCode: "US-MN"` will otherwise return `400` until the enum is expanded.
## Data Sources
Minnesota uses a single integration against the **Minnesota Secretary of State, Minnesota Business & Lien System (MBLS)**. The register covers business corporations, nonprofit corporations, limited liability companies, limited partnerships, limited liability partnerships, cooperatives, and other entity types filed with the Secretary of State. Trademark and service mark registrations and assumed names are also present in the system.
* **MBLS public portal** (live, authoritative). Company name, file number, business type, filing status, filing date, renewal due date, registered office address, principal executive office address, registered agent, and filed managers/officers are read live from the public MBLS search and detail pages at `mblsportal.sos.mn.gov`.
**Trade Register Extract included.** Each company lookup includes a free printable extract of the MBLS business record detail page: the MBLS Business Record Details. This PDF is included at no extra charge alongside the company data.
**Certified copies and Certificates of Good Standing** are available from the Secretary of State but require an MBLS account and a paid order. These are not yet offered through Topograph. See the [pricing page](https://topograph.co/pricing/us-mn) for document availability.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| ------------------------- | -------------------------------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------- |
| **Minnesota File Number** | Up to 12 alphanumeric characters; may contain a single internal dash | `631180100027`, `1K-1056`, `886-NPA` | Assigned by the Minnesota Secretary of State (MBLS). Numeric-only and alphanumeric forms are both valid. |
Minnesota file numbers are alphanumeric and may contain a single internal dash (for example `1K-1056` or `886-NPA`). Letters are significant and the number is case-insensitive. Pass it in any case and the API normalizes to uppercase. Do not strip the dash.
**File number collisions.** The same numeric file number can be assigned to entities of different types. For example, a trademark registration and a business entity may both carry file number `4912`. When a file-number search returns multiple candidates that cannot be distinguished, the API returns `resource_not_found`. Use name search to locate the entity and pass the exact ID returned by search.
### Identifiers in API Response
| Identifier | Response field | Format | Found In |
| --------------------- | -------------------------------- | ----------------------------------------------- | ------------------------------------------------------- |
| Minnesota File Number | `company.identifiers.fileNumber` | Up to 12 alphanumeric characters, optional dash | All entities |
| MBLS Filing GUID | `company.identifiers.filingGuid` | UUID v4 string | Returned when available; not accepted as a search input |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Notes |
| -------------- | -------------------------------- | ----------------- | ------------------------------------ | --------------------------------------------------- |
| By Name | 2–250 characters | `"General Mills"` | Begins-with (case-insensitive) | Results capped; use a more specific query to narrow |
| By File Number | Up to 12 alphanumeric characters | `1K-1056` | Exact (normalized, case-insensitive) | Returns `matchType: id` when resolved |
**Name search.** The MBLS portal anchors name search on the beginning of the legal name. Results include both active and inactive entities by default.
**Ambiguous file numbers.** If a file number resolves to multiple entities of different types, the lookup returns `resource_not_found`. Use name search to find the correct entity, then pass its ID to `/v2/company`.
## Quirks & Gotchas
| Quirk | Details |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Alphanumeric file numbers with dashes** | File numbers are not always numeric. Forms like `1K-1056` and `886-NPA` are valid. The dash is load-bearing. Do not strip it. The API normalizes to uppercase. |
| **File number collisions across entity types** | The same short numeric file number can exist for multiple entity types (for example a trademark and a business entity). When ambiguous, the API returns `resource_not_found` rather than returning the wrong entity. |
| **No shareholder or UBO data** | Minnesota does not publish shareholder lists or beneficial ownership information through the Secretary of State business register. |
| **No activity codes** | The Secretary of State does not collect NAICS, NACE, or ISIC codes. Business type (domestic/foreign, entity form) is available, but industry classification is not. |
| **Assumed names live in the same system** | DBA/assumed name registrations are indexed in MBLS alongside formal entity filings. They may appear in name search results. |
| **Trademarks and service marks are also present** | Trademark and service mark registrations appear in the register and may show short numeric file numbers that collide with business entity file numbers. |
| **Registered agent may be absent** | Not all entities have a registered agent on file. The field is omitted when not present. |
| **Renewal due date is present but not status** | The detail page exposes a renewal due date and a status field. Entities whose renewal is overdue may show an inactive or dissolved status; always treat the live portal status as authoritative. |
| **Certified copies and certificates are paid** | Certificate of Good Standing / Certificate of Existence and certified copies require a paid MBLS account order and are not yet available through Topograph. |
## Mappings
### Legal Forms
Legal form is sourced from the `Business Type` field on the MBLS detail page. The MBLS uses a fixed vocabulary of entity types drawn from Minnesota business statutes. The list below covers the most common forms seen in production. The full list, with standardized and ISO 20275 mappings where available, is on the [pricing page](https://topograph.co/pricing/us-mn).
| MBLS Business Type | Standardized |
| -------------------------------------- | ----------------------- |
| Domestic Business Corporation | Corporation |
| Foreign Business Corporation | Corporation |
| Domestic Non-Profit Corporation | NonprofitOrganization |
| Foreign Non-Profit Corporation | NonprofitOrganization |
| Domestic Limited Liability Company | LimitedLiabilityCompany |
| Foreign Limited Liability Company | LimitedLiabilityCompany |
| Domestic Limited Partnership | Partnership |
| Foreign Limited Partnership | Partnership |
| Domestic Limited Liability Partnership | Partnership |
| Foreign Limited Liability Partnership | Partnership |
| Domestic Cooperative | Cooperative |
| Foreign Cooperative | Cooperative |
| Trademark / Service Mark | Other |
| Assumed Name | Other |
Legal form is returned as `legalForm.localName` (the raw MBLS label). Standardized mapping is applied where available. For the complete enum including ISO 20275 codes, see the [pricing page](https://topograph.co/pricing/us-mn).
### Officer Roles
Officer and manager titles are sourced from the MBLS detail page. The register records a set of known party types (Manager, President, Chief Executive Officer, Registered Agent, Organizer, Incorporator, and others). Raw role titles are normalized to a standardized Topograph role label and English translation.
| Common MBLS Role | Standardized | Notes |
| ----------------------- | --------------------- | ------------------------------------------------------- |
| Manager | Manager | LLCs: member-managed or manager-managed |
| President | President | Business corporations |
| Chief Executive Officer | ChiefExecutiveOfficer | |
| Registered Agent | RegisteredAgent | Receives service of process; not a legal representative |
| Organizer | Incorporator | At formation |
| Incorporator | Incorporator | |
| Applicant | Applicant | Trademark / assumed name filings |
| Markholder | Other | Trademark holder |
Registered Agent is classified as an Other Key Person and is not included in `legalRepresentatives`. It is returned separately.
## Data Availability
| Data Point | Available | Notes |
| ---------------------------- | --------- | ------------------------------------------------------------------------------- |
| Company name | Yes | Current legal name from the MBLS portal |
| Company status | Yes | Live status from the MBLS detail page (Active, Inactive, Dissolved, etc.) |
| Registration date | Yes | Filing date from the MBLS detail page |
| Renewal due date | Yes | When present on the detail page |
| Legal address | Yes | Registered office address and principal executive office address when available |
| Legal form | Yes | MBLS business type, standardized |
| Legal representatives | Yes | Managers, presidents, CEOs, and other filed officers |
| Registered agent | Yes | Name and address when on file |
| Home jurisdiction | Yes | For foreign entities, the jurisdiction of formation |
| Activity codes | No | Not collected by the Secretary of State |
| Shareholders | No | Not published |
| UBOs | No | No public state-level beneficial ownership register |
| Trade Register Extract | Yes | Free printable MBLS Business Record Details PDF, included with each lookup |
| Certificate of Good Standing | Roadmap | Requires a paid MBLS account order; not yet available through Topograph |
| Certified copies | Roadmap | Requires a paid MBLS account order; not yet available through Topograph |
| Financial data | No | Not collected |
For the full catalog of supported datapoints and documents, see the [pricing page](https://topograph.co/pricing/us-mn).
## Example API Responses
### Search by Name
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-MN&query=Acme+Manufacturing" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "123456789012",
"legalName": "ACME MANUFACTURING LLC",
"countryCode": "US-MN",
"matchReason": {
"matchType": "default"
},
"address": {
"region": "MN",
"countryCode": "US"
}
}
]
```
### Search by File Number
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-MN&query=1K-1056" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "1K-1056",
"legalName": "ACME HOLDINGS, INC.",
"countryCode": "US-MN",
"matchReason": {
"matchType": "id"
}
}
]
```
### Company Profile
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"countryCode": "US-MN", "id": "123456789012", "dataPoints": ["company", "legalRepresentatives"]}'
```
```json theme={null}
{
"company": {
"id": "123456789012",
"countryCode": "US-MN",
"identifiers": {
"fileNumber": "123456789012",
"filingGuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
},
"legalName": "ACME MANUFACTURING LLC",
"status": {
"localName": "Active / In Good Standing",
"standardized": "Active"
},
"registrationDate": "2005-03-15",
"legalForm": {
"localName": "Domestic Limited Liability Company",
"standardized": "LimitedLiabilityCompany"
},
"legalAddress": {
"addressLine1": "123 Main St",
"city": "Minneapolis",
"region": "MN",
"postalCode": "55401",
"countryCode": "US"
}
},
"legalRepresentatives": [
{
"name": "Jane Smith",
"roles": [
{
"localName": "Manager",
"standardized": "Manager"
}
]
}
]
}
```