Open a Corporate Registration Filing

Open a corporate registration filing

curl --request POST \
  --url https://public.api.live.turrisfi.com/v2/downstream/corporate-registration-filings \
  --header 'Content-Type: application/json' \
  --data '
{
  "stateCode": "PA",
  "filingType": "initial registration",
  "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    stateCode: 'PA',
    filingType: 'initial registration',
    downstreamEntityId: '6610b3d2c2e0a51b8c0d1f02'
  })
};

fetch('https://public.api.live.turrisfi.com/v2/downstream/corporate-registration-filings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://public.api.live.turrisfi.com/v2/downstream/corporate-registration-filings"

payload = {
    "stateCode": "PA",
    "filingType": "initial registration",
    "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "filingId": "6710b3d2c2e0a51b8c0d1f44",
    "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
    "stateCode": "PA",
    "filingType": "initial registration",
    "status": "not started",
    "entityVariant": "C-Corp",
    "checklist": [
      {
        "name": "State filing",
        "tone": "primary",
        "order": 1,
        "items": [
          {
            "label": "File the certificate of authority",
            "required": true,
            "order": 2,
            "isComplete": false,
            "isAwaitingYourUpload": false,
            "referenceFields": [
              {
                "label": "State filing number",
                "value": "7788123",
                "type": "text"
              }
            ],
            "attachments": [
              {
                "fileDocumentId": "66a1b2c3d4e5f6a7b8c9d0e3",
                "fileName": "certificate-of-authority.pdf",
                "uploadedByType": "admin",
                "uploadedAt": "2026-02-10T14:05:00.000Z"
              }
            ],
            "completedAt": "2026-02-12T09:00:00.000Z"
          }
        ]
      }
    ],
    "stateInfo": {
      "filingName": "Foreign Qualification",
      "annualReportType": "fixed",
      "hasFranchiseTax": false,
      "ssnRequirement": "none",
      "areSharesRequired": false,
      "capturedAt": "2026-01-04T00:00:00.000Z",
      "filingFee": 250,
      "annualReportFrequency": "annual",
      "annualReportFee": 75,
      "annualReportFiler": "Registered agent",
      "secretaryOfStateUrl": "https://www.dos.pa.gov",
      "notes": "<string>"
    },
    "acknowledgedAt": "<string>",
    "createdAt": "2026-01-04T00:00:00.000Z",
    "updatedAt": "2026-02-12T09:00:00.000Z"
  },
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

POST

downstream

corporate-registration-filings

Open a corporate registration filing

curl --request POST \
  --url https://public.api.live.turrisfi.com/v2/downstream/corporate-registration-filings \
  --header 'Content-Type: application/json' \
  --data '
{
  "stateCode": "PA",
  "filingType": "initial registration",
  "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    stateCode: 'PA',
    filingType: 'initial registration',
    downstreamEntityId: '6610b3d2c2e0a51b8c0d1f02'
  })
};

fetch('https://public.api.live.turrisfi.com/v2/downstream/corporate-registration-filings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://public.api.live.turrisfi.com/v2/downstream/corporate-registration-filings"

payload = {
    "stateCode": "PA",
    "filingType": "initial registration",
    "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "filingId": "6710b3d2c2e0a51b8c0d1f44",
    "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
    "stateCode": "PA",
    "filingType": "initial registration",
    "status": "not started",
    "entityVariant": "C-Corp",
    "checklist": [
      {
        "name": "State filing",
        "tone": "primary",
        "order": 1,
        "items": [
          {
            "label": "File the certificate of authority",
            "required": true,
            "order": 2,
            "isComplete": false,
            "isAwaitingYourUpload": false,
            "referenceFields": [
              {
                "label": "State filing number",
                "value": "7788123",
                "type": "text"
              }
            ],
            "attachments": [
              {
                "fileDocumentId": "66a1b2c3d4e5f6a7b8c9d0e3",
                "fileName": "certificate-of-authority.pdf",
                "uploadedByType": "admin",
                "uploadedAt": "2026-02-10T14:05:00.000Z"
              }
            ],
            "completedAt": "2026-02-12T09:00:00.000Z"
          }
        ]
      }
    ],
    "stateInfo": {
      "filingName": "Foreign Qualification",
      "annualReportType": "fixed",
      "hasFranchiseTax": false,
      "ssnRequirement": "none",
      "areSharesRequired": false,
      "capturedAt": "2026-01-04T00:00:00.000Z",
      "filingFee": 250,
      "annualReportFrequency": "annual",
      "annualReportFee": 75,
      "annualReportFiler": "Registered agent",
      "secretaryOfStateUrl": "https://www.dos.pa.gov",
      "notes": "<string>"
    },
    "acknowledgedAt": "<string>",
    "createdAt": "2026-01-04T00:00:00.000Z",
    "updatedAt": "2026-02-12T09:00:00.000Z"
  },
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

Opens a filing in one state for one of your entities and returns it with the checklist Turris will work through.

What is decided for you

Status is always not started

A filing is a workflow Turris runs. The statuses past the first are our operational vocabulary, not yours to declare, so the field is not accepted.

The entity variant follows the entity

Which half of the state template the checklist comes from is decided by the entity’s recorded type — LLC, S-Corp and so on — not by the request. An entity with no type recorded returns 400: writing a guess would silently snapshot the wrong checklist.

The checklist is snapshotted, not referenced

Frozen at this moment. Later template changes never reshape a filing that is already open.

One open filing per state and type

A second filing for the same entity, state and filing type is refused with 409 while the first is still open. Completed and cancelled filings do not block a new one, so this year’s annual report after last year’s is fine, and so is a fresh registration after an earlier attempt was cancelled. This is stricter than the agency application on purpose: through an API, a retry loop creates real work in a Turris operator’s queue.

States without a template

Turris maintains a filing template per state. A state we have not templated yet returns 404 naming the state — a real answer about the platform rather than a malformed request. Send an Idempotency-Key header. See Idempotency.

Headers

idempotency-key

string

UUID to ensure idempotent request processing

Example:

"550e8400-e29b-41d4-a716-446655440000"

x-idempotency-key

string

Alternative UUID header for idempotent request processing

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

stateCode

enum<string>

required

The state or territory to register in. Turris must have a filing template for it.

Available options:

AL,

AK,

AZ,

AR,

CA,

CO,

CT,

DE,

FL,

GA,

HI,

ID,

IL,

IN,

IA,

KS,

KY,

LA,

ME,

MD,

MA,

MI,

MN,

MS,

MO,

MT,

NE,

NV,

NH,

NJ,

NM,

NY,

NC,

ND,

OH,

OK,

OR,

PA,

RI,

SC,

SD,

TN,

TX,

UT,

VT,

VA,

WA,

WV,

WI,

WY,

GU,

PR,

VI,

DC

Example:

"PA"

filingType

enum<string>

required

What kind of filing this is. The state template carries a different checklist per type, so this decides the work the filing is opened with.

Available options:

initial registration,

annual report,

withdrawal,

amendment,

other

Example:

"initial registration"

downstreamEntityId

string

Which of your entities the filing is for. Defaults to your own organization. Registration is per legal entity, so a group filing for a branch must name that branch.

Example:

"6610b3d2c2e0a51b8c0d1f02"

Response

The filing opened

data

object

required

Show child attributes

requestId

string

required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

timestamp

string

required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"

Start Here

Shared Endpoints

Licensed Entities

Producers

Contacts

Licenses

Actions Required

Licensing Overview

Appointments

License Requests

Compliance Configurations

Markets

Corporate Registrations

Documents

Surplus Lines

Open a Corporate Registration Filing

What is decided for you

One open filing per state and type

States without a template

Headers

Body

Response

​What is decided for you

​One open filing per state and type

​States without a template

Headers

Body

Response

What is decided for you

One open filing per state and type

States without a template