API Reference

Create a Company

🚧

Limited Availability

Access to the Compliance API is currently limited to approved partners. Endpoints, request/response shapes, and field names may change before reaching general availability — use against staging for early integration work and coordinate with your CorpNet account manager before relying on Compliance API calls in production-critical paths. Report issues or feedback to your account manager.

POST /v1/partners/{partnerId}/companies

Creates a company record linked to your partner account and enrolls it in CorpNet's compliance system. Returns the new companyId and PCID you'll reference in subsequent calls.

Path Parameters

ParameterTypeRequiredDescription
partnerIdStringYesYour Account PID (issued during partner onboarding).

Request Body

{
  "name": "ABC Company Inc",
  "formationDate": "2020-01-15",
  "type": "LLC",
  "ein": "12-3456789",
  "filingnumber": "C1234567",
  "homeState": "CA",
  "businessDescription": "Technology consulting services",
  "buisnessCategory": "Professional Services",
  "website": "https://www.abccompany.com",
  "businessAddress": {
    "street": "123 Main Street",
    "street2": "Suite 100",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "United States",
    "phone": "(415) 555-1234",
    "email": "[email protected]"
  },
  "PCID": "PC123456"
}

Request Body Fields

FieldTypeRequiredDescription
nameStringYesCompany legal name.
formationDateStringNoFormation date in YYYY-MM-DD format.
typeStringNoEntity type (e.g., LLC, Corporation).
einStringNoFederal Tax ID in NN-NNNNNNN format.
filingnumberStringNoState filing number assigned at formation.
homeStateStringNoTwo-letter state code (e.g., CA, DE).
businessDescriptionStringNoFree-text description of the business.
buisnessCategoryStringNoBusiness category (note: API field spelled buisnessCategory).
websiteStringNoCompany website URL.
businessAddressObjectNoBusiness address. See Business Address Object below.
PCIDStringNoPortal Company ID — your application's identifier for the company, surfaced back on retrieval for cross-system reconciliation.

Business Address Object

FieldTypeDescription
streetStringStreet address line 1.
street2StringStreet address line 2 (suite, unit, etc.).
cityStringCity.
stateStringTwo-letter state code.
zipStringZIP or postal code.
countryStringCountry name.
phoneStringPhone number.
emailStringCompliance-notice email address for this company.

Example

curl -s -X POST \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"NewCo LLC","homeState":"TX","type":"LLC"}' \
  "https://api.corpnet.com/v1/partners/P123456/companies"

Response — 200 OK

{
  "data": {
    "companyId": "a0A5e000002abcd",
    "PCID": "PC123456"
  },
  "statusCode": 200,
  "message": "Success"
}
FieldTypeDescription
data.companyIdStringCorpNet-assigned identifier for the new company. Reference this in subsequent calls.
data.PCIDStringEcho of the PCID you supplied (or null if you didn't supply one).

Error Responses

{ "statusCode": 400, "message": "No account found for the provided PID.", "data": null }
{ "statusCode": 400, "message": "FIELD_CUSTOM_VALIDATION_EXCEPTION, Company name is required: [Name]", "data": null }
StatusCauseResolution
400partnerId does not resolve to an Account.Verify the partnerId in the URL matches the one issued by CorpNet.
400Required field missing or malformed (e.g., empty name).Inspect message for the specific field; populate and retry.
401Bearer token missing, malformed, or expired.See Authorization.
403Token does not entitle this partner to write to the Compliance API.Contact your CorpNet account manager.

Notes

  • For onboarding more than one company at a time, use Bulk Create Companies — it's an all-or-nothing transaction up to ~200 companies per request.
  • PCID is your reference identifier — CorpNet does not validate uniqueness server-side, but you should keep it unique on your side to support reconciliation.

Updated 14 days ago

Updated 14 days ago