Skip to main content
POST
Create a filing

Authorizations

Authorization
string
header
required

Effective API key. Send Authorization: Bearer sk-eai-...

Body

application/json
scope
string
required

Authorization scope UUID or stable slug prefixed with mc:.

Pattern: ^mc:[A-Za-z0-9][A-Za-z0-9-]{0,127}$
companyId
string<uuid>
required

Company ID from GET or POST /api/v2/insurance/managed-filings/companies in this scope.

jurisdictionId
string<uuid>
required

Jurisdiction ID from GET or POST /api/v2/insurance/managed-filings/jurisdictions in this scope.

primaryProductId
string<uuid>
required

Product ID from GET or POST /api/v2/insurance/managed-filings/products in this scope.

filingType
enum<string>
required

Material or action being filed: form, rate, rule, their named combinations, adoption of existing material, or withdrawal of material.

Available options:
form,
rate,
rule,
rate_rule,
form_rate,
form_rule,
form_rate_rule,
adoption,
withdrawal
additionalProductIds
string<uuid>[]

Optional distinct product IDs from /api/v2/insurance/managed-filings/products; exclude primaryProductId.

Maximum array length: 100
predecessorFilingId
string<uuid> | null

Optional readable filing ID from GET /api/v2/insurance/managed-filings in the same scope; not a research-catalog filing ID.

description
string | null

Free-text summary of the filing being prepared.

Required string length: 1 - 20000
reviewType
enum<string> | null

Regulatory review procedure, not automated pre-review: prior_approval requires approval before use; file_and_use files before use; use_and_file files after use; informational supplies information. This field does not determine jurisdiction-specific deadlines or requirements.

Available options:
prior_approval,
file_and_use,
use_and_file,
informational,
null
toiCode
enum<string> | null

NAIC TOI code. When changing or clearing it, also change or clear any incompatible subToiCode.

Available options:
01.0,
02.1,
02.3,
03.0,
04.0,
05.0,
05.1,
05.2,
06.0,
08.0,
09.0,
10.0,
11.0,
11.1,
11.2,
12.0,
16.0,
17.0,
17.1,
17.2,
18.0,
19.0,
20.0,
21.4,
22.0,
23.0,
24.0,
26.0,
27.0,
28.1,
28.2,
28.3,
30.0,
30.1,
33.0,
34.0,
35.0,
null
subToiCode
enum<string> | null

Requires toiCode and must belong to that TOI. PATCH validates against the resulting filing, including unchanged fields. Discover valid pairs through GET /api/v2/insurance/insurance-types and GET /api/v2/insurance/insurance-types/{toiCode}/subtypes.

Available options:
01.0001,
01.0002,
02.1000,
02.1001,
02.1002,
02.3001,
02.3002,
02.3003,
02.3004,
03.0000,
04.0000,
04.0001,
04.0002,
04.0003,
04.0004,
04.0005,
05.0000,
05.0001,
05.0002,
05.0003,
05.0004,
05.0005,
05.0006,
05.0007,
05.1000,
05.1001,
05.1002,
05.1003,
05.1004,
05.1005,
05.1006,
05.1007,
05.2000,
05.2001,
05.2002,
05.2003,
05.2004,
05.2005,
05.2006,
05.2007,
06.0000,
06.0001,
06.0002,
06.0003,
06.0004,
08.0000,
09.0000,
09.0001,
09.0002,
09.0003,
09.0004,
09.0005,
09.0006,
09.0007,
09.0008,
09.0009,
09.0010,
10.0000,
11.0000,
11.0001,
11.0002,
11.0003,
11.0004,
11.0005,
11.0006,
11.0007,
11.0008,
11.0009,
11.0010,
11.0011,
11.0012,
11.0013,
11.0014,
11.0015,
11.0016,
11.0017,
11.0018,
11.0019,
11.0020,
11.0021,
11.0022,
11.0023,
11.0024,
11.0025,
11.0026,
11.0027,
11.0028,
11.0029,
11.0030,
11.0031,
11.0032,
11.0033,
11.1000,
11.1001,
11.1002,
11.1003,
11.1004,
11.1005,
11.1006,
11.1007,
11.1008,
11.1009,
11.1010,
11.1011,
11.1012,
11.1013,
11.1014,
11.1015,
11.1016,
11.1017,
11.1018,
11.1019,
11.1020,
11.1021,
11.1022,
11.1023,
11.1024,
11.1025,
11.1026,
11.1027,
11.1028,
11.1029,
11.1030,
11.1031,
11.1032,
11.1033,
11.2000,
11.2001,
11.2002,
11.2003,
11.2004,
11.2005,
11.2006,
11.2007,
11.2008,
11.2009,
11.2010,
11.2011,
11.2012,
11.2013,
11.2014,
11.2015,
11.2016,
11.2017,
11.2018,
11.2019,
11.2020,
11.2021,
11.2022,
11.2023,
11.2024,
11.2025,
11.2026,
11.2027,
11.2028,
11.2029,
11.2030,
11.2031,
11.2032,
11.2033,
12.0001,
12.0002,
16.0000,
16.0001,
16.0002,
16.0003,
16.0004,
16.0005,
17.0000,
17.0001,
17.0002,
17.0003,
17.0004,
17.0005,
17.0006,
17.0007,
17.0008,
17.0009,
17.0010,
17.0011,
17.0012,
17.0013,
17.0014,
17.0015,
17.0016,
17.0017,
17.0018,
17.0019,
17.0020,
17.0021,
17.0022,
17.0023,
17.0024,
17.0025,
17.0026,
17.0027,
17.0028,
17.0029,
17.1000,
17.1001,
17.1002,
17.1003,
17.1004,
17.1005,
17.1006,
17.1007,
17.1008,
17.1009,
17.1010,
17.1011,
17.1012,
17.1013,
17.1014,
17.1015,
17.1016,
17.1017,
17.1018,
17.1019,
17.1020,
17.1021,
17.1022,
17.1023,
17.1024,
17.1025,
17.1026,
17.1027,
17.1028,
17.1029,
17.2000,
17.2001,
17.2002,
17.2003,
17.2004,
17.2005,
17.2006,
17.2007,
17.2008,
17.2009,
17.2010,
17.2011,
17.2012,
17.2013,
17.2014,
17.2015,
17.2016,
17.2017,
17.2018,
17.2019,
17.2020,
17.2021,
17.2022,
17.2023,
17.2024,
17.2025,
17.2026,
17.2027,
17.2028,
17.2029,
18.0000,
18.0001,
18.0002,
19.0000,
19.0001,
19.0002,
19.0003,
19.0004,
20.0000,
20.0001,
20.0002,
20.0003,
20.0004,
21.0004,
22.0000,
23.0000,
24.0000,
26.0001,
26.0002,
27.0000,
28.1000,
28.2001,
28.2002,
28.2003,
28.2004,
28.2005,
28.2006,
28.3000,
30.0000,
30.1000,
33.0001,
33.0002,
33.0003,
33.0004,
33.0005,
33.0006,
34.0000,
35.0000,
35.0001,
35.0002,
null
serffTrackingNumber
string | null

Tracking number assigned by SERFF; null if not recorded.

Required string length: 1 - 256
stateTrackingNumber
string | null

Tracking number assigned by the reviewing jurisdiction; null if not recorded.

Required string length: 1 - 256
companyTrackingNumber
string | null

Your company’s internal tracking number; null if not recorded.

Required string length: 1 - 256
disposition
enum<string> | null

Recorded regulatory status: pending awaits a result; approved records approval; filed records acceptance for filing; acknowledged records receipt; deemed_approved records approval under an applicable deemed-approval provision; disapproved records rejection; withdrawn records withdrawal; closed records closure. Setting this field does not contact SERFF or establish regulatory approval.

Available options:
pending,
approved,
filed,
acknowledged,
deemed_approved,
disapproved,
withdrawn,
closed,
null
dispositionDate
string<date> | null

Date of the recorded regulatory disposition, in YYYY-MM-DD format.

effectiveFromNew
string<date> | null

Effective date for new business, in YYYY-MM-DD format. Recording a date does not authorize use.

effectiveFromRenewal
string<date> | null

Effective date for renewal business, in YYYY-MM-DD format. May differ from the new-business date.

Response

Created filing. Location identifies its detail URL.

id
string<uuid>
required

Managed filing ID; not a reference-catalog filing ID.

scope
string
required

Canonical authorization scope: mc:.

Pattern: ^mc:[0-9a-f-]{36}$
displayName
string
required

Display label: the first available SERFF, state, or company tracking number, otherwise the filing ID.

filingMode
enum<string> | null
required

managed is a working filing; reference is a read-only imported filing. Null is unclassified legacy data and is also read-only.

Available options:
reference,
managed,
null
companyId
string<uuid>
required

Company ID from GET or POST /api/v2/insurance/managed-filings/companies in this scope.

jurisdictionId
string<uuid>
required

Jurisdiction ID from GET or POST /api/v2/insurance/managed-filings/jurisdictions in this scope.

primaryProductId
string<uuid>
required

Product ID from GET or POST /api/v2/insurance/managed-filings/products in this scope.

filingType
string
required

Material or action being filed: form, rate, rule, their named combinations, adoption of existing material, or withdrawal of material.

description
string | null
required

Free-text summary of the filing being prepared.

serffTrackingNumber
string | null
required

Tracking number assigned by SERFF; null if not recorded.

stateTrackingNumber
string | null
required

Tracking number assigned by the reviewing jurisdiction; null if not recorded.

companyTrackingNumber
string | null
required

Your company’s internal tracking number; null if not recorded.

createdAt
string<date-time>
required

Time the filing workspace was created, in UTC.

updatedAt
string<date-time>
required

Time the filing details were last updated, in UTC.

additionalProductIds
string<uuid>[]
required

Optional distinct product IDs from /api/v2/insurance/managed-filings/products; exclude primaryProductId.

predecessorFilingId
string<uuid> | null
required

Optional readable filing ID from GET /api/v2/insurance/managed-filings in the same scope; not a research-catalog filing ID.

reviewType
string | null
required

Regulatory review procedure, not automated pre-review: prior_approval requires approval before use; file_and_use files before use; use_and_file files after use; informational supplies information. This field does not determine jurisdiction-specific deadlines or requirements.

toiCode
string | null
required

NAIC TOI code. When changing or clearing it, also change or clear any incompatible subToiCode.

subToiCode
string | null
required

Requires toiCode and must belong to that TOI. PATCH validates against the resulting filing, including unchanged fields. Discover valid pairs through GET /api/v2/insurance/insurance-types and GET /api/v2/insurance/insurance-types/{toiCode}/subtypes.

disposition
string | null
required

Recorded regulatory status: pending awaits a result; approved records approval; filed records acceptance for filing; acknowledged records receipt; deemed_approved records approval under an applicable deemed-approval provision; disapproved records rejection; withdrawn records withdrawal; closed records closure. Setting this field does not contact SERFF or establish regulatory approval.

dispositionDate
string<date> | null
required

Date of the recorded regulatory disposition, in YYYY-MM-DD format.

effectiveFromNew
string<date> | null
required

Effective date for new business, in YYYY-MM-DD format. Recording a date does not authorize use.

effectiveFromRenewal
string<date> | null
required

Effective date for renewal business, in YYYY-MM-DD format. May differ from the new-business date.

permissions
object
required

Advisory current permissions, not endpoint availability or authorization for a later request. Staging and submission-recording permissions are not included.